| 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 |