DeRedmineTextFormattingMarkdown » History » Revision 8
Revision 7 (C S, 2021-04-16 10:57) → Revision 8/9 (C S, 2023-09-29 12:59)
Übersetzung der "Rev. 32":http://www.redmine.org/projects/redmine/wiki/RedmineTextFormattingMarkdown/32 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 * *[](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. Genauer gesagt müssen Sie Redmine patchen, wie in „diesem Beitrag“:https://www.redmine.org/boards/2/topics/56096?r=57052#message-57052 erklärt. 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 * ** Zeigt ein Bild an, das sich unter @image_url@ befindet (Textile Syntax) * ** Zeigt ein Bild mit einem @Alt/Titel@-Attribut an * *[](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: ** 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. 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. Ü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. 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. 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. Aufgabenlisten Sie können mit _common_mark_ Formatierer Aufgabenlisten erstellen: <pre> * [ ] Aufgabentitel </pre> Um die Elemente zu überprüfen, müssen Sie zunächst die Bearbeitungsfunktion verwenden. Wir werden versuchen, dies in naher Zukunft durch Klicken auf das Kontrollkästchen zu ermöglichen. 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>