Wikistile

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

Listen

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 >>