Redmine

Übersetzung der "Rev. 14":http://www.redmine.org/projects/redmine/wiki/RedmineTextFormattingTextile/14

{{>TOC}}

h1. Textile Formatierung

Unten wird die *Textile* Formatierung beschrieben. Informationen zur *Markdown* -Formatierung finden Sie unter [[DeRedmineTextFormattingMarkdown|Markdown Formatierung]].

Einschränkungen der aktuellen Textilunterstützung finden Sie unter #6269, #10078 (Definitionslisten).

h2. Verweise (Links)

h3. Redmine interne Verweise

[[DeRedmineTextFormattingRedmineLinks]]

{{include(DeRedmineTextFormattingRedmineLinks)}}

h3. Externe Verweise

URLs (http, https, ftp and ftps) werden automatisch in anklickbare Links umgewandelt:

* *http://www.redmine.org* -- Externer Link zur Redmine Webseite: http://www.redmine.org

URLs können auch anderen Text als den Link selbst verwenden:

* *"Redmine Webseite":http://www.redmine.org* -- Externer Link mit anderem Text: "Redmine Webseite":http://www.redmine.org

* *!http://www.redmine.org/attachments/7069/Redmine_logo.png(Redmine web site)!:http://www.redmine.org* -- Externes Bild mit einem Titel, der auf eine URL verweist: 

p=. !http://www.redmine.org/attachments/7069/Redmine_logo.png(Redmine Webseite)!:http://www.redmine.org

Der Datei-URI kann zum Verknüpfen des UNC-Pfads verwendet werden:

* *"\\server\share$":file://///server/share%24* -- Datei-URI mit UNC-Pfad: "\\server\share$":file://///server/share%24

Sie sollten "URL kodierte":http://www.w3schools.com/tags/ref_urlencode.asp Angaben für Sonderzeichen wie Leertaste, $, ä, ü, ö, ß, etc. benutzen.

h3. E-Mail Adressen

E-Mail Adressen werden automatisch in anklickbare Links umgewandelt:

* *jemand@foo.bar* -- Link zu einer Email Addresse: jemand@foo.bar

* *"Email":mailto:jemand@foo.bar* -- Email link mit anderem Text: "Email":mailto:jemand@foo.bar

Komplexere E-Mail-Anweisungen können zu einem E-Mail-Link hinzugefügt werden. Ein Standardthema, ein Standardtext und CC-Informationen können definiert werden. Beachten Sie, dass Leerzeichen in einem dieser Felder durch den Code %20 ersetzt werden müssen.

* *"Email an Webmaster und Admin":mailto:webmaster@foo.bar?cc=admin@foo.bar* -- Email an den Webmaster und als CC an den Admin:  "Email an Webmaster und Admin":mailto:webmaster@foo.bar?cc=admin@foo.bar

* *"Email an Support für Hilfe":mailto:support@foo.bar?subject=Webseiten%20Hilfe* -- Email Link mit dem Titel "Webseiten Hilfe": "Email an Support für Hilfe":mailto:support@foo.bar?subject=Webseiten%20Hilfe

* *"Email an Support für Hilfe":mailto:support@foo.bar?subject=Webseiten%20Hilfe&body=Mein%20Problem%20ist%20* -- Email Link mit dem Titel "Webseiten Hilfe" und Standardtext im Nachrichtenbereich: "Email an Support für Hilfe":mailto:support@foo.bar?subject=Webseiten%20Hilfe&body=Mein%20Problem%20ist%20

h2. Textformatierung

Für Überschriften, Fettdruck, Tabellen, Listen unterstützt Redmine den "Textile Syntax":https://de.wikipedia.org/wiki/Textile. Weitere Informationen zur Verwendung dieser Funktionen finden Sie auch unter http://redcloth.org/hobix.com/textile/. Einige Beispiele sind unten aufgeführt, aber das System kann noch viel mehr.

h3. Akronym

<pre>

JPL(Jean-Philippe Lang)

</pre>

Darstellung:

JPL(Jean-Philippe Lang)

h3. Schriftart

<pre><code>* *fett*

* _kursiv_

* *_fett kursiv_*

* +unterstrichen+

* -durchgestrichen-

* Normal ^hochgestellt^

* Normal ~tiefgestellt~

* @Schriftart Monospace@

* <notextile>Normal *fett* _kursiv_ normal;E=mc ^2^</notextile>

