Redmine

Übersetzung der "Rev. 27":http://www.redmine.org/projects/redmine/wiki/RedmineTextFormattingMarkdown/27

h1. Markdown Formatierung

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

Derzeit sind HTML-Tags standardmäßig nicht zulässig. Siehe #15520 und #20497 für Details. Weitere Einschränkungen der aktuellen *Markdown*-Formatierung finden Sie unter #16373 und #21443.

{{>TOC}}

h2. Verweise (Links)

h3. Redmine interne Verweise

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

* *[![Redmine Webseite](http://www.redmine.org/attachments/7069/Redmine_logo.png)](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 web site)!:http://www.redmine.org

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 jemand](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 "Markdown-Syntax":http://de.wikipedia.org/wiki/Markdown. Informationen zur Verwendung dieser Funktionen finden Sie unter http://daringfireball.net/projects/markdown/syntax, http://agea.github.io/tutorial.md/, http://stackoverflow.com/editing-help. Einige Beispiele sind unten aufgeführt, aber das System kann noch viel mehr. Für Konvertierungen siehe "Pandoc":http://pandoc.org. Der "Redcarpet-Formatierer":https://github.com/alminium/redmine_redcarpet_formatter wird verwendet.

h3. Akronym

Wird von Markdown nicht unterstützt

h3. Schriftart

<pre><code>* **fett** __fett__

* *kursiv* _kursiv_

* ***fett kursiv*** ___fett kursiv___

* <ins>unterstrichen</ins>

* <del>durchgestrichen</del>

* Plain <sup>hochgestellt</sup>

* Plain <sub>tiefgestellt</sub>

* `Schriftart monospace`

* normal **fett** _kursiv_ normal;E=mc<sup>2</sup>

* normal<strong>fett</strong><em>kursiv</em>normal;E=mc<sup>2</sup>

* Escaping: \*\*fett\*\* \_kursiv\_ \`inlinemono\`

* <notextile><pre>**Einige Linien**      Ein [Link](http://www.redmine.org)</pre></notextile>

* <notextile><pre>\*\*Einige 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> 

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

 * <pre>**Einige Linien**      Ein [Link](http://www.redmine.org)</pre>

**Hinweis:** HTML-Tags müssen die HTML-Tags verwenden dürfen (<strong>, <em>, <ins>, <del>, <sup>, <sub>). Siehe #15520-16 und #15520-17 für Details.

h3. Color

<pre><code><notextile>* <span style="color:red">Rot</span> <span style="color:green">Grün</span> <span style="color:yellow">Gelb</span> <span style="color:#82B6E1">bläulich</span>

* <span style="color:red">Rot</span><span style="color:green">Grün</span><span style="color:yellow">Gelb</span><span style="color:#82B6E1">bläulich</span>

* <span style="background-color:lightgreen">Hellgrüner Hintergrund</span> <span style="background-color:yellow">Gelber Hintergrund</span>

* <span style="background-color:lightgreen">Hellgrüner Hintergrund</span><span style="background-color:yellow">Gelber Hintergrund</span>

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

displays:

 * %{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ünder Hintergrund% %{background:yellow}Gelber Hintergrund%

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

**Hinweis:** HTML-Tags müssen das HTML-Tag (<span>) verwenden dürfen. Siehe #15520-16 und #15520-17 für Details.

Genauer gesagt müssen Sie redmine patchen, wie in diesem "Beitrag":https://www.redmine.org/boards/2/topics/56096?r=57052#message-57052 erläutert.

h3. Eingebettete Bilder

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

* *![alt text](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)*

Zum jetzigen Zeitpunkt hat Markdown keine Syntax zum Festlegen der Abmessungen eines Bildes. Wenn dies für Sie wichtig ist, können Sie reguläre HTML-Tags <img> verwenden.

* <img style="float:right" src="URL"/>

* <img style="width:100%" src="attached_image.png"/>

**Hinweis:** HTML-Tags müssen das HTML-Tag (<img>) verwenden dürfen. Siehe #15520-16 und #15520-17 für Details.

h3. Überschriften

<pre><code># Hauptüberschrift

## Sekundäre Überschrift

### Tertiäre Überschrift

oder 

Hauptüberschrift

================

Sekundä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

Markdown unterstützt nicht die Ausrichtung eines Absatzes. Verwenden Sie bei Bedarf <div> -Tags.

<pre><code>Links ausgerichtet

<div style="padding-left:1em;">

left ident 1em

</div>

<div style="padding-left:2em;">

Linker Einzug 2em

sowie für folgende Zeilen

</div>

<div style="text-align:right;">

Rechts ausgerichtet

</div>

<div style="padding-right:3em;text-align:right;">

Rechter Einzug 3em

</div>

<div style="text-align:center;">

Dies ist ein zentrierter Absatz.

</div></code></pre>

Anzeige:

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.

**Hinweis:** HTML-Tags müssen das HTML-Tag (<div>) verwenden dürfen. Siehe #15520-16 und #15520-17 für Details.

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

Sie können @>@ 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 (Einrückung mit zwei Leerzeichen)

  * 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 (Einrückung mit zwei Leerzeichen)

  # Punkt 3.2

</pre>

Anzeige:

# Punkt 1

# Punkt 2

# Punkt 3

## Punkt 3.1

## Punkt 3.2

Beachten Sie, dass die tatsächlichen Zahlen, die Sie zum Markieren der Liste verwenden, keinen Einfluss auf die Ausgabe haben.

h3. Tabellen

<pre>

|BenutzerID (rechts ausgerichtet)|Name (Links ausgerichtet)|Gruppe (zentriert)|

|-------------------:|:----------------|:------------------:|

|2                   |John Smith       |                    |

|3                   |Dave Lopper      |A Team              |

|4                   |Robert Hill      |B Team              |

</pre>

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

|_>. BenutzerID (rechts ausgerichtet|_<. Name (links ausgerichtet|_=. Group (zentriert)|

|>. 2                    |<. John Smith        |                        |

|>. 3                    |<. Dave Lopper       |=. A Team              |

|>. 4                    |<. Robert Hill       |=. B Team              |

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ßnote

Eine Fußnote funktioniert sehr ähnlich wie ein Link im Referenzstil: Sie besteht aus einer Markierung neben dem Text, z. <pre>Dies ist ein Satz.[^1]</pre> und einer Fußnotendefinition in einer separaten Zeile an einer beliebigen Stelle im Dokument, z. <pre>[^1]:Dies ist eine Fußnote.</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>``` ruby

Geben Sie hier Ihren Code ein.

```</code></pre>

Example:

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