Project

General

Profile

DeRedmineTextFormattingTextile » History » Revision 14

Revision 13 (C S, 2021-04-15 09:37) → Revision 14/15 (C S, 2021-04-15 15:34)

Ü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 "Mein Problem ist ":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 

 * *&#33;image_url&#33;* Zeigt ein Bild an, das sich unter @image_url@ befindet (Textile Syntax) 
 * *&#33;>image_url&#33;* Rechts schwebendes Bild 
 * *&#33;image_url(Bildtitel)&#33;* Zeigt ein Bild mit einem @Alt/Titel@-Attribut an 
 * *&#33;image_url&#33;: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: *&#33;attached_image.png&#33;* 

 Sie können dem Bild auch einen CSS-Stil auf die gleiche Weise zuweisen wie @SPAN@-Elementen. Mit dem Code *&#33;{width: 100%}attached_image.png&#33;* 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