InterTrac Links

Trac erlaubt die Verlinkung von Ressourcen auf anderen Trac-Servern per Wiki-Markup seit Version 0.10.

Definitionen

Einen InterTrac-Link kann man als gezielten TracLinks betrachten. Er wird genutzt, um auf Trac-Ressourcen (Wiki-Seiten, Changesets, Tickets, ...) anderer Trac-Installationen zu verweisen.

Liste aktiver InterTrac Prefixe

PrefixTrac Site

Ein InterTrac-Link wird gebildet, indem man einfach den Prefix voranstellt, gefolgt von einem Doppelpunkt. Danach folgt wie gewohnt die Bezeichnung der ressource im anderen Trac. 

<target_environment>:<TracLinks>

Für den TracLinks auf dem externen Trac gelten die normalen Regeln.

Das target_environment ist entweder der reale Name des Trac, oder ein Alias. Die Aliasse sind in trac.ini definiert (siehe unten). Der Prefix ist case insensitive.

Für die Bequemlichkeit gibt es außerdem eine Abkürzungsform, bei dem ein Alias als direkter Prefix zu einem Ticket, Changeset oder Report genutzt werden kann (z.B. #T234, [T1508], [trac 1508], ...).

Beispiele

Es ist notwendig, das InterTrac-Feature zu konfigurieren. Dies muß in der TracIni-Datei in der Sektion [intertrac] geschehen.

Beispiel-Konfiguration: 

...
[intertrac]
# -- Example of setting up an alias:
t = trac

# -- Link to an external Trac:
trac.title = Edgewall's Trac for Trac
trac.url = http://projects.edgewall.com/trac
trac.compat = false

Die Angabe .url ist zwingend notwendig und wird genutzt, um Links zum anderen Trac zu erstellen. Das kann eine relative URL sein, sofern das andere Trac sich auf dem gleichen Server befindet.

Die .title-Angabe wird zum Erstellen eines Tooltips genutzt.

Die .compat-Option kann zum Aktivieren eines Kompabilitätsmodus genutzt werden:

  • Wenn das andere Trac eine Version unter 0.10 (r3526) nutzt, weiß es nichts mit InterTrac-Links anzufangen, und das lokale Trac muß den Link entsprechend anpassen. Nicht alle Links werden so funktionieren, aber die meisten tun es. Dieser Modus wird Kompatibilitätsmodus genannt und ist standardmäßig aktiv.
  • Wenn klar ist, dass das andere Trac mit Intertrac-Links klar kommt, kann der Modus deaktiviert werden, und jeder TracLinks kann ein InterTrac-Link werden.

Mit der obigen Konfiguration kann man die folgenden Links erstellen:

  • zu dieser InterTrac-Seite:
    • trac:wiki:InterTrac trac:wiki:InterTrac
    • t:wiki:InterTrac t:wiki:InterTrac
    • Der Prefix ist case insensitive: T:wiki:InterTrac T:wiki:InterTrac
  • zum Ticket #234:
    • trac:ticket:234 trac:ticket:234
    • trac:#234 trac:#234
    • #T234 #T234
  • Zum Changeset [1912]:
    • trac:changeset:1912 trac:changeset:1912
    • [T1912] [T1912]
  • Zum Log-Bereich [3300:3330]: (Das erfordert trac.compat=false)
    • trac:log:@3300:3330 trac:log:@3300:3330
    • [trac 3300:3330] [trac 3300:3330]

Die normale Form intertrac_prefix:module:id wird übersetzt zur zugehörigen URL <remote>/module/id, abgekürzte Links sind spezifisch für einige Module (z.B. wird #T234 vom Ticket-Modul verarbeitet), für den Rest (intertrac_prefix:something) wird TracSearch#quickjump des anderen Tracs genutzt.

Weiterführende Seiten: TracLinks, InterWiki

Übersetzt von Sven Rautenberg, SELFHTML e.V.

Diese deutsche Übersetzung der Original-Trac-Wikiseite ist lizensierbar unter Creative Commons BY-SA: Namensnennung, Weitergabe unter gleichen Bedingungen.