DeRedmineTextFormattingTextile » History » Revision 13
Revision 12 (C S, 2021-04-15 09:37) → Revision 13/15 (C S, 2021-04-15 09:37)
Ü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: "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> Alternative HTML-Codes: *fett* _kursiv_ @inlinemono@</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> Alternative HTML-Codes: *fett* _kursiv_ @inlinemono@
* <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