Autoren (Grundlagen)
(deutsche Übersetzung der Seite PmWiki.WikiStyles, Stand 09.09.2005)
Wikistil Grundlagen
Wikistile erlauben es dem Autor die Farbe und andere Merkmale eines Seiteninhalts zu verändern. Ein Wikistil wird von Prozentzeichen eingerahmt wie z.B. bei %red% oder %bgcolor=blue%.
Die grundlegenste Anwendung von Wikistilen ist das Ändern von Textattributen wie Farbe, Hintergrundfarbe und Schriftart. PmWiki definiert bereits einige Wikistile für die Veränderung der Farbe vor: %black% (schwarz), %white% (weiß), %red% (rot), %yellow% (gelb), %blue% (blau), %gray% (grau), %silver% (silber), %maroon% (braun), %green% (grün), %navy% (oliv) und %purple% (lila)
Der Korb enthält %red% Äpfel, %blue% Blaubeeren, %purple% Auberginen, %green% Limetten %% und noch anderes.
|
Der Korb enthält Äpfel, Blaubeeren, Auberginen, Limetten und noch anderes.
|
Für andere als die vordefinierten Farben verwendet man den %color=...% Wikistil. (Hinweis: RGB Farben (#rrggbb) sollten immer mit Kleinbuchstaben definiert werden, damit sie nicht als versehentlich als Wiki Wort? erkannt werden.)
Ich hätte auch gerne noch %color=#ff7f00% Mandarinen%%!
|
Ich hätte auch gerne noch Mandarinen!
|
Die Hintergrundfarbe kann mit dem Wikistil %bgcolor=...% verändert werden:
Dieser Satz enthält %bgcolor=green yellow% gelben Text auf grünem Hintergrund. |
Dieser Satz enthält gelben Text auf grünem Hintergrund.
|
Gültigkeitsbereiche
Wikistile können auch einen Gültigkeitsbereich angeben; Ohne Gültigkeitsbereich wird der Stil dem nachfolgenden Text bis zum nächsten Wikistil oder dem Ende des Absatzes zugewiesen, je nachdem, was zuerst kommt. Wird ein Gültigkeitsbereich angegeben, gilt der Stil für einen Absatz (%p ...%), eine Liste (%list ...%), einem Listeneintrag (%item ...%) oder für einen Block (%block ...%).
%p bgcolor=#ffeeee% Der Wikistil am Anfang dieses Absatzes gilt vom Anfang dieser Zeile für den gesamten Absatz, sogar wenn %blue% andere Wikistile %% mitten im Absatz erscheinen.
|
Der Wikistil am Anfang dieses Absatzes gilt vom Anfang dieser Zeile für den gesamten Absatz, sogar wenn andere Wikistile mitten im Absatz erscheinen.
|
Der >>style<< kann für die Zuweisung eines Wikistils für einen größeren Bereich verwendet werden. Der Stil wird bis zum nächsten >><< verwendet.
>>blue font-style=italic bgcolor=#ffffcc<<
Alles nach obiger Zeile ist mit blauem, kursivem Text geschrieben,
Das beinhaltet
vorformatierten Text
* Listen
-> eingerückte Zeilen
>><<
|
Alles nach obiger Zeile ist mit blauem, kursivem Text geschrieben,
Das beinhaltet
vorformatierten Text
eingerückte Zeilen
|
Wikistil Attribute
Die erkannten Stilattribute innerhalb eines Wikistils sind:
------------ CSS ------------- --HTML--
color bgcolor class
background-color margin id
text-align padding hspace
text-decoration border vspace
font-size float target
font-family list-style rel
font-weight width* accesskey
font-style height* value
Sonderattribute: define, apply
Die Attribute in den ersten beiden Spalten entsprechen den Cascading Style Sheet (CSS) Attributen gleichen Namens. Die Attribute in der letzten Spalte sind nur für bestimmte Dinge gültig:
class= und id= weisen einem HTML-Element eine CSS-Klasse oder -Kennung zu
target=name öffnet Verweise in einem Fenster mit dem Namen "name"
rel=name in einem Verweis gibt die Beziehung zur Zielseite an
accesskey=x verwendet 'x' als Kürzel um diesem Verweis zu folgen
value=9 setzt die Ziffer des aktuellen Nummernlisteneintrags
Eigene Stile
Mit dem define= Attribut können einem Kurznamen verschiende Wikistile zugewiesen werden. Dieser Kurzname kann für spätere Wikistile verwendet werden.
%define=box block bgcolor=#ddddff border="2px dotted blue"%
%box% [@
$ echo "Hallo Welt"
Hallo Welt
$ exit
@]
%box font-weight=bold color=green% [@
$ echo "Ich sagte, HALLO"
@] |
$ echo "Hallo Welt"
Hallo Welt
$ exit
$ echo "Ich sagte, HALLO"
|
Tip: Meist ist es eine gute Idee gemeinsame Stildefinitionen in den Kopfzeilen der Gruppe unterzubringen, so dass sie bei allen Seiten der Gruppe verwendet werden können. Alternative kann der Administrator des Wikis Stile als lokale Anpassungen definieren, die auf der gesamten Webseite gültig sond (siehe Eigene Wikistile).
Tip: Verwenden Sie bei der Definition von Stilen passende Bedeutungen als Text anstatt nur den Farbnamen. Wenn zum Beispiel Warnungen in grüner Farbe erscheinen sollen setzen Sie %define=warn green% und verwenden dann %warn% anstatt %green% im Dokument. Dann können Sie später immer noch entscheiden, dass Warnungn vielleicht doch anders dargestellt werden sollen. So ist es viel einfacher (eine) Definition anstatt vieler %green% zu ändern.
Vordefinierte Stilkurznamen
PmWiki definiert einige Silkurznamen:
- Textfarben: black, white, red, yellow, blue, gray, silver, maroon, green, navy, purple (Kurznamen für:
%color=...%)
- Ausrichtung:
%center% und %right%
- Bilder und Rahmen
- Linken oder rechten Textfluss:
%rfloat% und %lfloat%
- Rahmen:
%frame%, %rframe%, und %lframe%
- Vorschaugröße:
%thumb%
- Verweis in neuem Fenster öffnen:
%newwin% (Kurzname für %target=_blank%)
- Kommentare:
%comment% (Kurzname für %display=none%)
- Nummerierte Listen:
%decimal%, %roman%, %ROMAN%, %alpha%, %ALPHA% (siehe auch Cookbook:OutlineLists)
Beispiele
Beispiele zu den Wikistilen enthält eine Reihe von Beispielen, wie Wikistile in Seiten eingesetzt werden können.
Bekannte Probleme
- Prozentzeichen funktionieren in den Stildefinitionen (z.B.:
%block width=50% %) derzeit nicht, da es ein Problem ist diese von der Endmarkierung der Stildefinition zu unterscheiden.
<< Tabellendirektiven | Dokumentationsindex | Beispiele zu den Wikistilen >>
