= Podręcznik instalacji Traca = 
[[TracGuideToc]]

Trac jest lekkim narzędziem zarządzania projektami który jest zaimplementowany jako aplikacja webowa. Trac jest napisany w Pythonie i może wykorzystywać [http://sqlite.org/ SQLite] oraz [http://www.postgresql.org/ PostgreSQL] jako bazę. Do renderowania html, Trac wykorzystuje [http://www.clearsilver.net/ Clearsilver] jako system template'ów.

Poniżej znajdują się ogólne instrukcje do zainstalowania i postawienia Traca, oraz jego wymagania. Podczas gdy można znaleźć instrukcje do zainstalowania Traca na specyficznych systemach [http://projects.edgewall.com/trac/wiki/TracInstallPlatforms TracInstallPlatforms], upewnij się że najpierw przeczytałeś i zrozumiałeś ogólny proces instalacji.

== Wymagania ==

Do zainstalowania Traca, wymagane jest zainstalowane następujące oprogramowanie:

 * [http://www.python.org/ Python], wersja >= 2.3.
   * Python 2.4 nie jest obsługiwany przez Windows, ponieważ nie ma dla niego żadnych bindingów do Subversion.
   * Dla systemów opartych na pakietach PRM, będą potrzebne również paczki: `python-devel` oraz `python-xml`.
 * [http://subversion.tigris.org/ Subversion], wersja >= 1.0. (>= 1.1 rekomendowana) i odpowiednio [http://svnbook.red-bean.com/svnbook-1.1/ch08s02.html#svn-ch-8-sect-2.3 bindingi Pytona]
   * Trac używa [http://www.swig.org/ SWIG] bindingów ujętych w dystrybucji Subversion, '''not''' [http://pysvn.tigris.org/ PySVN] (które są czasami pomieszane względem bindingów SWIG).
   * Jeśli Subversion było już wcześniej zainstalowane bez bindingów SWIG, niezbędna będzie rekonfiguracja Subversion oraz `make swig-py` i `make install-swig-py`.
 * [http://www.clearsilver.net/ ClearSilver], wersja >= 0.9.3
   * Wraz z python-bindings (`./configure --with-python=/usr/bin/python`)

=== Dla SQLite ===

 * [http://www.sqlite.org/ SQLite], wersja 2.8.x or 3.x
 * [http://pysqlite.org/ PySQLite]
   * wersja 1.0.x (dla SQLite 2.8.x)
   * wersja 1.1.x or 2.x (dla SQLite 3.x)

=== Dla PostgreSQL ===

 * [http://www.postgresql.org/ PostgreSQL]
 * [http://initd.org/projects/psycopg1 psycopg1], [http://initd.org/projects/psycopg2 psycopg2], lub [http://pypgsql.sourceforge.net/ pyPgSQL]

=== Wymagania opcjonalne ===

 * Serwer web obsługujący CGI (zobacz również TracCgi), lub
 * Serwer web osbługujący [http://www.fastcgi.com/ FastCGI] (zobacz TracFastCgi), lub
 * [http://httpd.apache.org/ Apache] wraz z [http://www.modpython.org/ mod_python 3.1.3+] (zobacz TracModPython)
 * [http://peak.telecommunity.com/DevCenter/setuptools setuptools], wersja >= 0.5a13 do używania pluginów (zobacz TracPlugins)
 * [http://docutils.sourceforge.net/ docutils], wersja >= 0.3.3 dla WikiRestructuredText.
 * [http://silvercity.sourceforge.net/ SilverCity] oraz/lub [http://www.gnu.org/software/enscript/enscript.html Enscript] dla [wiki:TracSyntaxColoring podświetlania składni].

'''Uwaga!''': Różne dostępne wersje powyższych zależności nie są całkiem właściwe dla różnych wersji, więc zwróć uwagę na numery wersji! Jeśli masz jakieś problemy z uruchomieniem Traca, sprawdź dwukrotnie wersje zależności, zanim zapytasz kogokolwiek o pomoc na [http://projects.edgewall.com/trac/wiki/MailingList liście mailowej] lub [http://projects.edgewall.com/trac/wiki/IrcChannel kanale IRC].

Odnieś się do dokumentacji tych pakietów, aby dowiedzieć się jak je najlepiej zainstalować. W dodatku większość [http://projects.edgewall.com/trac/wiki/TracInstallPlatforms instrukcji platform-specific] również opisuje instalację zależności.

== Instalowanie Traca ==

Jak większość programów w Pythonie, pakiet Pytahona do Traca jest instalowany poprzez wywołanie komendy w katalogu głównym projektu:
{{{
$ python ./setup.py install
}}}

''Uwaga: będziesz potrzebował uprawień roota aby wykonać ten krok.''

To skompiluje kod pythona i zainstaluje w katalogu `site-packages` w instalacji Pythona. Katalogi `cgi-bin`, `templates`, `htdocs`, `wiki-default` oraz `wiki-macros` są kopiowane do `$prefix/share/trac/.`

Skrypt zainstaluje również program [wiki:TracAdmin trac-admin] wywoływany z linii wiersza poleceń, używany do tworzenia oraz utrzymywania [wiki:TracEnvironment środowisk projektów], podobnie jak serwer [wiki:TracStandalone tracd].

=== Zaawansowani użytkownicy ===

Aby zainstalować Traca w nietypowej lokacji, lub żeby dowiedzieć się więcej o zaawansowanych opcjach instalacji, uruchom:
{{{
$ python ./setup.py --help
}}}

Możesz być również zainteresowany tym:
{{{
$ python ./setup.py install --prefix=/path/you/want
}}}


== Tworzenie środowiska projektu ==

[wiki:TracEnvironment Środowisko Traca] jest backendem w którym Trac trzyma rzeczy takie jak strony wiki, tickety, raporty, ustawienia, etc. Środowisko jest po prostu katalogiem, zawierającym napisany w sposób ludzki plik konfiguracyjny i wiele innych różnych plików i katalogów.

Nowe środowisko może być utworzone za pomocą programu [wiki:TracAdmin trac-admin]:
{{{
$ trac-admin /path/to/trac_project_env initenv
}}}

[wiki:TracAdmin trac-admin] zapyta się o informacje których potrzebuje do utworzenia środowiska, takie jak nazwa projektu, ścieżka do istniejącego respozytorium subversion, [wiki:TracEnvironment#DatabaseConnectionStrings string do łączenia z bazą], i inne. Jeśli nie jesteś pewien jak ustawić któryś z tych parametrów, zostaw puste pole tak żeby została domyślna wartość. String do łączenia z bazą będzie zawsze działał, o ile będziesz miał zainstalowane SQLite. Jedyną opcją przy której domyślna wartość raczej nie będzie działać, jest ścieżka do repozytorium Subversion, więc upewnij się że jest ona właściwa.

Zauważ również, że wartości które wprowadzasz, mogą być później zmienione przez bezpośrednią edycję pliku konfiguracyjnego [wiki:TracIni].

''Uwaga: Konto użytkownika na którym działa serwer www, wymaga praw zapisu do katalogu środowiska oraz wszystkich jego podkatalogów.''

== Uruchamianie niezależnego serwera ==

Po utworzeniu środowiska Traca, można w łatwy sposób wypróbować interfejs webowy, poprzez uruchomienie niezależnego serwera [wiki:TracStandalone tracd]:
{{{
$ tracd --port 8000 /path/to/projectenv
}}}

Następnie uruchom przeglądarkę internetową i wejdź pod adres `http://localhost:8000/`. Powinieneś otrzymać prostą listę wszystkich środowisk o których wie tracd. Wejdź pod link do środowiska które właśnie stworzyłeś i powinieneś zobaczyć Traca w akcji!

== Uruchamianie Traca na serwerze www ==

Trac trzy możliwości połaczenia z a “prawdziwym” serwerem web: [wiki:TracCgi CGI], [wiki:TracFastCgi FastCGI] oraz [wiki:TracModPython mod_python]. Dla uzyskania sensownej wydajności, zalecane jest korzystanie z FastCGI bądź mod_python.

== Konfiguracja autentyfikacji ==

Proces dodawania, usuwania oraz konfigurowania kont użytkowników do autentyfikacji zależy od specyfiki uruchamiania Traca. Żeby nauczyć się jak zakończyć to zadanie, odwiedź jedną z poniższych stron:

 * TracStandalone jeśli używasz niezależnego serwera, `tracd`.
 * TracCgi jeśli używasz metod CGI lub FastCGI.
 * TracModPython jeśli używasz metody mod_python.

== Używanie Traca ==

Jeśli już masz uruchomioną stronę Traca, powinieneś być w stanie przeglądać repozytorium subversion, tworzyć tickety, przeglądać timeline, etc.

Pamiętaj że użytkownicy anonimowi(anonymous) mają domyślnie dostęp do większości, ale jednak nie do wszystkich własności Traca. Będziesz musiał skonfigurować autentyfikację i zapewnić dodatkowe [wiki:TracPermissions prawa dostępu] żeby zapewnić cały zestaw możliwości zalogowanym użytkownikom.

''Miłej zabawy!''

[http://projects.edgewall.com/trac/wiki/TracTeam Zespół Traca]

----
Zobacz również:  TracGuide, TracCgi, TracFastCgi, TracModPython, TracUpgrade, TracPermissions