= [WikiFormatting Wiki-Formatierung] =
[[TracGuideToc]]
[[TranslatedPages(revision=109)]]
Wiki-Formatierung ist eine von Trac's wesentlichen Funktionen, die alle anderen Teile von Trac zu einem anpassungs- und leistungsfähigen Ganzen verbindet.
Trac hat einen schlanken integrierten Wiki-Prozessor. Dieser Wiki-Prozessor stellt eine ständig wachsende Anzahl von Anweisungen anderer bekannter Wikis bereit, insbesondere von [http://moinmoin.wikiwikiweb.de/ MoinMoin] und [trac:WikiCreole].
Diese Seite stellt die Formatierungssyntax detailliert dar, die überall verfügbar ist, wo [WikiFormatting Wiki-Formatierung] eingesetzt werden kann.
Die folgende ''Referenzseite'' gibt einen groben Überblick über die gebräuchlichste Syntax. Jeder Verweis in der Spalte ''Kategorie'' führt zu einer ausführlicheren Beschreibung weiter unten auf dieser Seite.
Einige andere Wikiseiten stellen weiterführende Eigenschaften der Wiki-Formatierung von Trac noch genauer dar:
- TracLinks behandelt alle möglichen Arten, präzise auf jedes Trac-Dokument oder Teile davon zu verweisen,
- WikiPageNames bespricht die verschiedenen Namen, die Wikiseiten erhalten können, mit oder ohne CamelCase-Form
- WikiMacros listet die zur Erstellung von dynamischen Inhalten verfügbaren Macros auf,
- WikiProcessors und WikiHtml präzisieren, wie Teile des Wikitextes auf besondere Art und Weise behandelt werden können
{{{
#!comment
continue from here
}}}
== Cheat sheet ==
||= '''Kategorie''' =||= '''Wiki-Formatierung''' =||= '''Darstellung''' =||
|-----------------------------------------------------------
{{{#!th rowspan=3
[#FontStyles Schriftarten]
}}}
|| `'''fett'''`, `''kursiv''`, `'''''Wikipedia-Stil'''''` || \
|| '''fett''', ''kursiv'', '''''Wikipedia-Stil''''' ||
|| {{{`einheitlich breit und ''nicht-Wiki''`}}} || \
|| `einheitlich breit und ''nicht-Wiki''` ||
|| `**fett**`, `//kursiv//`, `**//!WikiCreole-Stil//**` || \
|| **fett**, //kursiv//, **//!WikiCreole-Stil//** ||
|-----------------------------------------------------------
||= [#Headings Überschriften] =||\
{{{#!td
{{{
== 2. Grad ==
=== 3. Grad ^([#hn Hinweis])^
}}}
}}}
{{{#!td style="padding-left: 2em"
== 2. Grad ==
=== 3. Grad ^([#hn Hinweis])^
}}}
|-----------------------------------------------------------
||= [#Paragraphs Absätze] =||\
{{{#!td
{{{
Erster Absatz
auf mehreren Zeilen.
Zweiter Absatz.
}}}
}}}
{{{#!td
Erster Absatz
auf mehreren Zeilen.
Zweiter Absatz.
}}}
|-----------------------------------------------------------
||= [#Lists Listen] =||\
{{{#!td
{{{
* Aufzählungsliste
verteilt über mehrere Zeilen
1. eingebettete Liste
a. abweichender Stil
der Nummerierung
}}}
}}}
{{{#!td
* Aufzählungsliste
verteilt über mehrere Zeilen
1. eingebettete Liste
a. abweichender Stil
der Nummerierung
}}}
|-----------------------------------------------------------
{{{#!th
[#DefinitionLists Definitionslisten]
}}}
{{{#!td
{{{
Begriff:: mehrzeilige
Definition
}}}
}}}
{{{#!td
Begriff:: mehrzeilige
Definition
}}}
|-----------------------------------------------------------
||= [#PreformattedText Vorformatierter Text] =||\
{{{#!td
{{{
{{{
mehrere Zeilen, ''nicht-Wiki''
berücksichtigt Leerzeichen
}}}
}}}
}}}
{{{#!td
{{{
mehrere Zeilen, ''nicht-Wiki''
berücksichtigt Leerzeichen
}}}
}}}
|-----------------------------------------------------------
||= [#Blockquotes Zitat-Block] =||\
{{{#!td
{{{
bei vorangestellten Leerzeichen
wird der Text eingerückt
}}}
}}}
{{{#!td
bei vorangestellten Leerzeichen
wird der Text eingerückt
}}}
|-----------------------------------------------------------
||= [#DiscussionCitations Diskussionszitate] =||\
{{{#!td
{{{
>> ... (Ich sagte)
> (er antwortete)
}}}
}}}
{{{#!td
>>... (Ich sagte)
> (er antwortete)
}}}
|-----------------------------------------------------------
||= [#Tables Tabellen] =||\
{{{#!td
{{{
||= Tabellenkopf =|| Zelle ||
|||| (Einzelheiten weiter unten) ||
}}}
}}}
{{{#!td
||= Tabellenkopf =|| Zelle ||
|||| (Einzelheiten weiter unten) ||
}}}
|-----------------------------------------------------------
{{{#!th rowspan=2
[#Links Verweise]
}}}
|| `http://trac.edgewall.org` ||\
|| http://trac.edgewall.org ||
|| `WikiFormatting (CamelCase)` ||\
|| WikiFormatting (CamelCase) ||
|-----------------------------------------------------------
{{{#!th rowspan=5
[#TracLinks Verweise in Trac («Trac Links»)]
}}}
|| `wiki:WikiFormatting`, `wiki:"WikiFormatting"` ||\
|| wiki:WikiFormatting, wiki:"WikiFormatting" ||
|| `#1 (Ticket)`, `[1] (Changeset)`, `{1} (Bericht)` ||\
|| #1 (Ticket), [1] (Changeset), {1} (Bericht) ||
|| `ticket:1, ticket:1#comment:1` ||\
|| ticket:1, ticket:1#comment:1 ||
|| `Ticket [ticket:1]`, `[ticket:1 Ticket eins]` ||\
|| Ticket [ticket:1], [ticket:1 Ticket eins] ||
|| `Ticket [[ticket:1]]`, `[[ticket:1|Ticket eins]]` ||\
|| Ticket [[ticket:1]], [[ticket:1|Ticket eins]] ||
|-----------------------------------------------------------
{{{#!th rowspan=2
[#SettingAnchors Sprungmarken setzen]
}}}
|| `[=#Punkt1 (1)] Erstens...` ||\
|| [=#Punkt1 (1)] Erstens... ||
|| `Siehe [#Punkt1 (1)]` ||\
|| Siehe [#Punkt1 (1)] ||
|-----------------------------------------------------------
{{{#!th rowspan=3
[#EscapingLinksandWikiPageNames Formatierung auskommentieren]
}}}
|| `!'' doppelte Anführungszeichen` ||\
|| !'' doppelte Anführungszeichen ||
|| `!wiki:WikiFormatting`, `!WikiFormatting` ||\
|| !wiki:WikiFormatting, !WikiFormatting ||
|| `{{{-}}} geschweifte Klammern` ||\
|| {{{-}}} geschweifte Klammern ||
|-----------------------------------------------------------
||= [#Images Bilder] =|| `[[Image(`''Verweis''`)]]` || [[Image(htdocs:../common/trac_logo_mini.png)]] ||
|-----------------------------------------------------------
{{{#!th rowspan=2
[#Macros Makros]
}}}
|| `[[MacroList(*)]]` || ''(Auflistung aller verfügbaren Makros)'' ||
|| `[[Image?]]` || ''(Hilfe zum Image-Makro)'' ||
|-----------------------------------------------------------
||= [#Processors Prozessoren] =||\
{{{#!td
{{{
{{{
#!div style="font-size: 80%"
Programmcode-Hervorhebungen:
{{{#!python
hallo = lambda: "Welt"
}}}
}}}
}}}
}}}
{{{#!td style="padding-left: 2em"
{{{
#!div style="font-size: 80%"
Programmcode-Hervorhebungen:
{{{#!python
hallo = lambda: "Welt"
}}}
}}}
}}}
|-----------------------------------------------------------
||= [#Comments Kommentare] =||\
{{{#!td
{{{
{{{#!comment
Anmerkungen für Bearbeiter: ...
}}}
}}}
}}}
{{{#!td style="padding-left: 2em"
{{{#!comment
Anmerkungen für Bearbeiter: ...
}}}
}}}
|-----------------------------------------------------------
||= [#Miscellaneous Verschiedenes] =||\
{{{#!td
{{{
Zeilen- [[br]] umbruch
Zeilen- \\ umbruch
----
}}}
}}}
{{{#!td style="padding-left: 2em"
Zeilen- [[br]] umbruch
Zeilen- \\ umbruch
----
}}}
== Schriftarten == #FontStyles
Das Trac-Wiki erlaubt die folgenden Schriftarten:
||= Wiki-Formatierung =||= Darstellung =||
{{{#!td
{{{
* '''fett''',
''' drei Anführungszeichen !'''
können mit vorangestelltem ! ebenfalls fett dargestellt werden ''',
* ''kursiv''
* '''''fett kursiv''''' oder ''kursiv und
''' kursiv fett ''' ''
* __unterstrichen__
* {{{gleichmäßig breit}}} oder `gleichmäßig breit`
(daher `{{{` oder {{{`}}} Auskommentierung)
* ~~durchgestrichen~~
* ^hochgestellt^
* ,,tiefgestellt,,
* **auch fett**, //ebenso kursiv//,
und **'' fett kursiv **'' //(seit 0.12)//
}}}
}}}
{{{#!td
* '''fett''',
''' drei Anführungszeichen !'''
können mit vorangestelltem ! ebenfalls fett dargestellt werden ''',
* ''kursiv''
* '''''fett kursiv''''' oder ''kursiv und
''' kursiv fett ''' ''
* __unterstrichen__
* {{{gleichmäßig breit}}} oder `gleichmäßig breit`
(daher `{{{` oder {{{`}}} Auskommentierung)
* ~~durchgestrichen~~
* ^hochgestellt^
* ,,tiefgestellt,,
* **auch fett**, //ebenso kursiv//,
und **'' fett kursiv **'' //(seit 0.12)//
}}}
Anmerkungen:
* `{{{...}}}` und {{{`...`}}} Anweisungen wählen nicht nur eine gleichmäßig breite Schrift, sie behandeln ihren Inhalt auch als Klartext, d.h. dieser Text wird nicht weiter behandelt.
* {{{ ! }}} weist den Wiki-Übersetzer an, die nachfolgenden Zeichen nicht als Wiki-Formatierung auszuwerten. Denken Sie deshalb daran, nach ! ein Leerzeichen zu setzen, z.B. wenn Sie mit Fettschrift enden.
* Alle Schriftstil-Marken müssen als öffnende/abschließende Paare gesetzt werden,
und sie müssen korrekt verschachtelt werden (insbesondere kann ein `''` kursiv nicht mit einem `//` kursiv kombiniert werden, und `'''` nicht mit `**`).
== Überschriften == #Headings
Sie können Überschriften erstellen, indem Sie eine Zeile mit einem bis sechs Gleichheitszeichen ("=") beginnen,
gefolgt von einem einzelnen Leerzeichen und dem Titelzeilentext.
[=#hn]
Dem Titelzeilentext kann die gleiche Anzahl an "="-Zeichen folgen, aber dies ist nicht mehr zwingend erforderlich.
Schließlich kann der Überschrift eine vorgegebene ID folgen. Ohne Vorgabe wird trotzdem eine lesbare ID erzeugt.
||= Wiki-Formatierung =||= Darstellung =||
{{{#!td
{{{
= Hauptüberschrift =
== Überschift 2. Grades
=== Über ''diese Thema'' ===
=== Vorgegebene ID === #Nutzung-vorgegebenen-IDs-in-Überschriften
== Überschift 2. Grades #Überschrift2
}}}
}}}
{{{#!td style="padding: 1em;"
{{{
#!div
= Hauptüberschrift =
== Überschift 2. Grades
=== Über ''diese Thema'' ===
=== Vorgegebene ID === #Nutzung-vorgegebenen-IDs-in-Überschriften
== Überschift 2. Grades #Überschrift2
}}}
}}}
== Absätze == #Paragraphs
Immer dann, wenn zwei Textblöcke durch eine oder mehrere Leerzeilen getrennt sind, wird ein neuer Textabsatz erzeugt.
Ein erzwungener Zeilenumbruch kann ebenfalls wie folgend eingefügt werden:
||= Wiki-Formatierung =||= Darstellung =||
{{{#!td
{{{
Zeile 1[[BR]]Zeile 2
}}}
{{{
Absatz
eins
Absatz
zwei
}}}
}}}
{{{#!td
Zeile 1[[BR]]Zeile 2
Absatz
eins
Absatz
zwei
}}}
== Listen == #Lists
Das Wiki unterstützt sowohl einfache als auch geordnete/nummerierte Listen.
Beispiel:
||= Wiki-Formatierung =||= Darstellung =||
{{{#!td
{{{
* Element 1
* Element 1.1
* Element 1.1.1
* Element 1.1.2
* Element 1.1.3
* Element 1.2
* Element 2
- Elemente können am Anfang einer Zeile beginnen
und mehrere Zeilen umfassen
- Achten Sie sorgfältig auf passende Einrückung
der Fortsetzung in der nächsten Zeile,
weil ansonsten ein neuer Absatz erzeugt wird ...
1. Element 1
a. Element 1.a
a. Element 1.b
i. Element 1.b.i
i. Element 1.b.ii
1. Element 2
Nummerierte Listen können auch
mit einer vorgegebenen Nummer weitergeführt werden:
3. Element 3
}}}
}}}
{{{#!td
* Element 1
* Element 1.1
* Element 1.1.1
* Element 1.1.2
* Element 1.1.3
* Element 1.2
* Element 2
- Elemente können am Anfang einer Zeile beginnen und mehrere Zeilen umfassen
- Achten Sie sorgfältig auf passende Einrückung
der Fortsetzung in der nächsten Zeile,
weil ansonsten ein neuer Absatz erzeugt wird ...
1. Element 1
a. Element 1.a
a. Element 1.b
i. Element 1.b.i
i. Element 1.b.ii
1. Element 2
Nummerierte Listen können auch
mit einer vorgegebenen Nummer weitergeführt werden:
3. Element 3
}}}
== Definitionslisten == #DefinitionLists
Das Wiki erlaubt außerdem Definitionslisten.
||= Wiki-Formatierung =||= Darstellung =||
{{{#!td
{{{
llama::
eine Säugetierart, mit Haaren
ppython::
eine Reptilienart, ohne Haar
(Schreibfehler gefunden?)
}}}
}}}
{{{#!td
llama::
eine Säugetierart, mit Haaren
ppython::
eine Reptilienart, ohne Haar
(Schreibfehler gefunden?)
}}}
Beachten Sie, dass ein Leerzeichen vor dem zu definierenden Begriff erforderlich ist.
== Vorformatierter Text == #PreformattedText
Textböcke mit vorformatiertem Text eignen sich für Teile von Programmcode, Anmerkungen und Beispiele. Setzen Sie den Text in drei ''geschweifte Klammern'', um einen Zitat-Block (engl.: block quote) einzuleiten. Die geschweiften Klammern müssen auf einer eigenen Zeile stehen.
||= Wiki-Formatierung =||= Darstellung =||
{{{#!td
{{{
{{{
def HelloWorld():
print '''Hello World'''
}}}
}}}
}}}
{{{#!td
{{{
def HelloWorld():
print '''Hello World'''
}}}
}}}
Beachten Sie, dass diese Art von Textblock auch dazu benutzt wird, Zeilen für die Bearbeitung durch [WikiProcessors Wiki-Prozessoren] auszuwählen.
== Zitat-Block == #Blockquotes
Rücken Sie den Absatz mit zwei Leerzeichen ein, um ihn als Zitat-Block zu markieren.
||= Wiki-Formatierung =||= Darstellung =||
{{{#!td
{{{
Absatz
Dieser Text ist ein Zitat eines anderen.
}}}
}}}
{{{#!td
Absatz
Dieser Text ist ein Zitat eines anderen.
}}}
== Diskussionszitate == #DiscussionCitations
Um Zitate im Verlauf einer Diskussion, beispielsweise in den Ticketkommentaren, zu kennzeichnen, können Zitatmarken wie bei E-Mails (">", ">>", etc.) eingesetzt werden.
||= Wiki-Formatierung =||= Darstellung =||
{{{#!td
{{{
>> Jemandes ursprünglicher Text
> Antworttext eines anderen
> - mit jeglicher Art von Wiki-Formatierung
Mein Antworttext
}}}
}}}
{{{#!td
>> Jemandes ursprünglicher Text
> Antworttext eines anderen
> - mit jeglicher Art von Wiki-Formatierung
Mein Antworttext
}}}
== Tabellen == #Tables
=== Einfache Tabellen ===
Einfache Tabellen können folgendermaßen erstellt werden:
||= Wiki-Formatierung =||= Darstellung =||
{{{#!td
{{{
||Zelle 1||Zelle 2||Zelle 3||
||Zelle 4||Zelle 5||Zelle 6||
}}}
}}}
{{{#!td style="padding: 2em;"
||Zelle 1||Zelle 2||Zelle 3||
||Zelle 4||Zelle 5||Zelle 6||
}}}
Zellenüberschriften können durch Setzen des Inhalts zwischen ein Paar Gleichheitszeichen definiert werden.
Beachten Sie, dass die '='-Zeichen bündig mit den Zellgrenzenmarken sein müssen, etwa so:
||= Wiki-Formatierung =||= Darstellung =||
{{{#!td
{{{
|| ||= stabil =||= neueste =||
||= 0.10 =|| 0.10.5 || 0.10.6dev||
||= 0.11 =|| 0.11.6 || 0.11.7dev||
}}}
}}}
{{{#!td style="padding: 2em;"
|| ||= stabil =||= neueste =||
||= 0.10 =|| 0.10.5 || 0.10.6dev||
||= 0.11 =|| 0.11.6 || 0.11.7dev||
}}}
Schließlich bedeutet die Angabe einer leeren Zelle, dass die nächste nicht-leere Zelle mit auf die leeren Zellen ausgedehnt wird. Zum Beispiel:
||= Wiki-Formatierung =||= Darstellung =||
{{{#!td
{{{
|| 1 || 2 || 3 ||
|||| 1-2 || 3 ||
|| 1 |||| 2-3 ||
|||||| 1-2-3 ||
}}}
}}}
{{{#!td style="padding: 2em;"
|| 1 || 2 || 3 ||
|||| 1-2 || 3 ||
|| 1 |||| 2-3 ||
|||||| 1-2-3 ||
}}}
Beachten Sie, dass der Inhalt einer Zelle an der Seite ausgerichet wird, an der der Inhalt der Zelle anliegt, und nur an dieser. Beispiel:
||= Wiki-Formatierung =||= Darstellung =||
{{{#!td
{{{
||=Text =||= Zahlen =||
||links ausgerichtet || 1.0||
|| zentriert || 4.5||
|| rechts ausgerichtet|| 4.5||
|| Standardausrichtung || 2.5||
||Standard|| 2.5||
|| Standard || 2.5||
|| Standard || 2.5||
}}}
}}}
{{{#!td style="padding: 2em;"
||=Text =||= Zahlen =||
||links ausgerichtet || 1.0||
|| zentriert || 4.5||
|| rechts ausgerichtet|| 4.5||
|| Standardausrichtung || 2.5||
||Standard|| 2.5||
|| Standard || 2.5||
|| Standard || 2.5||
}}}
Falls die Zellen, im Gegensatz zum vorherigen Beispiel, mehr Text enthalten, könnte es zweckmäßg sein, die Tabellenzeilen auf mehrere Zeilen Wiki-Formatierung zu verteilen. Das `\`-Zeichen weist Trac am Ende einer Zeile nach einer Zellgrenzenmarke an, die Zellen auf der nächsten Zeile nicht auf eine neue Tabellenzeile zu setzen.
||= Wiki-Formatierung =||
{{{#!td
{{{
|| das ist Spalte 1 [http://trac.edgewall.org/newticket neues Ticket] || \
|| das ist Spalte 2 [http://trac.edgewall.org/roadmap der weitere Weg] || \
|| dies ist Spalte 3, die letzte ||
}}}
}}}
|-------------
||= Darstellung =||
{{{#!td style="padding: 2em;"
|| das ist Spalte 1 [http://trac.edgewall.org/newticket neues Ticket] || \
|| das ist Spalte 2 [http://trac.edgewall.org/roadmap der weitere Weg] || \
|| dies ist Spalte 3, die letzte ||
}}}
=== Komplex aufgebaute Tabellen ===
Falls die Möglichkeiten, die mit der zuvor beschriebenen, trennstrich-basierten Formatierung für Tabellen geboten werden, Ihre Anforderungen nicht erfüllen, können Sie aufwendigere Tabellen auf [#Processors-example-tables Basis von Wiki-Prozessoren] erstellen.
== Verweise == #Links
Verweise werden bei Wikiseitennamen und URLs automatisch erzeugt. !WikiSeitenVerweise können durch das Voranstellen eines Ausrufezeichens "!" deaktiviert werden, so wie bei {{{!WikiSeitenVerweis}}}.
||= Wiki-Formatierung =||= Darstellung =||
{{{#!td
{{{
TitleIndex, http://www.edgewall.com/, !KeinVerweis
}}}
}}}
{{{#!td
TitleIndex, http://www.edgewall.com/, !KeinVerweis
}}}
Verweisen kann ein zutreffenderer Titel gegeben werden, indem der Verweis gefolgt von einem Leerzeichen und einem Titel in eckigen Klammern geschrieben wird.
Falls man auf diesen Titel verzichtet, wird der Bezeichner entfernt, außer der Verweis ist ein externer Verweis. Dies kann für Wikiseiten nützlich sein, die nicht der [WikiPageNames Wikiseiten-Namenskonvention] folgen.
||= Wiki-Formatierung =||= Darstellung =||
{{{#!td
{{{
* [http://www.edgewall.com Edgewall Software]
* [wiki:TitleIndex Inhaltsverzeichnis]
* [wiki:TitleIndex]
* [wiki:ISO9000]
}}}
}}}
{{{#!td
* [http://www.edgewall.com Edgewall Software]
* [wiki:TitleIndex Inhaltsverzeichnis]
* [wiki:TitleIndex]
* [wiki:ISO9000]
}}}
Dem [trac:WikiCreole]-Trend folgend kann ein zutreffenderer Titel auch als Verweis gefolgt von einem senkrechten Trennstrich ('|') und dem Titel in //doppelten// eckigen Klammern geschrieben werden.
{{{#!td
{{{
* [[http://www.edgewall.com|Edgewall Software]]
* [[wiki:TitleIndex|Inhaltsverzeichnis]]
oder sogar [[TitleIndex|Inhaltsverzeichnis]]
* [[wiki:TitleIndex]]
''' aber nicht ![[TitleIndex]]! '''
* [[ISO9000]]
}}}
}}}
{{{#!td
* [[http://www.edgewall.com|Edgewall Software]]
* [[wiki:TitleIndex|Inhaltsverzeichnis]]
oder sogar [[TitleIndex|Inhaltsverzeichnis]]
* [[wiki:TitleIndex]]
''' aber nicht ![[TitleIndex]]! '''
* [[ISO9000]]
}}}
'''Anmerkung''': Der [trac:WikiCreole]-Stil für Verweise ist schnell zu schreiben und
wirkt sicherlich vertraut, weil er auch von Wikipedia und vielen anderen Wikis benutzt wird.
Leider erzeugt er einen Konflikt mit der Syntax für [#Macros Makros].
Daher rufen Sie in dem seltenen Fall, in dem Sie auf eine Seite verweisen,
die nach einem Makro benannt ist (typische Beispiele sind TitleIndex, InterTrac und InterWiki),
mit der Schreibweise `[[TitleIndex]]` das Makro auf, anstatt auf diese Seite zu verweisen.
== Verweise in Trac («Trac Links») == #TracLinks
Wikiseiten können direkt auf andere Teile des Trac-Systems verweisen. Um auf Tickets, Berichte, Changesets, Meilensteine, Dateien mit Programmcode und auf andere Wikiseiten zu verweisen, sind die folgenden Schreibweisen verwendbar:
||= Wiki-Formatierung =||= Darstellung =||
{{{#!td
{{{
* Tickets: #1 or ticket:1
* Berichte: {1} or report:1
* Changesets: r1, [1] or changeset:1
* ...
* in Bezug zu anderen Trac-Instanzen,
sogenannten InterTrac-Verweisen:
- Tickets: #Trac1 or Trac:ticket:1
- Changesets: [Trac1] or Trac:changeset:1
}}}
}}}
{{{#!td
* Tickets: #1 or ticket:1
* Berichte: {1} or report:1
* Changesets: r1, [1] or changeset:1
* ...
* in Bezug zu anderen Trac-Instanzen,
sogenannten InterTrac-Verweisen:
- Tickets: #Trac1 or Trac:ticket:1
- Changesets: [Trac1] or Trac:changeset:1
}}}
Es gibt noch viele weitere Varianten von Trac-Verweisen. Die Seite über [TracLinks Trac-Verweise] enthält ausführlichere Informationen und eine Referenz aller Standard-Verweisübersetzer.
== Sprungmarken setzen == #SettingAnchors
Eine Sprungmarke, oder korrekter bezeichnet, ein [http://www.w3.org/TR/REC-html40/struct/links.html#h-12.2.1 Sprungmarkenname] (engl.) kann an jeder Stelle einer Wikiseite definiert werden, um eine Dokumentenposition eindeutig zu bezeichnen:
{{{
[=#Punkt1]
}}}
Dies Schreibweise wurde gewählt, um dem Format für die [#Headings zuvor beschriebene], definierte Benennung der Überschriften-ID zu entsprechen. Zum Beispiel:
{{{
== Lange Überschrift == #title
}}}
Dies ist auch der Schreibweise für einen Verweis auf diese Sprungmarke sehr ähnlich:
{{{
[#Punkt1]
}}}
Wahlweise kann die Sprungmarke mit eine Aufschrift versehen werden:
{{{
[[=#Punkt1 '''Punkt 1''']]
}}}
||= Wiki-Formatierung =||= Darstellung =||
|----------------------------------
{{{#!td
{{{
[#Punkt2 Springe zum zweiten Punkt]
...
Punkt 2: [=#Punkt2] Springe hierhin
}}}
}}}
{{{#!td
[#Punkt2 Springe zum zweiten Punkt]
...
Punkt 2: [=#Punkt2] Springe hierhin
}}}
Für aufwendiger gestaltete Sprungmarken (wenn z.B. ein abweichendes ''title''-HTML-Attribut gewünscht wird) kann das Span-Makro genutzt werden, z.B. `[[span(id=Punkt2, class=wikianchor, title=Punkt 2, ^(2)^)]]`.
== Formatierung auskommentieren == #EscapingLinksandWikiPageNames
Sie können die Erzeugung von Verweisen aus Trac-Verweisen vermeiden, indem Sie einem Ausdruck ein einzelnes "!" (Ausrufezeichen) voranstellen.
||= Wiki-Formatierung =||= Darstellung =||
{{{#!td
{{{
!KeinVerweis
!#42 ist kein Verweis
}}}
{{{
{{{-}}} Minus-Zeichen am Zeilenanfang beginnt keine Liste \\
{{{1.}}} Zahl am Zeilenanfang beginnt keine Liste \\
{{{*}}} Stern am Zeilenanfang beginnt keine Liste
}}}
}}}
{{{#!td
!KeinVerweis
!#42 ist kein Verweis
|-----------------------------------------------------------
{{{-}}} Minus-Zeichen am Zeilenanfang beginnt keine Liste \\
{{{1.}}} Zahl am Zeilenanfang beginnt keine Liste \\
{{{*}}} Stern am Zeilenanfang beginnt keine Liste
}}}
== Bilder == #Images
URLs, die mit `.png`, `.gif` or `.jpg` enden, werden nicht mehr automatisch als Bildverweise interpretiert und zu ``-HTML-Objekten umgewandelt.
Sie müssen nun das ![[Image]]-Makro verwenden. Das Einfügen eines Bildes ist am einfachsten, wenn es als Seitenanhang hochgeladen und der Dateiname in der Form `[[Image(Bild.gif)]]` im Makroaufruf eingetragen wird.
Zusätzlich zur aktuellen Seite kann auch auf andere Speicherorte verwiesen werden:
* `[[Image(wiki:WikiFormatting:Bild.gif)]]` (Verweis auf den Anhang einer anderen Seite)
* `[[Image(ticket:1:Bild.gif)]]` (Dateianhang eines Tickets)
* `[[Image(htdocs:Bild.gif)]]` (Verweis auf eine Datei im `htdocs`-Verzeichnis der [TracEnvironment Projektumgebung])
* `[[Image(source:/trunk/trac/htdocs/trac_logo_mini.png)]]` (eine Datei im Repository)
||= Wiki-Formatierung =||= Darstellung =||
{{{#!td
{{{
[[Image(htdocs:../common/trac_logo_mini.png)]]
}}}
}}}
{{{#!td
[[Image(htdocs:../common/trac_logo_mini.png)]]
}}}
Die Seite WikiMacros enthält weitere Beschreibungen zum `[[Image()]]`-Makro, das einige nützliche Optionen besitzt (`title=`, `link=`, etc.).
== Makros == #Macros
Makros sind ''Zusatzfunktionen'' für das Einfügen veränderlicher Inhalte in eine Seite.
||= Wiki-Formatierung =||= Darstellung =||
{{{#!td
{{{
[[RecentChanges(Trac,3)]]
}}}
}}}
{{{#!td style="padding-left: 2em"
[[RecentChanges(Trac,3)]]
}}}
Weitere Informationen und eine Liste aller installierten Makros finden Sie in WikiMacros.
Auf die ausführliche Hilfe für ein bestimmtes Makro können Sie auch unmittelbar zugreifen, wenn Sie ein "?" an den Makronamen anhängen.
||= Wiki-Formatierung =||= Darstellung =||
{{{#!td
{{{
[[MacroList?]]
}}}
}}}
{{{#!td style="padding-left: 2em"
[[MacroList?]]
}}}
== Prozessoren == #Processors
Trac unterstützt alternative Textbeschreibungsformate mit Hilfe von [WikiProcessors WikiProzessoren]. Beispielsweise werden Prozessoren genutzt, um Seiten in
[wiki:WikiRestructuredText reStructuredText] oder [wiki:WikiHtml HTML] zu beschreiben.
||= Wiki-Formatierung =||= Darstellung =||
|--------------------------------------------------------
{{{#!td align="center" colspan=2 style="border: 0px; font-size: 90%"
[=#Processors-example-html Beispiel 1:] HTML
}}}
|--------------------------------------------------------
{{{#!td style="border: 0px"
{{{
{{{
#!html