* <notextile>Normal<notextile></notextile>*fett*<notextile></notextile>_kursiv_<notextile></notextile>normal;E=mc<notextile></notextile>^2^</notextile>

* <notextile>Escaping: <notextile>*fett* _kursiv_ @inlinemono@</notextile> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Alternative HTML-Codes: &#42;fett&#42; &#95;kursiv&#95; &#64;inlinemono&#64;</notextile>

* <notextile><pre>*Mehrere Linien*      ein "Link":http://www.redmine.org</pre></notextile>

* <notextile><pre><notextile></notextile>*Mehrere Linien*      Ein "Link":http://www.redmine.org</pre></notextile>

</code></pre>

Darstellung:

 * *fett*

 * _kursiv_

 * *_fett kursiv_*

 * +unterstrichen+

 * -durchgestrichen-

 * Normal ^hochgestellt^

 * Normal ~tiefgestellt~

 * @Schriftart Monospace@

 * Normal *fett* _kursiv_ normal;E=mc ^2^

 * Normal<notextile></notextile>*fett*<notextile></notextile>_kursiv_<notextile></notextile>normal;E=mc<notextile></notextile>^2^

 * Escaping: <notextile>*fett* _kursiv_ @inlinemono@</notextile> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Alternative HTML-Codes: &#42;fett&#42; &#95;kursiv&#95; &#64;inlinemono&#64;

 * <pre>*Mehrere Linien*      Ein "Link":http://www.redmine.org</pre>

 * <pre><notextile></notextile>*Mehrere Linien*      Ein "Link":http://www.redmine.org</pre>

h3. Farben

