Project

General

Profile

DeRedmineTextFormattingTextile » History » Version 11

C S, 2021-04-15 09:36
Fertigstellung der ersten Fassung

1 3 C S
Übersetzung der "Rev. 11":http://www.redmine.org/projects/redmine/wiki/RedmineTextFormattingTextile/11
2
3
*UNVOLLSTÄNDIG*
4
5
{{>TOC}}
6
7 1 C S
h1. Textile Formatierung
8
9 2 C S
Unten wird die *Textile* Formatierung beschrieben. Informationen zur *Markdown* -Formatierung finden Sie unter [[DeRedmineTextFormattingMarkdown|Markdown Formatierung]].
10
Einschränkungen der aktuellen Textilunterstützung finden Sie unter #6269, #10078 (Definitionslisten).
11
12
h2. Verweise (Links)
13
14
h3. Redmine interne Verweise
15
16
{{include(DeRedmineTextFormattingRedmineLinks)}}
17
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
* *"Redmine Webseite":http://www.redmine.org* -- Externer Link mit anderem Text: "Redmine Webseite":http://www.redmine.org
25
* *!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: 
26
27
p=. !http://www.redmine.org/attachments/7069/Redmine_logo.png(Redmine Webseite)!:http://www.redmine.org
28
29
Der Datei-URI kann zum Verknüpfen des UNC-Pfads verwendet werden:
30 1 C S
* *"\\server\share$":file://///server/share%24* -- Datei-URI mit UNC-Pfad: "\\server\share$":file://///server/share%24
31
Sie sollten "URL kodierte":http://www.w3schools.com/tags/ref_urlencode.asp Angaben für Sonderzeichen wie Leertaste, $, ä, ü, ö, ß, etc. benutzen.
32 3 C S
33
h3. E-Mail Adressen
34
35
E-Mail Adressen werden automatisch in anklickbare Links umgewandelt:
36
37
* *jemand@foo.bar* -- Link zu einer Email Addresse: jemand@foo.bar
38
* *"Email":mailto:jemand@foo.bar* -- Email link mit anderem Text: "Email":mailto:jemand@foo.bar
39 4 C S
40
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.
41
42
* *"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
43
* *"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
44
* *"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
45
46
h2. Textformatierung
47
48
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.
49 5 C S
50
h3. Akronym
51
52
<pre>
53
JPL(Jean-Philippe Lang)
54
</pre>
55
56
Darstellung:
57
58
JPL(Jean-Philippe Lang)
59
60
h3. Schriftart
61
62
<pre><code>* *fett*
63
* _kursiv_
64
* *_fett kursiv_*
65
* +unterstrichen+
66
* -durchgestrichen-
67
* Normal ^hochgestellt^
68
* Normal ~tiefgestellt~
69
* @Schriftart Monospace@
70
* <notextile>Normal *fett* _kursiv_ normal;E=mc ^2^</notextile>
71
* <notextile>Normal<notextile></notextile>*fett*<notextile></notextile>_kursiv_<notextile></notextile>normal;E=mc<notextile></notextile>^2^</notextile>
72
* <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>
73
* <notextile><pre>*Mehrere Linien*      ein "Link":http://www.redmine.org</pre></notextile>
74
* <notextile><pre><notextile></notextile>*Mehrere Linien*      Ein "Link":http://www.redmine.org</pre></notextile>
75
</code></pre>
76
77 6 C S
Darstellung:
78 5 C S
79
 * *fett*
80
 * _kursiv_
81
 * *_fett kursiv_*
82
 * +unterstrichen+
83
 * -durchgestrichen-
84
 * Normal ^hochgestellt^
85
 * Normal ~tiefgestellt~
86
 * @Schriftart Monospace@
87
 * Normal *fett* _kursiv_ normal;E=mc ^2^
88
 * Normal<notextile></notextile>*fett*<notextile></notextile>_kursiv_<notextile></notextile>normal;E=mc<notextile></notextile>^2^
89
 * Escaping: <notextile>*fett* _kursiv_ @inlinemono@</notextile> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Alternative HTML-Codes: &#42;fett&#42; &#95;kursiv&#95; &#64;inlinemono&#64;
90
 * <pre>*Mehrere Linien*      Ein "Link":http://www.redmine.org</pre>
91
 * <pre><notextile></notextile>*Mehrere Linien*      Ein "Link":http://www.redmine.org</pre>
