Redmine

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

{{>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>

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