Diese Seite beschreibt die Anpassung von Trac an die Bedürfnisse von systemausfall.org.
Inhaltsverzeichnis
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
- 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
- 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
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
- 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 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
- 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 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 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ä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 https:// statt http:// beginnen.
Unter /data/patches/trac liegt der entsprechende Patch1. 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 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 /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
Der Patch bezieht sich auf die Debian Trac-Version 0.8.1-3 (1)