wrap
Erweitert DokuWiki um viele Elemente.
Es gibt funktional einige Dopplungen mit dem bootstrap wrapper-Plugin.
Syntax Grundlage
<WRAP>
-Tag umschlossen, das durch Attribute erweitert wird.
Man unterscheidet:
Block-Elemente (in HTML <div>), die für ganze Absätze (oder Listen, Tabellen …) gelten.
Sie nehmen i. d. R. die komplette Seitenbreite ein.
Das WRAP-Plugin erzeugt Block-Elemente mit einem großgeschriebenen <WRAP>,- Inline-Elemente (in HTML <span>), die nur für einen Teil eines Bereichs gelten, z. B. einen Textabschnitt innerhalb eines Absatzes.
Das WRAP-Plugin erzeugt Inline-Elemente mit einem kleingeschriebenen <wrap>.
<WRAP Attribut> ... Inhalte ... </WRAP>
<WRAP hi>Block-Elemente, die für ganze Absätze gelten. </WRAP>
Inline-Elemente, die nur für <wrap hi>einen Teil eines Bereichs </wrap> gelten
Texte
Dieser Text wird eingerückt.
Dieser Text wird „ausgerückt“.
Es folgt der Spoiler: Dieser Text wird erst nach Markieren sichtbar.
Der folgende Text ist versteckt: Dieser Abschnitt muss überarbeitet werden.
Zentrierter Text…
… rechtsbündiger Text.
Dieser Text ist <wrap hi>hervorgehoben</wrap>, <wrap lo>weniger wichtig</wrap> und <wrap em>besonders hervorgehoben</wrap>.
<wrap indent>Dieser Text wird eingerückt.</wrap>
<wrap outdent>Dieser Text wird "ausgerückt".</wrap>
Es folgt der Spoiler: <wrap spoiler>Dieser Text wird erst nach Markieren sichtbar.</wrap>
Der folgende Text ist versteckt: <wrap hide>Dieser Abschnitt muss überarbeitet werden.</wrap>
<WRAP centeralign>Zentrierter Text...</WRAP>
<WRAP rightalign>... rechtsbündiger Text.</WRAP>
Mehrspaltigkeit
Moderne Browser (Firefox, Chrome, Safari, …) unterstützen Mehrspaltigkeit.
Schreiben Sie einfach col2
für 2 Spalten, col3
für 3 Spalten, col4
für 4 Spalten und col5
für 5 Spalten.
Die Inhalte werden automatisch auf die Spalten verteilt.
<WRAP col3>Moderne Browse (Firefox, Chrome, Safari, ...) unterstützen Mehrspaltigkeit.\\ Schreiben Sie einfach **''%%col2%%''** für 2 Spalten, **''%%col3%%''** für 3 Spalten, **''%%col4%%''** für 4 Spalten und **''%%col5%%''** für 5 Spalten.\\ Die Inhalte werden automatisch auf die Spalten verteilt.</WRAP>
Boxen
Sie können einen Box um ein WRAP
-Element herum erzeugen. Die erste Angabe beschreibt den Typ der Box:
column
erzeugt eine neutrale Textbox ohne Hintergrundfarbe, z. B. für mehrere Spalten mit festem Inhalt,box
erzeugt eine Box in unauffälliger Farbe,danger
,warning
,caution
,notice
,safety
mit Signalfarben,- mit
info
,tip
,important
,alert
,help
,download
,todo
erhält die Box eine Färbung und ein Symbol.
Mit der Option round
werden die Ecken abgerundet.
Es kann eine Breite vorgegeben werden. Gängig sind
Pixel px
für eine feste Breite,
Prozent %
für eine relative Breite.
Zusätzlich wird noch Platz für den Abstand um die Box herum verbraucht.
Ohne Breitenangabe geht die Box über die gesamte Breite
center
zentriert die Box
Position left
(oder column
)
Position right
Wenn die Box links oder rechts positioniert wird, wird sie von Text umflossen.
Dies kann durch ein clear
beendet werden.
<WRAP box round>Mit der Option ''round'' werden die Ecken abgerundet.</WRAP>
<WRAP box 200px left>Pixel ''px'' für eine feste Breite,</WRAP> <WRAP box 50%> Prozent ''%'' für eine relative Breite.</WRAP>
<WRAP box round>Ohne Breitenangabe geht die Box über die gesamte Breite</WRAP>
<WRAP box 200px center>''center'' zentriert die Box</WRAP>
<WRAP box 30% left>Position ''left'' (oder ''column'')</WRAP> <WRAP box 20% right>Position ''right''</WRAP> Wenn die Box links oder rechts positioniert wird, wird sie von Text umflossen. <WRAP clear></WRAP>Dies kann durch ein ''clear'' beendet werden.
Boxentypen
Dieser Text erscheint nicht auf dem Bildschirm, nur auf einem Ausdruck.
Diese Einstellungen gelten auch für den pdf-Export über das Plugin dw2pdf.
Hinter dieser Zeile folgt im Druck ein Seitenumbruch. <WRAP pagebreak></WRAP>
<wrap noprint>Dieser Text erscheint auf dem Bildschirm, aber nicht auf einem Ausdruck.</wrap>
<wrap onlyprint>Dieser Text erscheint nicht auf dem Bildschirm, nur auf einem Ausdruck.</wrap>
WRAP ohne Attribut
Da ein WRAP-Block seine Inhalte nach außen abkapselt, lassen sich durch ein einfaches <WRAP>
Formatierungen umsetzen, die sonst nicht möglich sind.
Beispiel: in Tabellenfeldern lassen sich normalerweise keine Listen anlegen, weil ein Listenpukte mit einem Zeilenumbruch abgeschlossen werden muss, der aber auch zu einer neuen Reihe in einer Tabelle führen würde. Ist die Liste innerhalb eines WRAP-Blocks, wird der Zeilenumbruch dort als „Ende einer Listenzeile“ verarbeitet, aber in der umliegenden Tabelle nicht als „Ende der Reihe“ ausgewertet:
Spalte 1 | Spalte 2 |
---|---|
Liste in Tabellenfeld
| Inhalt Spalte 2 |
^ Spalte 1 ^ Spalte 2 ^ | <WRAP> Liste in Tabellenfeld * Listenpunkt 1 * Listenpunkt 2 </WRAP> | Inhalt spalte 2 |