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 verndern. 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 fr die Vernderung der Farbe vor: %black% (schwarz), %white% (wei), %red% (rot), %yellow% (gelb), %blue% (blau), %gray% (grau), %silver% (silber), %maroon% (braun), %green% (grn), %navy% (oliv) und %purple% (lila)

Der Korb enthlt %red% pfel, %blue% Blaubeeren, %purple% Auberginen, %green% Limetten %% und noch anderes.

Der Korb enthlt pfel, Blaubeeren, Auberginen, Limetten und noch anderes.

Fr 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 htte auch gerne noch %color=#ff7f00% Mandarinen%%!

Ich htte auch gerne noch Mandarinen!

Die Hintergrundfarbe kann mit dem Wikistil %bgcolor=...% verndert werden:

Dieser Satz enthlt %bgcolor=green yellow% gelben Text auf grnem Hintergrund. 

Dieser Satz enthlt gelben Text auf grnem Hintergrund.

Gltigkeitsbereiche

Wikistile knnen auch einen Gltigkeitsbereich angeben; Ohne Gltigkeitsbereich wird der Stil dem nachfolgenden Text bis zum nchsten Wikistil oder dem Ende des Absatzes zugewiesen, je nachdem, was zuerst kommt. Wird ein Gltigkeitsbereich angegeben, gilt der Stil fr einen Absatz (%p ...%), eine Liste (%list ...%), einem Listeneintrag (%item ...%) oder fr einen Block (%block ...%).

%p bgcolor=#ffeeee% Der Wikistil am Anfang dieses Absatzes gilt vom Anfang dieser Zeile fr den gesamten Absatz, sogar wenn %blue% andere Wikistile %% mitten im Absatz erscheinen.

Der Wikistil am Anfang dieses Absatzes gilt vom Anfang dieser Zeile fr den gesamten Absatz, sogar wenn andere Wikistile mitten im Absatz erscheinen.

Der >>style<< kann fr die Zuweisung eines Wikistils fr einen greren Bereich verwendet werden. Der Stil wird bis zum nchsten >><< verwendet.

>>blue font-style=italic bgcolor=#ffffcc<<
Alles nach obiger Zeile ist mit blauem, kursivem Text geschrieben,

Das beinhaltet
    vorformatierten Text
* Listen
-> eingerckte Zeilen
>><<

Alles nach obiger Zeile ist mit blauem, kursivem Text geschrieben,

Das beinhaltet

    vorformatierten Text
  • Listen
eingerckte 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 fr bestimmte Dinge gltig:

  • 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 Krzel um diesem Verweis zu folgen
  • value=9 setzt die Ziffer des aktuellen Nummernlisteneintrags

Eigene Stile

Mit dem define= Attribut knnen einem Kurznamen verschiende Wikistile zugewiesen werden. Dieser Kurzname kann fr sptere 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 knnen. Alternative kann der Administrator des Wikis Stile als lokale Anpassungen definieren, die auf der gesamten Webseite gltig 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 grner Farbe erscheinen sollen setzen Sie %define=warn green% und verwenden dann %warn% anstatt %green% im Dokument. Dann knnen Sie spter 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 fr: %color=...%)
  • Ausrichtung: %center% und %right%
  • Bilder und Rahmen
    • Linken oder rechten Textfluss: %rfloat% und %lfloat%
    • Rahmen: %frame%, %rframe%, und %lframe%
    • Vorschaugre: %thumb%
  • Verweis in neuem Fenster ffnen: %newwin% (Kurzname fr %target=_blank%)
  • Kommentare: %comment% (Kurzname fr %display=none%)
  • Nummerierte Listen: %decimal%, %roman%, %ROMAN%, %alpha%, %ALPHA% (siehe auch Cookbook:OutlineLists)

Beispiele

Beispiele zu den Wikistilen enthlt eine Reihe von Beispielen, wie Wikistile in Seiten eingesetzt werden knnen.

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

Seite zuletzt geändert am 09.12.2005 15:09 Uhr · Seitenaufrufe: 1564