basiert auf [/wiki/WikiFormatting?version=108 Version 108] von [/wiki/WikiFormatting WikiFormatting], in weiteren Sprachen verfügbar: [TranslationRu/WikiFormatting Russisch] = [WikiFormatting Wiki-Formatierung] = [[TracGuideToc]] 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

HTML-Test

}}} }}} }}} {{{#!td valign="top" style="border: 0px" {{{ #!html

HTML-Test

}}} }}} |-------------------------------------------------------- {{{#!td align="center" colspan=2 style="border: 0px; font-size: 90%" [=#Processors-example-highlight Beispiel 2:] Programmcode-Hervorhebungen }}} |-------------------------------------------------------- {{{#!td style="border: 0px" {{{ {{{ #!python class Test: def __init__(self): print "Hallo Welt" if __name__ == '__main__': Test() }}} }}} }}} {{{ #!td valign="top" style="border: 0px" {{{ #!python class Test: def __init__(self): print "Hallo Welt" if __name__ == '__main__': Test() }}} }}} |-------------------------------------------------------- {{{#!td align="center" colspan=2 style="border: 0px; font-size: 90%" [=#Processors-example-tables Beispiel 3:] Komplex aufgebaute Tabellen }}} |-------------------------------------------------------- {{{#!td style="border: 0px" {{{ {{{#!th rowspan=4 align=justify Bei den `#td`- und `#th`-Prozessoren dürfen Tabellenzellen beliebigen Inhalt haben: }}} |---------------- {{{#!td - Listen - eingebettete Tabellen - einfache mehrzeilige Inhalte }}} |---------------- {{{#!td So wie Prozessoren verschachtelt werden können, können dies auch Tabellen: {{{#!th Beispiel: }}} {{{#!td style="background: #eef" || muss nun die dritte Ebene erreicht haben ... || }}} }}} |---------------- {{{#!td Selbst wenn Sie keine aufwendige Beschreibung haben, kann diese Form von Tabellenzellen angenehm sein, um mehrzeilige Inhalte zu notieren. }}} }}} }}} {{{ #!td valign="top" style="border: 0px" {{{#!th rowspan=4 align=justify Bei den `#td`- und `#th`-Prozessoren dürfen Tabellenzellen beliebigen Inhalt haben: }}} |---------------- {{{#!td - Listen - eingebettete Tabellen - einfache mehrzeilige Inhalte }}} |---------------- {{{#!td So wie Prozessoren verschachtelt werden können, können dies auch Tabellen: {{{#!th Beispiel: }}} {{{#!td style="background: #eef" || muss nun die dritte Ebene erreicht haben ... || }}} }}} |---------------- {{{#!td Selbst wenn Sie keine aufwendige Beschreibung haben, kann diese Form von Tabellenzellen angenehm sein, um mehrzeilige Inhalte zu notieren. }}} }}} Für weitere Informationen beachten Sie die Seite WikiProcessors. == Kommentare == #Comments Zum einfachen Text können Kommentare hinzugefügt werden. Diese werden nicht dargestellt und in keinem anderen Format als im Beschreibungstext selbst angezeigt. ||= Wiki-Formatierung =||= Darstellung =|| {{{#!td {{{ Nichts {{{ #!comment Ihre Anmerkungen für Bearbeiter an dieser Stelle }}} zu sehen ;-) }}} }}} {{{#!td Nichts {{{ #!comment Ihre Anmerkungen für Bearbeiter an dieser Stelle }}} zu sehen ;-) }}} == Verschiedenes == #Miscellaneous Zum Trennen verschiedener Teile Ihrer Seite kann eine horizontale Linie genutzt werden: ||= Wiki-Formatierung =||= Darstellung =|| {{{#!td {{{ Vier oder mehr Bindestriche werden durch eine horizontale Linie ersetzt (
) ---- Sehen Sie? }}} }}} {{{#!td Vier oder mehr Bindestriche werden durch eine horizontale Linie ersetzt (
) ---- Sehen Sie? }}} |---------------------------------- {{{#!td {{{ makro-artiger [[br]] Zeilenumbruch }}} }}} {{{#!td makro-artiger [[br]] Zeilenumbruch }}} |---------------------------------- {{{#!td {{{ Zeilenumbruch\\im \\ !WikiCreole-Stil }}} }}} {{{#!td Zeilenumbruch\\im \\ !WikiCreole-Stil }}}