DeRedmineTextFormattingMarkdown » History » Version 6
C S, 2021-04-16 10:56
Fertigstellung der ersten Fassung
1 | 1 | C S | Übersetzung der "Rev. 27":http://www.redmine.org/projects/redmine/wiki/RedmineTextFormattingMarkdown/27 |
---|---|---|---|
2 | |||
3 | 3 | C S | *UNVOLLSTÄNDIG!* |
4 | |||
5 | 1 | C S | h1. Markdown Formatierung |
6 | |||
7 | Unten wird die *Markdown* Formatierung beschrieben. Informationen zur *Textile*-Formatierung finden Sie unter [[DeRedmineTextFormattingTextile|Textile Formatierung]]. |
||
8 | 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. |
||
9 | |||
10 | {{>TOC}} |
||
11 | |||
12 | h2. Verweise (Links) |
||
13 | |||
14 | h3. Redmine interne Verweise |
||
15 | |||
16 | 2 | C S | {{include(DeRedmineTextFormattingRedmineLinks)}} |
17 | 3 | C S | |
18 | h3. Externe Verweise |
||
19 | |||
20 | URLs (http, https, ftp and ftps) werden automatisch in anklickbare Links umgewandelt: |
||
21 | * *http://www.redmine.org* -- Externer Link zur Redmine Webseite: http://www.redmine.org |
||
22 | |||
23 | URLs können auch anderen Text als den Link selbst verwenden: |
||
24 | |||
25 | * *[Redmine Webseite](http://www.redmine.org)* -- Externer Link mit anderem Text: "Redmine Webseite":http://www.redmine.org |
||
26 | * *[![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: |
||
27 | |||
28 | p=. !http://www.redmine.org/attachments/7069/Redmine_logo.png(Redmine web site)!:http://www.redmine.org |
||
29 | |||
30 | h3. E-Mail Adressen |
||
31 | |||
32 | E-Mail Adressen werden automatisch in anklickbare Links umgewandelt: |
||
33 | |||
34 | * *jemand@foo.bar* -- Link zu einer Email Addresse: jemand@foo.bar |
||
35 | * *[Email jemand](mailto:jemand@foo.bar)* -- Email link mit anderem Text: "Email":mailto:jemand@foo.bar |
||
36 | |||
37 | 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. |
||
38 | |||
39 | * *[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 |
||
40 | * *[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 |
||
41 | 4 | C S | * *[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 |
42 | 5 | C S | |
43 | h2. Textformatierung |
||
44 | |||
45 | 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. |
||
46 | |||
47 | h3. Akronym |
||
48 | |||
49 | Wird von Markdown nicht unterstützt |
||
50 | |||
51 | h3. Schriftart |
||
52 | |||
53 | <pre><code>* **fett** __fett__ |
||
54 | * *kursiv* _kursiv_ |
||
55 | * ***fett kursiv*** ___fett kursiv___ |
||
56 | * <ins>unterstrichen</ins> |
||
57 | * <del>durchgestrichen</del> |
||
58 | * Plain <sup>hochgestellt</sup> |
||
59 | * Plain <sub>tiefgestellt</sub> |
||
60 | * `Schriftart monospace` |
||
61 | * normal **fett** _kursiv_ normal;E=mc<sup>2</sup> |
||
62 | * normal<strong>fett</strong><em>kursiv</em>normal;E=mc<sup>2</sup> |
||
63 | * Escaping: \*\*fett\*\* \_kursiv\_ \`inlinemono\` |
||
64 | * <notextile><pre>**Einige Linien** Ein [Link](http://www.redmine.org)</pre></notextile> |
||
65 | * <notextile><pre>\*\*Einige Linien\*\* Ein \[Link](http\://www\.redmine\.org)</pre></notextile> |
||
66 | </code></pre> |
||
67 | |||
68 | Darstellung: |
||
69 | |||
70 | * *fett* |
||
71 | * _kursiv_ |
||
72 | * *_fett kursiv_* |
||
73 | * +unterstrichen+ |
||
74 | * -durchgestrichen- |
||
75 | * Normal ^hochgestellt^ |
||
76 | * Normal ~tiefgestellt~ |
||
77 | * @Schriftart Monospace@ |
||
78 | * Normal *fett* _kursiv_ normal;E=mc ^2^ |
||
79 | * Normal<notextile></notextile>*fett*<notextile></notextile>_kursiv_<notextile></notextile>normal;E=mc<notextile></notextile>^2^ |
||
80 | * Escaping: <notextile>**fett** _kursiv_ `inlinemono`</notextile> |
||
81 | * <pre><notextile></notextile>*Einige Linien* Ein "Link":http://www.redmine.org</pre> |
||
82 | * <pre>**Einige Linien** Ein [Link](http://www.redmine.org)</pre> |
||
83 | |||
84 | **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. |
||
85 | 6 | C S | |
86 | h3. Color |
||
87 | |||
88 | <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> |
||
89 | * <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> |
||
90 | * <span style="background-color:lightgreen">Hellgrüner Hintergrund</span> <span style="background-color:yellow">Gelber Hintergrund</span> |
||
91 | * <span style="background-color:lightgreen">Hellgrüner Hintergrund</span><span style="background-color:yellow">Gelber Hintergrund</span> |
||
92 | </notextile></code></pre> |
||
93 | |||
94 | displays: |
||
95 | |||
96 | * %{color:red}Rot% %{color:green}Grün% %{color:yellow}Gelb% %{color:#82B6E1}Bläulich% |
||
97 | * %{color:red}Rot%<notextile></notextile>%{color:green}Grün%<notextile></notextile>%{color:yellow}Gelb%<notextile></notextile>%{color:#82B6E1}Bläulich% |
||
98 | * %{background:lightgreen}Hellgründer Hintergrund% %{background:yellow}Gelber Hintergrund% |
||
99 | * %{background:lightgreen}Hellgrüner Hintergrund%<notextile></notextile>%{background:yellow}Gelber Hintergrund% |
||
100 | |||
101 | **Hinweis:** HTML-Tags müssen das HTML-Tag (<span>) verwenden dürfen. Siehe #15520-16 und #15520-17 für Details. |
||
102 | 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. |
||
103 | |||
104 | h3. Eingebettete Bilder |
||
105 | |||
106 | * *![](image_url)* Zeigt ein Bild an, das sich unter @image_url@ befindet (Textile Syntax) |
||
107 | * *![alt text](image_url "Bildtitel")* Zeigt ein Bild mit einem @Alt/Titel@-Attribut an |
||
108 | * *[![](image_url)](URL)* Zeigt ein Bild von @image_url@ mit hinzugefügter Link-URL an |
||
109 | |||
110 | Wenn Sie ein Bild an Ihre Wiki-Seite angehängt haben, kann es unter Verwendung des Dateinamens im Inhalt angezeigt werden: *![](attached_image.png)* |
||
111 | |||
112 | 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. |
||
113 | |||
114 | * <img style="float:right" src="URL"/> |
||
115 | * <img style="width:100%" src="attached_image.png"/> |
||
116 | |||
117 | **Hinweis:** HTML-Tags müssen das HTML-Tag (<img>) verwenden dürfen. Siehe #15520-16 und #15520-17 für Details. |
||
118 | |||
119 | h3. Überschriften |
||
120 | |||
121 | <pre><code># Hauptüberschrift |
||
122 | |||
123 | ## Sekundäre Überschrift |
||
124 | |||
125 | ### Tertiäre Überschrift |
||
126 | |||
127 | oder |
||
128 | |||
129 | Hauptüberschrift |
||
130 | ================ |
||
131 | |||
132 | Sekundäre Überschrift |
||
133 | --------------------- |
||
134 | </code></pre> |
||
135 | |||
136 | Redmine weist jeder dieser Überschriften einen Anker zu, sodass Sie sie mit @"#Hauptüberschrift", "#Sekundäre Überschrift"@ usw. verknüpfen können. |
||
137 | |||
138 | h3. Absätze |
||
139 | |||
140 | Markdown unterstützt nicht die Ausrichtung eines Absatzes. Verwenden Sie bei Bedarf <div> -Tags. |
||
141 | |||
142 | <pre><code>Links ausgerichtet |
||
143 | <div style="padding-left:1em;"> |
||
144 | left ident 1em |
||
145 | </div> |
||
146 | |||
147 | <div style="padding-left:2em;"> |
||
148 | Linker Einzug 2em |
||
149 | sowie für folgende Zeilen |
||
150 | </div> |
||
151 | |||
152 | <div style="text-align:right;"> |
||
153 | Rechts ausgerichtet |
||
154 | </div> |
||
155 | |||
156 | <div style="padding-right:3em;text-align:right;"> |
||
157 | Rechter Einzug 3em |
||
158 | </div> |
||
159 | |||
160 | <div style="text-align:center;"> |
||
161 | Dies ist ein zentrierter Absatz. |
||
162 | </div></code></pre> |
||
163 | |||
164 | Anzeige: |
||
165 | |||
166 | p. Links ausgerichtet |
||
167 | |||
168 | p(. Linker Einzug 1em |
||
169 | |||
170 | p((. Linker Einzug 2em |
||
171 | sowie für folgende Zeilen |
||
172 | |||
173 | p>. rechts ausgerichtet |
||
174 | |||
175 | p)))>. Rechter Einzug 3em |
||
176 | |||
177 | p=. Dies ist ein zentrierter Absatz. |
||
178 | |||
179 | **Hinweis:** HTML-Tags müssen das HTML-Tag (<div>) verwenden dürfen. Siehe #15520-16 und #15520-17 für Details. |
||
180 | |||
181 | h3. Horizontale Linie |
||
182 | |||
183 | @----@ |
||
184 | |||
185 | Anzeige: |
||
186 | |||
187 | ---- |
||
188 | |||
189 | h3. Vorformatierter Text |
||
190 | |||
191 | <pre> <pre>**Dieser Text wird nicht fett angezeigt**</pre> </pre> |
||
192 | |||
193 | Anzeige: |
||
194 | |||
195 | <pre> *Dieser Text wird nicht fett angezeigt* </pre> |
||
196 | |||
197 | h3. Block Zitate |
||
198 | |||
199 | Sie können @>@ am Anfang jeder Zeile verwenden und sie für verschachtelte Anführungszeichen stapeln: |
||
200 | |||
201 | <pre> |
||
202 | >>Rails ist ein Full-Stack-Framework für die Entwicklung datenbankgestützter Webanwendungen nach dem Model-View-Control-Muster. |
||
203 | >>Um live zu gehen, müssen Sie lediglich eine Datenbank und einen Webserver hinzufügen. |
||
204 | >Super! |
||
205 | </pre> |
||
206 | |||
207 | Anzeige: |
||
208 | |||
209 | >>Rails ist ein Full-Stack-Framework für die Entwicklung datenbankgestützter Webanwendungen nach dem Model-View-Control-Muster. |
||
210 | >>Um live zu gehen, müssen Sie lediglich eine Datenbank und einen Webserver hinzufügen. |
||
211 | >Super! |
||
212 | |||
213 | h3. Ungeordnete Listen |
||
214 | |||
215 | <pre> |
||
216 | * Punkt 1 |
||
217 | * Punkt 2 |
||
218 | * Punkt 21 (Einrückung mit zwei Leerzeichen) |
||
219 | * Punkt 22 |
||
220 | * Punkt 3 |
||
221 | </pre> |
||
222 | |||
223 | Anzeige: |
||
224 | |||
225 | * Punkt 1 |
||
226 | * Punkt 2 |
||
227 | ** Punkt 21 |
||
228 | ** Punkt 22 |
||
229 | * Punkt 3 |
||
230 | |||
231 | h3. Geordnete Listen |
||
232 | |||
233 | <pre> |
||
234 | # Punkt 1 |
||
235 | # Punkt 2 |
||
236 | # Punkt 3 |
||
237 | # Punkt 3.1 (Einrückung mit zwei Leerzeichen) |
||
238 | # Punkt 3.2 |
||
239 | </pre> |
||
240 | |||
241 | Anzeige: |
||
242 | |||
243 | # Punkt 1 |
||
244 | # Punkt 2 |
||
245 | # Punkt 3 |
||
246 | ## Punkt 3.1 |
||
247 | ## Punkt 3.2 |
||
248 | |||
249 | Beachten Sie, dass die tatsächlichen Zahlen, die Sie zum Markieren der Liste verwenden, keinen Einfluss auf die Ausgabe haben. |
||
250 | |||
251 | h3. Tabellen |
||
252 | |||
253 | <pre> |
||
254 | |BenutzerID (rechts ausgerichtet)|Name (Links ausgerichtet)|Gruppe (zentriert)| |
||
255 | |-------------------:|:----------------|:------------------:| |
||
256 | |2 |John Smith | | |
||
257 | |3 |Dave Lopper |A Team | |
||
258 | |4 |Robert Hill |B Team | |
||
259 | </pre> |
||
260 | |||
261 | Anzeige(Alle multiplen Leerzeichen werden durch 1 Leerzeichen ersetzt): |
||
262 | |||
263 | |_>. BenutzerID (rechts ausgerichtet|_<. Name (links ausgerichtet|_=. Group (zentriert)| |
||
264 | |>. 2 |<. John Smith | | |
||
265 | |>. 3 |<. Dave Lopper |=. A Team | |
||
266 | |>. 4 |<. Robert Hill |=. B Team | |
||
267 | |||
268 | h3. Inhaltsverzeichnis |
||
269 | |||
270 | <pre><code>{{toc}} => Links ausgerichtetes Inhaltsverzeichnis |
||
271 | {{>toc}} => Rechts ausgerichtetes Inhaltsverzeichnis |
||
272 | </code></pre> |
||
273 | |||
274 | Bitte beachten Sie, dass das @toc@-Tag eine leere Zeile darüber und darunter und keinen anderen Text davor und danach benötigt. |
||
275 | |||
276 | Beispiel: |
||
277 | |||
278 | <pre><code> |
||
279 | h1. Seitenüberschrift |
||
280 | |||
281 | h2. Ein Thema |
||
282 | |||
283 | {{toc}} |
||
284 | |||
285 | h2. Ein weiteres Thema |
||
286 | </code></pre> |
||
287 | |||
288 | h3. Fußnote |
||
289 | |||
290 | 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> |
||
291 | |||
292 | h2. Makros |
||
293 | |||
294 | 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: |
||
295 | |||
296 | {{macro_list}} |
||
297 | |||
298 | h2. Code-Hervorhebung |
||
299 | |||
300 | 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]]. |
||
301 | |||
302 | Mit dieser Syntax können Sie Code in Ihrer Wiki-Seite hervorheben: |
||
303 | |||
304 | <pre><code>``` ruby |
||
305 | Geben Sie hier Ihren Code ein. |
||
306 | ```</code></pre> |
||
307 | |||
308 | Example: |
||
309 | |||
310 | <pre><code class="ruby"> |
||
311 | # Die große Klasse |
||
312 | class Greeter |
||
313 | def initialize(name) |
||
314 | @name = name.capitalize |
||
315 | end |
||
316 | |||
317 | def salute |
||
318 | puts "Hallo #{@name}!" |
||
319 | end |
||
320 | end |
||
321 | </code></pre> |