DenkzeitWiki

PmWikiDe /

Wiki Styles

wikistyle um rererenzen auf die übersetzte Originalseite besonders zu markieren wikistyle um Textpassagen zu markieren, die noch überarbeitet werden müssen (deutsche Übersetzung der Seite PmWiki.DocumentationIndex, Stand 7.7.2004)
WikiStyles ermöglichen es, die Farbe oder andere Attribute von Textabschnitten zu verändern. Die Spezifikation eines Stiles wie etwa %red% führt dazu, dass der auf diese Spezifikation folgende Text bis zum Zeilenende oder bis zum nächsten Paar von Prozentzeichen rot dargestellt wird. Ein Beispiel:

   %red% Dieser Text ist rot und %blue% dieser Text ist blau,
   %% aber dieser Text ist normal.

wird folgendermaßen dargestellt:

Die vordefinierten WikiStyles lassen sich vom WikiAdministrator? anpassen. Die meisten PmWiki-Systeme definieren %newwin% so, dass bei Verwendung dieses Stiles Verweise in neuen Fenstern geöffnet werden (Beispiel). Außerdem werden normalerweise Standardfarben wie %black%, %white%, %red%, %green%, %blue%, etc. für Texte vordefiniert.

Neue Stile definieren

Das Verwenden von color oder bgcolor-Spezifikationen innerhalb eines Paares von Prozentzeichen führt dazu, dass sich die Farbe oder die Hintergrundfarbe des darauf folgenden Textes bis zum Zeilenende oder bis zum nächsten Paar von Prozentzeichen entsprechend ändert.
Beispielsweise wird:

    %color=red% Dieser Text ist rot und %color=blue% dieser Text 
    ist blau, %% aber dieser Text ist normal. 

folgendermaßen dargestellt:

Analog dazu lässt sich auch die Hintergrundfarbe ändern, indem man das Attribut bgcolor verwendet:

    %color=white bgcolor=green% Dieser Text ist weiß vor grünem
    Hintergrund %color=green% und dieser Text ist grün vor weißem
    Hintergrund.

Mit Hilfe des Attributes target lässt sich einstellen, dass Verweise in einem neuen Fenster geöffnet werden sollen:

    %target=_blank% Alle Verweise auf dieser Zeile, wie
    http://www.pmichaud.com öffnen sich in einem neuen Fenster.

Dies wird dargestellt als:

Schließlich lassen sich mit WikiStyles die Breite und Höhe von Bildern in WikiSeiten beeinflussen. Die Formatierungsanweisung

    %height=50% http://www.example.com/some.gif

führt dazu, dass some.gif auf eine Höhe von 50 Pixeln skaliert wird.

Stildefinitionen

Wiki-Autoren können auch ihre eigenen WikiStyles definieren, indem sie das Attribut define innerhalb einer Seite verwenden. Beispielsweise definiert die Anweisung

    %define=hotpink color=#ff69b4%

den Ausdruck %hotpink% als Synonym (oder als Abkürzung) für %color=#ff69b4% (so geht's). Innerhalb einer Definition lassen sich auch mehrere Dinge spezifizieren, wie in

    %define=reverse color=white bgcolor=black%

Nachdem man die beiden angeführten Definitionen vorgenommen hat, lässt sich mit %reverse% folgender Effekt erreichen: reverse video. Mit %reverse hotpink% kann man eine Kombination beider Definitionen nutzen.
Meist ist es sinnvoll, gängige Stildefinitionen in GroupHeaders? vorzunehmen, so dass sie von vielen Seiten innerhalb einer Gruppe genutzt werden können und nicht jeweils neu definiert werden müssen. Alternativ dazu kann der WikiAdministrator? Stile vordefinieren, wie in LocalCustomization? -- siehe dazu WikiStylesAdmin?.

Vordefinierte Stile

Eine Beschreibung der in einer Standardinstallation von PmWiki vordefinierten Stile findet sich bei den vordefinierten WikiStyles. Auf dieser Seite wird auch beschrieben, wie Adminstratoren zusätzliche WikiStyles vordefinieren können.

Farben

Für Beispiele von Farbdefinitionen siehe WikiStyleColors?.

---

<< Textformattierungsanweisungen | DocumentationIndex | Hochladen >>