92 7 C S
93
h3. Farben
94
95
<pre><code><notextile>* %{color:red}Rot% %{color:green}Grün% %{color:yellow}Gelb% %{color:#82B6E1}Bläulich%
96
* %{color:red}Rot%<notextile></notextile>%{color:green}Grün%<notextile></notextile>%{color:yellow}Gelb%<notextile></notextile>%{color:#82B6E1}Bläulich%
97
* %{background:lightgreen}Hellgrüner Hintergrund% %{background:yellow}Gelber Hintergrund%
98
* %{background:lightgreen}Hellgrüner Hintergrund%<notextile></notextile>%{background:yellow}Gelber Hintergrund%
99
</notextile></code></pre>
100
101
Anzeige:
102
103
 * %{color:red}Rot% %{color:green}green% %{color:yellow}Gelb% %{color:#82B6E1}Bläulich%
104
 * %{color:red}Rot%<notextile></notextile>%{color:green}Grün%<notextile></notextile>%{color:yellow}Gelb%<notextile></notextile>%{color:#82B6E1}Bläulich%
105
 * %{background:lightgreen}Hellgrüner Hintergrund% %{background:yellow}Gelber Hintergrund%
106
 * %{background:lightgreen}Hellgrüner Hintergrund%<notextile></notextile>%{background:yellow}Gelber Hintergrund%
107
108
h3. Eingebettete Bilder
109
110
* *&#33;image_url&#33;* Zeigt ein Bild an, das sich unter @image_url@ befindet (Textile Syntax)
111
* *&#33;>image_url&#33;* Rechts schwebendes Bild
112
* *&#33;image_url(Bildtitel)&#33;* Zeigt ein Bild mit einem @Alt/Titel@-Attribut an
113
* *&#33;image_url&#33;:URL* Zeigt ein Bild von @image_url@ mit hinzugefügter Link-URL an
114
115
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;*
116
117
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.
118
119
h3. Überschriften
120
121
<pre><code>h1. Hauptüberschrift
122
123
h2. Sekundäre Überschrift
124
125
h3. Tertiäre Überschrift
126
</code></pre>
127
128 8 C S
Redmine weist jeder dieser Überschriften einen Anker zu, sodass Sie sie mit @"#Hauptüberschrift", "#Sekundäre Überschrift"@ usw. verknüpfen können.
129 9 C S
130
h3. Absätze
131
132
<pre><code>p. links ausgerichtet
133
134
p(. Linker Einzug 1em
135
136
p((. Linker Einzug 2em
137
sowie für folgende Zeilen
138
139
p>. rechts ausgerichtet
140
141
p)))>. Rechter Einzug 3em
142
143
p=. Dies ist ein zentrierter Absatz.
144
</code></pre>
145
146
Anzeige:
147
148
p(. Linker Einzug 1em
149
150
p((. Linker Einzug 2em
151
sowie für folgende Zeilen
152
153
p>. rechts ausgerichtet
154
155
p)))>. Rechter Einzug 3em
156
157
p=. Dies ist ein zentrierter Absatz.
158
159
h3. Horizontale Linie
160
161
@----@
162
163
Anzeige:
164
165
----
166
167
h3. Vorformatierter Text
168
169
<pre> <pre>*Dieser Text wird nicht fett angezeigt*</pre> </pre>
170
171
Anzeige:
172
173
<pre> *Dieser Text wird nicht fett angezeigt* </pre>
174
175
h3. Block Zitate
176
177
Absatzbeginn mit *bq.*:
178
179
180
<pre><code>bq. Rails ist ein Full-Stack-Framework für die Entwicklung datenbankgestützter Webanwendungen nach dem Model-View-Control-Muster.
181
Um live zu gehen, müssen Sie lediglich eine Datenbank und einen Webserver hinzufügen.
182
</code></pre>
183
184
Anzeige:
185
186
bq. Rails ist ein Full-Stack-Framework für die Entwicklung datenbankgestützter Webanwendungen nach dem Model-View-Control-Muster.
187
Um live zu gehen, müssen Sie lediglich eine Datenbank und einen Webserver hinzufügen.
188
189
Sie können auch > am Anfang jeder Zeile verwenden und sie für verschachtelte Anführungszeichen stapeln:
190
191
<pre>
192
>>Rails ist ein Full-Stack-Framework für die Entwicklung datenbankgestützter Webanwendungen nach dem Model-View-Control-Muster.
193
>>Um live zu gehen, müssen Sie lediglich eine Datenbank und einen Webserver hinzufügen.
194
>Super!
195
</pre>
196
197
Anzeige:
198
199
>>Rails ist ein Full-Stack-Framework für die Entwicklung datenbankgestützter Webanwendungen nach dem Model-View-Control-Muster.
200
>>Um live zu gehen, müssen Sie lediglich eine Datenbank und einen Webserver hinzufügen.
201
>Super!
202
203
h3. Ungeordnete Listen
204
205
<pre>
206
* Punkt 1
207
* Punkt 2
208
** Punkt 21
209
** Punkt 22
210
* Punkt 3
211
</pre>
212
213
Anzeige:
214
215
* Punkt 1
216
* Punkt 2
217
** Punkt 21
218
** Punkt 22
219
* Punkt 3
220
221
h3. Geordnete Listen
222
223
<pre>
224
# Punkt 1
225
# Punkt 2
226
# Punkt 3
227
## Punkt 3.1
228
## Punkt 3.2
229
</pre>
230
231
Anzeige:
232
233
# Punkt 1
234
# Punkt 2
235
# Punkt 3
236
## Punkt 3.1
237
## Punkt 3.2
238
239
h3. Tabellen
240
241
<pre>
242
|_.ID      |_.Name          |_.Gruppe     |_. Attributen Liste   |
243
|Start mit  | einer              |   simplen   |Reihe                 |
244
|\3=.IT                                      |<. Ausrichtung links       |
245
|1             |Artur Pirozhkov |/2.Benutzer    |>. Ausrichtung rechts      |
246
|2             |Vasya Rogov     |=. zentriert   |
247
|3             |John Smith      |Admin
248
                                 (root)      |^. Ausrichtung oben       |
249
|4             |-               |Nobody
250
                                 (anonymous) |~. Ausrichtung unten    |
251
</pre>
252
253
Anzeige(Alle multiplen Leerzeichen werden durch 1 Leerzeichen ersetzt):
254
255
|_.ID      |_.Name          |_.Gruppe     |_. Attributen Liste   |
256
|Start mit  | einer              |   simplen   |Reihe                 |
257
|\3=.IT                                      |<. Ausrichtung links       |
258
|1             |Artur Pirozhkov |/2.Benutzer    |>. Ausrichtung rechts      |
259
|2             |Vasya Rogov     |=. zentriert   |
260
|3             |John Smith      |Admin
261
                                 (root)      |^. Ausrichtung oben       |
262
|4             |-               |Niemand
263
                                 (anonymous) |~. Ausrichtung unten    |
264
265
Wenn Sie Pipe-Zeichen in Ihre Tabelle aufnehmen möchten (z. B. für Wiki-Links), müssen Sie verhindern, dass *Textile* diese interpretiert:
266
267
|_.Eingabe |_. Ausgabe|
268
|*<notextile><notextile>|</notextile></notextile>*|<notextile>|</notextile>|
269
270
Wenn Sie die Breite der Tabelle angeben möchten, müssen Sie *table{width: 100%}.* unmittelbar vor Ihrer Tabellendefinition einfügen:
271
272
<pre>
273
table{width:100%}.
274
| Diese Tabelle nutzt
275
die komplette horizontale Breite |
276
</pre>
277
278
Auf diese Weise erstreckt sich die Tabelle über die gesamte Seitenbreite ...
279
280
table{width:100%}.
281
| Diese Tabelle nutzt
282
die komplette horizontale Breite |
283
284
... verglichen mit der Standardbreite:
285
286
| Diese Tabelle nutzt nur
287
die benötigte horizontale Breite |
288 10 C S
289
h3. Inhaltsverzeichnis
290
291
<pre><code>{{toc}} => Links ausgerichtetes Inhaltsverzeichnis
292
{{>toc}} => Rechts ausgerichtetes Inhaltsverzeichnis
293
</code></pre>
294
295
Bitte beachten Sie, dass das @toc@-Tag eine leere Zeile darüber und darunter und keinen anderen Text davor und danach benötigt.
296
297
Beispiel:
298
299
<pre><code>
300
h1. Seitenüberschrift
301
302
h2. Ein Thema
303
304
{{toc}}
305
306
h2. Ein weiteres Thema
307
</code></pre>
308
309 11 C S
h2. Makros
310 10 C S
311
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:
312
313 1 C S
{{macro_list}}
314 11 C S
315
h2. Code-Hervorhebung
316
317
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]].
318
319
Mit dieser Syntax können Sie Code in Ihrer Wiki-Seite hervorheben:
320
321
<pre><code><pre><code class="ruby">
322
   Geben Sie hier Ihren Code ein.
323
</code></pre>
324
</code></pre>
325
326
Beispiel:
327
328
<pre><code class="ruby">
329
# Die große Klasse
330
class Greeter
331
  def initialize(name)
332
    @name = name.capitalize
333
  end
334
 
335
  def salute
336
    puts "Hallo #{@name}!"
337
  end
338
end
339
</code></pre>
340
341
h2. Text mit CSS gestalten
342
343
Textile kann Text mit CSS formatieren. Beispiele wie folgt:
344
345
<pre>Drei Grundfarben des Lichts sind %{color: #f00}rot%, %{color: #0f0}grün% und %{color: #00f}blau%.
346
347
p{border: solid 1px #000; padding: 0.5em;}. Der schnelle, braune Fuchs springt über den faulen Hund.
348
349
table{width: 100%}.
350
|={width: 30%; background-color: #aaf;}. column 1 |={width: 70%}. column 2 |
351
</pre>
352
353
Anzeige: 
354
355
Die drei Grundfarben des Lichts sind %{color: #f00}rot%, %{color: #0f0}grün% und %{color: #00f}blau%.
356
357
p{border: solid 1px #000; padding: 0.5em;}. Der schnelle, braune Fuchs springt über den faulen Hund.
358
359
table{width: 100%}.
360
|={width: 30%; background-color: #aaf;}. column 1 |={width: 70%}. column 2 |
361
362
h3. Zulässige CSS-Eigenschaften
363
364
Redmine erlaubt die folgenden Eigenschaften. Andere Eigenschaften sind aus Sicherheitsgründen nicht zulässig (siehe r2192).
365
366
* background
367
* background-*
368
* border
369
* border-*
370
* color
371
* float
372
* font
373
* font-*
374
* height
375
* margin
376
* margin-*
377
* max-height
378
* max-width
379
* min-height
380
* min-width
381
* padding
382
* padding-*
383
* text
384
* text-*
385
* width