<pre><code><notextile>* %{color:red}Rot% %{color:green}Grün% %{color:yellow}Gelb% %{color:#82B6E1}Bläulich%

* %{color:red}Rot%<notextile></notextile>%{color:green}Grün%<notextile></notextile>%{color:yellow}Gelb%<notextile></notextile>%{color:#82B6E1}Bläulich%

* %{background:lightgreen}Hellgrüner Hintergrund% %{background:yellow}Gelber Hintergrund%

* %{background:lightgreen}Hellgrüner Hintergrund%<notextile></notextile>%{background:yellow}Gelber Hintergrund%

</notextile></code></pre>

Anzeige:

 * %{color:red}Rot% %{color:green}green% %{color:yellow}Gelb% %{color:#82B6E1}Bläulich%

 * %{color:red}Rot%<notextile></notextile>%{color:green}Grün%<notextile></notextile>%{color:yellow}Gelb%<notextile></notextile>%{color:#82B6E1}Bläulich%

 * %{background:lightgreen}Hellgrüner Hintergrund% %{background:yellow}Gelber Hintergrund%

 * %{background:lightgreen}Hellgrüner Hintergrund%<notextile></notextile>%{background:yellow}Gelber Hintergrund%

h3. Eingebettete Bilder

* *!image_url!* Zeigt ein Bild an, das sich unter @image_url@ befindet (Textile Syntax)

* *!>image_url!* Rechts schwebendes Bild

* *!image_url(Bildtitel)!* Zeigt ein Bild mit einem @Alt/Titel@-Attribut an

* *!image_url!:URL* Zeigt ein Bild von @image_url@ mit hinzugefügter Link-URL an

Wenn Sie ein Bild an Ihre Wiki-Seite angehängt haben, kann es unter Verwendung des Dateinamens im Inhalt angezeigt werden: *!attached_image.png!*

Sie können dem Bild auch einen CSS-Stil auf die gleiche Weise zuweisen wie @SPAN@-Elementen. Mit dem Code *!{width: 100%}attached_image.png!* wird das Bild an die Breite des übergeordneten Elements angepasst.

h3. Überschriften

<pre><code>h1. Hauptüberschrift

h2. Sekundäre Überschrift

h3. Tertiäre Überschrift

</code></pre>

Redmine weist jeder dieser Überschriften einen Anker zu, sodass Sie sie mit @"#Hauptüberschrift", "#Sekundäre Überschrift"@ usw. verknüpfen können.

h3. Absätze

<pre><code>p. links ausgerichtet

p(. Linker Einzug 1em

p((. Linker Einzug 2em

sowie für folgende Zeilen

p>. rechts ausgerichtet

p)))>. Rechter Einzug 3em

p=. Dies ist ein zentrierter Absatz.

</code></pre>

Anzeige:

p(. Linker Einzug 1em

p((. Linker Einzug 2em

sowie für folgende Zeilen

p>. rechts ausgerichtet

p)))>. Rechter Einzug 3em

p=. Dies ist ein zentrierter Absatz.

h3. Horizontale Linie

@----@

Anzeige:

----

h3. Vorformatierter Text

<pre> <pre>*Dieser Text wird nicht fett angezeigt*</pre> </pre>

Anzeige:

<pre> *Dieser Text wird nicht fett angezeigt* </pre>

h3. Block Zitate

Absatzbeginn mit *bq.*:

<pre><code>bq. Rails ist ein Full-Stack-Framework für die Entwicklung datenbankgestützter Webanwendungen nach dem Model-View-Control-Muster.

Um live zu gehen, müssen Sie lediglich eine Datenbank und einen Webserver hinzufügen.

</code></pre>

Anzeige:

bq. Rails ist ein Full-Stack-Framework für die Entwicklung datenbankgestützter Webanwendungen nach dem Model-View-Control-Muster.

Um live zu gehen, müssen Sie lediglich eine Datenbank und einen Webserver hinzufügen.

Sie können auch > am Anfang jeder Zeile verwenden und sie für verschachtelte Anführungszeichen stapeln:

<pre>

>>Rails ist ein Full-Stack-Framework für die Entwicklung datenbankgestützter Webanwendungen nach dem Model-View-Control-Muster.

>>Um live zu gehen, müssen Sie lediglich eine Datenbank und einen Webserver hinzufügen.

>Super!

</pre>

Anzeige:

>>Rails ist ein Full-Stack-Framework für die Entwicklung datenbankgestützter Webanwendungen nach dem Model-View-Control-Muster.

>>Um live zu gehen, müssen Sie lediglich eine Datenbank und einen Webserver hinzufügen.

>Super!

h3. Ungeordnete Listen

<pre>

* Punkt 1

* Punkt 2

** Punkt 21

** Punkt 22

* Punkt 3

</pre>

Anzeige:

* Punkt 1

* Punkt 2

** Punkt 21

** Punkt 22

* Punkt 3

h3. Geordnete Listen

<pre>

# Punkt 1

# Punkt 2

# Punkt 3

## Punkt 3.1

## Punkt 3.2

</pre>

Anzeige:

# Punkt 1

# Punkt 2

# Punkt 3

## Punkt 3.1

## Punkt 3.2

h3. Tabellen

<pre>

|_.ID      |_.Name          |_.Gruppe     |_. Attributen Liste   |

|Start mit  | einer              |   simplen   |Reihe                 |

|\3=.IT                                      |<. Ausrichtung links       |

|1             |Artur Pirozhkov |/2.Benutzer    |>. Ausrichtung rechts      |

|2             |Vasya Rogov     |=. zentriert   |

|3             |John Smith      |Admin

                                 (root)      |^. Ausrichtung oben       |

|4             |-               |Nobody

                                 (anonymous) |~. Ausrichtung unten    |

</pre>

Anzeige(Alle multiplen Leerzeichen werden durch 1 Leerzeichen ersetzt):

|_.ID      |_.Name          |_.Gruppe     |_. Attributen Liste   |

|Start mit  | einer              |   simplen   |Reihe                 |

|\3=.IT                                      |<. Ausrichtung links       |

|1             |Artur Pirozhkov |/2.Benutzer    |>. Ausrichtung rechts      |

|2             |Vasya Rogov     |=. zentriert   |

|3             |John Smith      |Admin

                                 (root)      |^. Ausrichtung oben       |

|4             |-               |Niemand

                                 (anonymous) |~. Ausrichtung unten    |

Wenn Sie Pipe-Zeichen in Ihre Tabelle aufnehmen möchten (z. B. für Wiki-Links), müssen Sie verhindern, dass *Textile* diese interpretiert:

|_.Eingabe |_. Ausgabe|

|*<notextile><notextile>|</notextile></notextile>*|<notextile>|</notextile>|

Wenn Sie die Breite der Tabelle angeben möchten, müssen Sie *table{width: 100%}.* unmittelbar vor Ihrer Tabellendefinition einfügen:

<pre>

table{width:100%}.

| Diese Tabelle nutzt

die komplette horizontale Breite |

</pre>

Auf diese Weise erstreckt sich die Tabelle über die gesamte Seitenbreite ...

table{width:100%}.

| Diese Tabelle nutzt

die komplette horizontale Breite |

... verglichen mit der Standardbreite:

| Diese Tabelle nutzt nur

die benötigte horizontale Breite |

h3. Inhaltsverzeichnis

<pre><code>{{toc}} => Links ausgerichtetes Inhaltsverzeichnis

{{>toc}} => Rechts ausgerichtetes Inhaltsverzeichnis

</code></pre>

Bitte beachten Sie, dass das @toc@-Tag eine leere Zeile darüber und darunter und keinen anderen Text davor und danach benötigt.

Beispiel:

<pre><code>

h1. Seitenüberschrift

h2. Ein Thema

{{toc}}

h2. Ein weiteres Thema

</code></pre>

h3. Fußnoten

Lesezeichen:

<pre>

Dies ist das erste Wort[1] mit einer Fußnote.

Dies ist das zweite Wort[2] mit einer Fußnote.

</pre>

*Hinweis:* Lesezeichen müssen direkt an das Wort angesetzt werden(kein Leerzeichen, Punkt oder sonstiges dazwischen).

Definition:

<pre>

fn1. Fußnote für das erste Wort

fn2. Fußnote für das zweite Wort

</pre>

*Hinweis:* Jede Definition benötigt eine eigene Zeile an beliebiger Stelle im Dokument. Leerzeilen zwischen Definitionen sind erforderlich.

Anzeige:

Dies ist das erste Wort[1] mit einer Fußnote.

Dies ist das zweite Wort[2] mit einer Fußnote.

fn1. Fußnote für das erste Wort

fn2. Fußnote für das zweite Wort

h2. Makros

Redmine enthält ein Makrosystem, mit dem Sie benutzerdefinierte Funktionen hinzufügen können, um dynamischen Inhalt in formatierten Text einzufügen. Sie können lernen, wie Sie Ihre eigenen Makros in [[DeRedmineMacros|Redmine Makros]] schreiben. Redmine enthält auch einige integrierte Makros:

{{macro_list}}

h2. Code-Hervorhebung

Die Standardcode-Hervorhebung basiert auf "Rouge": http: //rouge.jneen.net/, einer in reinem Ruby geschriebenen Syntax-Hervorhebungsbibliothek. Es unterstützt viele häufig verwendete Sprachen wie *c*, *cpp* (c++), *csharp* (c#, cs), *css*, *diff* (patch, udiff), *go* (golang), *groovy*, *html*, *java*, *javascript* (js), *kotlin*, *objective_c* (objc), *perl* (pl), *php*, *python* (py), *r*, *ruby* (rb), *sass*, *scala*, *shell* (bash, zsh, ksh, sh), *sql*, *swift*, *xml* and *yaml* (yml) , wobei die Namen in Klammern die Aliase sind. Die vollständige Liste der unterstützten Sprachen finden Sie unter [[RedmineCodeHighlightingLanguages]].

Mit dieser Syntax können Sie Code in Ihrer Wiki-Seite hervorheben:

<pre><code><pre><code class="ruby">

   Geben Sie hier Ihren Code ein.

</code></pre>

</code></pre>

Beispiel:

<pre><code class="ruby">

# Die große Klasse

class Greeter

  def initialize(name)

    @name = name.capitalize

  end

  def salute

    puts "Hallo #{@name}!"

  end

end

</code></pre>

h2. Text mit CSS gestalten

Textile kann Text mit CSS formatieren. Beispiele wie folgt:

<pre>Drei Grundfarben des Lichts sind %{color: #f00}rot%, %{color: #0f0}grün% und %{color: #00f}blau%.

p{border: solid 1px #000; padding: 0.5em;}. Der schnelle, braune Fuchs springt über den faulen Hund.

table{width: 100%}.

|={width: 30%; background-color: #aaf;}. column 1 |={width: 70%}. column 2 |

</pre>

Anzeige: 

Die drei Grundfarben des Lichts sind %{color: #f00}rot%, %{color: #0f0}grün% und %{color: #00f}blau%.

p{border: solid 1px #000; padding: 0.5em;}. Der schnelle, braune Fuchs springt über den faulen Hund.

table{width: 100%}.

|={width: 30%; background-color: #aaf;}. column 1 |={width: 70%}. column 2 |

h3. Zulässige CSS-Eigenschaften

Redmine erlaubt die folgenden Eigenschaften. Andere Eigenschaften sind aus Sicherheitsgründen nicht zulässig (siehe r2192).

* background

* background-*

* border

* border-*

* color

* float

* font

* font-*

* height

* margin

* margin-*

* max-height

* max-width

* min-height

* min-width

* padding

* padding-*

* text

* text-*

* width