| | 1 | = Trac 환경변수 = |
|---|
| | 2 | |
|---|
| | 3 | Trac uses a directory structure and a database for storing project data. The directory is referred to as the Environment. |
|---|
| | 4 | |
|---|
| | 5 | == Trac 저장소 만들기 == |
|---|
| | 6 | |
|---|
| | 7 | 새로운 Trac 저장소는 [wiki:TracAdmin trac-admin] 명령어를 사용해서 만들어집니다.: |
|---|
| | 8 | {{{ |
|---|
| | 9 | $ trac-admin /path/to/projectenv initenv |
|---|
| | 10 | }}} |
|---|
| | 11 | |
|---|
| | 12 | [wiki:TracAdmin trac-admin] will ask you for the name of the project, the |
|---|
| | 13 | database connection string (explained below), and the type and path to |
|---|
| | 14 | your source code repository. |
|---|
| | 15 | |
|---|
| | 16 | ''Note: The web server user will require file system write permission to |
|---|
| | 17 | the environment directory and all the files inside. Please remember to set |
|---|
| | 18 | the appropriate permissions. The same applies to the Subversion repository |
|---|
| | 19 | Trac is eventually using, although Trac will only require read access as long |
|---|
| | 20 | as you're not using the BDB file system.'' |
|---|
| | 21 | |
|---|
| | 22 | == 데이타베이스 연결 스트링 == |
|---|
| | 23 | |
|---|
| | 24 | Since version 0.9, Trac supports both [http://sqlite.org/ SQLite], |
|---|
| | 25 | [http://www.postgresql.org/ PostgreSQL] and [http://mysql.com/ MySQL] as |
|---|
| | 26 | database backends. The default is to use SQLite, which is probably sufficient |
|---|
| | 27 | for most projects. The database file is then stored in the environment |
|---|
| | 28 | directory, and can easily be [wiki:TracBackup backed up] together with the |
|---|
| | 29 | rest of the environment. |
|---|
| | 30 | |
|---|
| | 31 | 임베디드 SQLite 데이타베이스에 대한 연결 스트링은: |
|---|
| | 32 | {{{ |
|---|
| | 33 | sqlite:db/trac.db |
|---|
| | 34 | }}} |
|---|
| | 35 | |
|---|
| | 36 | If you want to use PostgreSQL or MySQL instead, you'll have to use a |
|---|
| | 37 | different connection string. For example, to connect to a PostgreSQL |
|---|
| | 38 | database on the same machine called `trac`, that allows access to the |
|---|
| | 39 | user `johndoe` with the password `letmein`, use: |
|---|
| | 40 | {{{ |
|---|
| | 41 | postgres://johndoe:letmein@localhost/trac |
|---|
| | 42 | }}} |
|---|
| | 43 | |
|---|
| | 44 | 만약 PostgreSQL이 표준 포트(예를 들면 9342)가 아닌 포트에서 동작하고 있다면: |
|---|
| | 45 | {{{ |
|---|
| | 46 | postgres://johndoe:letmein@localhost:9342/trac |
|---|
| | 47 | }}} |
|---|
| | 48 | |
|---|
| | 49 | `trac-admin initenv` 명령을 수행하기 전에 PostgreSQL를 사용해서 데이타베이스를 생성해야만 합니다. |
|---|
| | 50 | |
|---|
| | 51 | And make sure PostgreSQl DB name is "trac". What worked for me: |
|---|
| | 52 | And didn't work uppercase trac-user-name |
|---|
| | 53 | {{{ |
|---|
| | 54 | sudo su - postgres -c createdb trac |
|---|
| | 55 | sudo su - postgres -c psql trac |
|---|
| | 56 | CREATE USER trac-user-name WITH PASSWORD 'trac-pass-name'; |
|---|
| | 57 | }}} |
|---|
| | 58 | |
|---|
| | 59 | (Just to remind you, if you don't have a sudo/su setup, you just need to do the createdb and psql statements. That threw me the first couple of times I read this.) |
|---|
| | 60 | |
|---|
| | 61 | == Source Code Repository == |
|---|
| | 62 | |
|---|
| | 63 | You'll first have to provide the ''type'' of your repository (e.g. `svn` for Subversion, |
|---|
| | 64 | which is the default), then the ''path'' where the repository is located. |
|---|
| | 65 | |
|---|
| | 66 | If you don't want to use Trac with a source code repository, simply leave the ''path'' empty |
|---|
| | 67 | (the ''type'' information doesn't matter, then). |
|---|
| | 68 | |
|---|
| | 69 | For some systems, it is possible to specify not only the path to the repository, |
|---|
| | 70 | but also a ''scope'' within the repository. Trac will then only show information |
|---|
| | 71 | related to the files and changesets below that scope. The Subversion backend for |
|---|
| | 72 | Trac supports this; for other types, check the corresponding plugin's documentation. |
|---|
| | 73 | |
|---|
| | 74 | Example of a configuration for a Subversion repository: |
|---|
| | 75 | {{{ |
|---|
| | 76 | [trac] |
|---|
| | 77 | repository_type = svn |
|---|
| | 78 | repository_dir = /path/to/your/repository |
|---|
| | 79 | }}} |
|---|
| | 80 | |
|---|
| | 81 | The configuration for a scoped Subversion repository would be: |
|---|
| | 82 | {{{ |
|---|
| | 83 | [trac] |
|---|
| | 84 | repository_type = svn |
|---|
| | 85 | repository_dir = /path/to/your/repository/scope/within/repos |
|---|
| | 86 | }}} |
|---|
| | 87 | |
|---|
| | 88 | == 디렉토리 구조 == |
|---|
| | 89 | |
|---|
| | 90 | Trac 저장소 디렉토리는 일반적으로 다음의 파일과 디렉토리들로 구성되어 있습니다.: |
|---|
| | 91 | |
|---|
| | 92 | * `README` - 저장소에 대한 상세한 설명. |
|---|
| | 93 | * `VERSION` - 저장소의 버전 ID가 들어있는 파일. |
|---|
| | 94 | * `attachments` - 위키와 티켓의 첨부파일이 여기에 저장됩니다. |
|---|
| | 95 | * `conf` |
|---|
| | 96 | * `trac.ini` - 메인 환경설정 파일. [wiki:TracIni] 페이지를 참고하십시오. |
|---|
| | 97 | * `db` |
|---|
| | 98 | * `trac.db` - SQLite 데이타베이스 (SQLite를 사용하고 있다면). |
|---|
| | 99 | * `plugins` - 해당 Trac 저장소에 해당하는 [wiki:TracPlugins plugin]들 (Python eggs) |
|---|
| | 100 | * `templates` - 해당 저장소에 해당하는 템플릿트. |
|---|
| | 101 | * `site_css.cs` - 해당 저장소에 해당하는 CSS 규칙들. |
|---|
| | 102 | * `site_footer.cs` - 해당 저장소에 해당하는 page footer. |
|---|
| | 103 | * `site_header.cs` - 해당 저장소에 해당하는 page header. |
|---|
| | 104 | * `wiki-macros` - 해당 저장소에 해당하는 [wiki:WikiMacros 위키 매크로들]. |
|---|
| | 105 | |
|---|
| | 106 | '''Note: don't confuse a Trac environment directory with the source code repository directory. |
|---|
| | 107 | It happens that the above structure is loosely modelled after the Subversion repository directory |
|---|
| | 108 | structure, but they are not and ''must not'' be located at the same place.''' |
|---|
| | 109 | |
|---|
| | 110 | ---- |
|---|
| | 111 | 참고 : TracAdmin, TracBackup, TracIni, TracGuide |