Diese Seite beschreibt die Anpassung von Trac an die Bedürfnisse von ''systemausfall.org''.

<<TableOfContents>>

Falls du mit Plugins oder sonstwelchen Tracteilen Probleme hast, hilft das trac interne Logging (entweder in /etc/trac/trac.ini oder über die webadmin Oberfläche aktivieren).

= Webadmin =
 * siehe http://trac.edgewall.org/wiki/WebAdmin
 * Installation
  * svn sourcen holen: {{{
svn co http://svn.edgewall.com/repos/trac/sandbox/webadmin/
}}}
  * installieren {{{
python setup.py install
}}}
  * die folgende Zeile muss in der systemweit gültigen ''/etc/trac/trac.ini'' eingetragen sein: {{{
webadmin.* = enabled
}}}

= Delete-Ticket-Comment =
 * siehe http://trac-hacks.org/wiki/TicketDeletePlugin
 * Installation:
  * auspacken
  * installieren {{{
python setup.py install
}}}
  * die folgende Zeile muss in der systemweit gültigen ''/etc/trac/trac.ini'' eingetragen sein: {{{
ticketdelete.* = enabled
}}}

= Spam-Filter =
 * siehe http://trac.edgewall.org/wiki/SpamFilter
 * installieren: {{{
easy_install TracSpamFilter
}}}
 * zum Aktivieren folgende Zeile in die systemweit gültige ''/etc/trac/trac.ini'' in der Sektion ''components'' einfügen: {{{
tracspamfilter.* = enabled
}}}
 * Damit der Spamfilter optimal funktioniert ist ''python-dnspython'' nötig. Leider erkennt trac nicht das per apt-get installeirte Paket, so dass es wie folgt installiert werden sollte: {{{
easy_install dnspython
}}}
 * spambayes für trac ist noch nicht lauffähig

= TracRedirect Plugin =
''Das !TracRedirect Plugin war früher ein Macro.''
 * Homepage: http://svn.ipd.uka.de/trac/javaparty/wiki/TracRedirect
 * die aktuellste Version des !TracRedirect Python eggs herunterladen und installieren: {{{
easy_install-2.4 Redirect-0.9.1-py2.4.egg
}}}
 * in ''/etc/trac/trac.ini'' zum Bereich ''[components]'' hinzufügen: {{{
"redirect.* = enable "
}}}
 * Webserver neu starten

