| 1 | = Trac Installation Guide = |
| 2 | [[TranslatedPages(revision=0)]] |
| 3 | |
| 4 | Trac написан на языке программирования Python и требует базу данных [http://sqlite.org/ SQLite], [http://www.postgresql.org/ PostgreSQL] или [http://mysql.com/ MySQL]. Для генерации HTML, Trac использует систему шаблонов [http://genshi.edgewall.org/ Genshi]. |
| 5 | |
| 6 | [[PageOutline(2-3,Шаги установки,inline)]] |
| 7 | |
| 8 | == Зависимости == |
| 9 | |
| 10 | === Обязательное зависимости === |
| 11 | |
| 12 | Чтобы установить Trac, необходимо чтобы были установлены следующие пакеты: |
| 13 | * [http://www.python.org/ Python] версии >= 2.4 и < 3.0 (обратите внимание, мы не поддерживаем Python 2.3 с этого выпуска [0.12]) |
| 14 | * [http://peak.telecommunity.com/DevCenter/setuptools setuptools] версии >= 0.6 |
| 15 | * [http://genshi.edgewall.org/ Genshi] версии >= 0.6 |
| 16 | Вам также необходима база данных и соответствующие библиотеки для Python (python bindings). Поддерживаются базы данных SQLite, PostgreSQL и MySQL. |
| 17 | |
| 18 | ===== Для базы SQLite ===== |
| 19 | |
| 20 | Если вы используете Python 2.5 или 2.6, у вас уже есть всё что нужно. |
| 21 | |
| 22 | При использовании Python 2.4 необходим pysqlite. Можно загрузить с [http://code.google.com/p/pysqlite/downloads/list google code] установщик для Windows или tar.gz архив для сборки из исходников: |
| 23 | |
| 24 | {{{ |
| 25 | $ tar xvfz <version>.tar.gz |
| 26 | $ cd <version> |
| 27 | $ python setup.py build_static install |
| 28 | }}} |
| 29 | |
| 30 | Эти команды распакуют код SQLite и соберут библиотеку. |
| 31 | |
| 32 | SQLite 2.x больше не поддерживается. |
| 33 | |
| 34 | Известная ошибка PySqlite версий 2.5.2-4 не позволит обновить базу данных Trac с версии 0.11.x до 0.12. Используйте версии 2.5.5 и новее или 2.5.1 и старше. Подробности в #9434. |
| 35 | |
| 36 | Дополнительная информация в [trac:PySqlite]. |
| 37 | |
| 38 | ===== Для базы PostgreSQL ===== |
| 39 | |
| 40 | Необходимо установить СУБД и библиотеку Python: |
| 41 | |
| 42 | * [http://www.postgresql.org/ PostgreSQL] |
| 43 | * [http://pypi.python.org/pypi/psycopg2 psycopg2] |
| 44 | |
| 45 | Подробности в [trac:DatabaseBackend#Postgresql DatabaseBackend]. |
| 46 | |
| 47 | ===== Для базы MySQL ===== |
| 48 | |
| 49 | Trac теперь может работать с MySQL, если вы будете следовать инструкциям. |
| 50 | * [http://mysql.com/ MySQL] версии 5.0 или новее |
| 51 | * [http://sf.net/projects/mysql-python MySQLdb] версии 1.2.2 или новее |
| 52 | |
| 53 | '''Очень''' важно внимательно прочитать страницу [trac:MySQLdb] перед созданием базы данных. |
| 54 | |
| 55 | === Опциональные зависимости === |
| 56 | |
| 57 | ==== Система контроля версий ==== |
| 58 | |
| 59 | ===== Subversion ===== |
| 60 | |
| 61 | * [http://subversion.apache.org/ Subversion], 1.5.x или 1.6.x и '''''соответствующие''''' библиотеки Python. Старые версии начиная с 1.0, такие как 1.2.4, 1.3.2 или 1.4.2, и т.п. тоже должны работать. Сведения об устранении неполадок приведены на странице [trac:TracSubversion#Troubleshooting TracSubversion]. |
| 62 | |
| 63 | [http://subversion.apache.org/packages.html Скомпилированные SWIG библиотеки] доступны для различных платформ. (Удачи в поисках скомпилированных SWIG библиотек для любого Windows пакета. TracSubversion содержит ссылку на [http://alagazam.net Algazam], где есть библиотеки, работающие с Python 2.6.) |
| 64 | |
| 65 | Заметьте, что Trac '''не''' использует [http://pysvn.tigris.org/ PySVN], он ещё не работает с новыми `ctype`-style bindings. [Есть карточка о реализации ctype bindings?] |
| 66 | |
| 67 | |
| 68 | |
| 69 | == Создание окружения проекта == |
| 70 | |
| 71 | [TracEnvironment Окружение Trac] - это внутреннее хранилище, в котором Trac хранит информацию такую как вики страницы, карточки, отчёты, настройки и т.д. Окружение - это по существу директория, в которой содержится [TracIni конфигурационный файл], а также другие файлы и директории. |
| 72 | |
| 73 | Новое окружение создаётся с помощью [wiki:TranslationRu/TracAdmin trac-admin]: |
| 74 | {{{ |
| 75 | $ trac-admin /path/to/myproject initenv |
| 76 | }}} |