= TracTocMacro =
''Einige aktuelle Macros werden als Plugin installiert, so auch TOC''
 * http://trac-hacks.org/wiki/TocMacro
 * Zip Datei herunterladen und entpacken. Diese enthält auch ältere Versionen.
 * in das Unterverzeichnis v0.10 wechseln und folgendes aufrufen: {{{
python setup.py bdist_egg
easy_install-2.4 dist/TracTocMacro-1.0-py2.4.egg
}}}
  * v0.11 enthält momentan einen [[http://trac-hacks.org/ticket/1610|Bug]]
 * in ''/etc/trac/trac.ini'' zum Bereich ''[components]'' hinzufügen: {{{
"tractoc.* = enable "
}}}
 * in Debian Etch wird noch ''python-genshi'' benötigt: {{{
apt-get install python-genshi
}}}
  * um das rauszufinden waren die trac Logdateien sinnvoll, die auf sao deaktiviert waren
 * Webserver neu starten nicht vergessen

= TracPollMacro =
 * http://trac-hacks.org/wiki/PollMacro
 * Zip Datei entpacken
 * im Unterverz. 0.9 {{{
python setup.py install
}}}
 * in ''/etc/trac/trac.ini'' reinschreiben: {{{
[components]
tracpoll.* = enabled
[poll]
base_dir = /foobar
}}}
 * Webserver neu starten nicht vergessen
 * Damit die Umfrage auf einer Wikiseite erscheint, trägst du z.B. folgendes ein: {{{
[[Poll(Was gefällt dir am Besten?; Radfahren; Zitronen essen; im Sitzen pinkeln)]] 
}}}

= Trac-Admin-Konsole =
Status: '''nicht mehr nötig, da wir nun das webadmin-Plugin verwenden - ab v0.11 wird es builtin sein'''

Die Verwaltung der Milestones und der Zugangsrechte ist in der Version 0.8.1 von ''trac'' noch nicht per Web-Interface möglich. Also haben wir ein Skript geschrieben, mit dem das Konsolen-Administrationsprogramm per Web-Schnittstelle benutzt werden kann. Es ist äußerst einfach aufgebaut.

Die Zugriffsrechte können lediglich durch http-auth eingeschränkt werden. Jeder authorisierte Nutzer kann generell auf alle ''trac''-Projekte des Systems zugreifen.

Dieses [[https://systemausfall.org/trac/sao/ticket/9|Ticket]] beschreibt den Problemverlauf. Folgende Schritte sind notwendig:

Die Datei ''/etc/[apache|apache-ssl|apache2]/conf.d/trac.conf'' bearbeiten:

{{{
ScriptAlias     /tracadmin      /data/scripts/tracadmin-console.sh

<Location /tracadmin>
        AuthName                systemausfall.org
        AuthType                Basic
        AuthLDAPUrl ldap://ldap.sao/o=neofaxe,dc=systemausfall,dc=org?cn?sub?(objectClass=webAccount)
        AuthLDAPGroupAttribute  adminOfService
        AuthLDAPGroupAttributeIsDN      On
        require         group cn=trac-sao,sc=trac,ou=Services,o=neofaxe,dc=systemausfall,dc=org
</Location>
}}}

Das trac-Admin-Skript findest du [[attachment:tracadmin-console.sh|hier]] [Stand: 10. Mai 02005].

Um einen Link zur Konsole einzurichten, sollte folgendes in der ''templates/site_header.cs'' eines Trac-Projekts stehen:

{{{
<div style="position:absolute; top:10x; right:10px">
<a href="/tracadmin" title="die selbstgemachte Konsolen-Oberfl&auml;che">TracAdmin-Konsole</a>
</div>
}}}

= Benachrichtigungsmails =
Status: '''nicht mehr hilfreich, da wir auch ein nicht-https trac anbieten (http://devel.cryptobox.org))'''

Die Trac Benachrichtigungsmails enthalten in der Fusszeile die URL des jeweiligen Tickets. Da wir einen ssl-Webserver nutzen, muss die URL in unserem Fall mit <<Verbatim(https://)>> statt <<Verbatim(http://)>> beginnen.

Unter [[SubVersion:sao/patches/trac|/data/patches/trac]] liegt der entsprechende Patch<<FootNote(Der Patch bezieht sich auf die Debian Trac-Version 0.8.1-3)>>. Um die Datei zu patchen ist folgendes durchzuführen:
{{{
cd /usr/lib/python2.3/site-packages/trac/

patch -p1 </data/patches/trac/notifier_mail-https-ticket-links.patch
}}}

= Ticket-Kommentare in der Timeline =
Kommentare zu den einzelnen Tickets werden in der ''Timeline'' nicht angezeigt. Siehe hierzu [[http://projects.edgewall.com/trac/ticket/890Ticket|890]] des Trac-Projekts.

== trac >= 0.9 ==
Status: '''derzeit nötig'''

 * Einstellung in ''trac.ini'': [timeline] -> ''ticket_show_details'' auf ''1'' setzen (für jedes trac-Projekt)
{{{
patch -p1 < /data/patches/trac/timeline_ticket_details_v0.10.patch
}}}

== trac < v0.9 ==
Status: '''nicht mehr für uns relevant'''

Unter [[SubVersion:sao/patches/trac|/data/patches/trac]] liegen die zwei (angepassten) Patches:
{{{
cd /usr/lib/python2.3/site-packages/trac/

patch -p1 < /data/patches/trac/timeline_ticket-change_part1.patch

cd /usr/share/trac/

patch -p1 < /data/patches/trac/timeline_ticket-change_part2.patch
}}}