Wikistile

Autoren (Grundlagen und Fortgeschritten)

< Tabellendirektiven | Dokumentations-Index | Beispiele zu Wikistilen >

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=lightblue%.

Wikistil Attribute

Die erkannten Stilattribute innerhalb eines Wikistils sind:

 ----------------- CSS ------------------
 ---- HTML ----
 bgcolor
 background-color
 border1
 color
 background-color
 border
 display
 float
 clear
 font-size
 font-family
 font-weight
 font-style
 height*
 list-style
 margin1
 padding1
 text-align
 text-decoration   
 white-space
 width* 
 accesskey 
 align
 class
 hspace 
 id 
 target 
 rel 
 vspace 
 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.
    • Die Attribute "width" und "height" sind mit '*' gekennzeichnet, weil sie bei <img .../>-Auszeichnungen besonders behandelt werden: Werden sie so für sich benutzt, d. h. ohne dass ein "apply="-Parameter weitere Stile setzt, so setzen sie Breite und Höhe des folgenden <img .../>-Tags. Mit einem "apply="-Parameter gelten sie für das Element, dessen Stil gesetzt wird.
    1. margin, padding, and border können von -left, -right, -top, und -bottom gefolgt werden, Beispiel: margin-left.

Wikistile contra CSS-Stile

Wikistile, wie sie in die Seiten geschrieben werden, sind nicht exakt CSS-Stile oder CSS-Klassen. Wikistile erlauben Autoren, sowohl vom Administrator vordefinierte CSS-Klassen als auch eigenen Klassen zu benutzen und neue Kombinationen von Stilen zu definieren, ohne die lokalen CSS-Dateien auf dem Server zu verändern.

Beachten Sie, dass PmWiki fortgeschrittenen Autoren erlaubt, class= und style= in DIV-Bereichen und Tabellen zu benutzen, doch sind dies reine HTML-Attribute und keine Wikistile, Kenntnisse in CSS sind auf jeden Fall erforderlich.

Textfarben und Schriften

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

Weitere Farbdefinitionen: Wikistil-Farben

Textausrichtung

WikiStile werden benutzt, um die Textausrichtung zu kontrollieren

%center% Dieser Text ist zentriert. 

%right% Rechtsbündig.

Dieser Text ist zentriert.

Rechtsbündig.

und den Textfluss zu beinflussen:

%rfloat% Dieser Text fließt rechts 

%rframe% fließt rechts mit einem Rahmen 

Lorem ipsum dolor sit amet, consectetuer sadipscing elitr

Dieser Text fließt rechts

fließt rechts mit einem Rahmen

Lorem ipsum dolor sit amet, consectetuer sadipscing elitr

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 ...%).

Diese Gültigkeitsbereiche sind Abkürzungen für die weiter unten genannten "apply=" Attribute.

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

Größere Blöcke

Der >>style<<-Block 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

HTML "class" und "style" auf DIV-Bereiche anwenden

(:div style:) funktioniert fast wie >>style<<, aber die Stilinformation ist in ein style="" Attribut eingebettet, und verschachtelte Blöcke sind möglich.

(:div class="green" style="font-style:italic; border:1px solid blue; color:#00aa00; background-color:#ffffcc":)
Alles nach dieser Zeile ist grün und kursiv

Das beinhaltet
    vorformatierten Text
* Listen
-> eingerückte Zeilen
(:divend:)

Alles nach dieser Zeile ist grün und kursiv

Das beinhaltet

    vorformatierten Text
  • Listen
eingerückte Zeilen
(:div1 style="font-style:italic; background-color:#ffffcc":)
Äußerer Stil
(:div2 style="color:red; background-color:lightblue":)
verschachtelter Stil
(:div2end:)
wieder äußerer Stil
(:div1end:)

Äußerer Stil

verschachtelter Stil

wieder äußerer Stil

HTML "class" und "style" auf Tabellen anwenden

Wikistile können auch auf Tabellen und Tabellendirektiven angewendet werden

||border=1 class="beispiel" style="font-style:italic; border:1px solid blue; background-color:#ffffcc"
||Kursiver Text mit gelbem Hintergrund, CSS-Klasse "beispiel" (falls definiert)||
||für eine einfache Tabelle||
Kursiver Text mit gelbem Hintergrund, CSS-Klasse "beispiel" (falls definiert)
für eine einfache Tabelle
(:table class="beispiel" style="font-style:italic; border:1px solid blue; background-color:#ffffcc":)
(:cellnr:)
Kursiver Text mit gelbem Hintergrund, CSS-Klasse "beispiel" (falls definiert)

Einschließlich
    vorformatiertem Text
* Listen
-> Einrückung
(:tableend:)

Kursiver Text mit gelbem Hintergrund, CSS-Klasse "beispiel" (falls definiert)

Einschließlich

    vorformatiertem Text
  • Listen
Einrückung

Wikistile auf Blöcke anwenden

Wie oben bereits erwähnt, wirkt ein Wikistil normalerweise auf einen Absatz oder bis zum nächsten Wikistil. Mit dem apply= Attribut kann man den Wirkungsbereich gezielt festlegen. Die möglichen Werte für apply= sind:

LangformAbkürzungwirkt auf...
%apply=img ...%-das folgende Bild
%apply=p ...%%p ...%den Absatz
%apply=pre ...%-den "vorformatierten Text" Abschnitt
%apply=list ...%%list ...%die Liste
%apply=item ...%%item ...%das Listenelement
%apply=div ...%-den DIV-Bereich
%apply=block ...%%block ...%den Block (Absatz, Liste, Listenelement, Überschrift oder DIV-Bereich)

Für einige Bereichsdefinitionen sind Abkürzungen möglich, so ist %p color=blue% gleichwertig zu %apply=p color=blue%, und %list ROMAN% entspricht %apply=list list-style=upper-roman%.

Auch manche vordefinierte Wikistil-Kurznamen verwenden das Attribut "apply", z.B. ist %right% eine Abkürzung für %text-align=right apply=block%.

Beispiel: Wenden Sie einen Stil auf einen Absatz an:

%p bgcolor=#ffeeee% Die Wikistil-Angabe am Beginn der Zeile wirkt sich auf den ganzen Absatz aus, sogar wenn es eine %blue%andere Wikistil-Angabe %% inmitten des Absatzes gibt.

Die Wikistil-Angabe am Beginn der Zeile wirkt sich auf den ganzen Absatz aus, sogar wenn es eine andere Wikistil-Angabe inmitten des Absatzes gibt.

Der Wikistil wirkt sich nur aus, wenn er in der ersten Zeile des zu verändernden Elements steht. Eine Anweisung für einen Wikistil in der zweiten Zeile des Absatzes ist wirkungslos.

Der Wikistil in der folgenden Zeile
%apply=p color=blue% ist wirkungslos,
weil der Absatz bereits begonnen hat

Der Wikistil in der folgenden Zeile ist wirkungslos, weil der Absatz bereits begonnen hat

In der ersten Zeile %p color=red% des
Absatzes funktioniert die Anweisung

In der ersten Zeile des Absatzes funktioniert die Anweisung

* Eine Liste
* %list red% Hoppla - zu spät, um für die Liste zu wirken!
  • Eine Liste
  • Hoppla - zu spät, um für die Liste zu wirken!

Eigene Kurznamen für Stile

Mit dem define=-Attribut können einem Kurznamen verschiedene 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"

Tipp: 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 sind (siehe Eigene Wikistile).

Tipp: 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, die (eine) Definition anstatt vieler %green% zu ändern.

Tipp: Jeder undefinierte WikiStil wird automatisch als ein Aufruf einer Klasse behandelt, damit ist %pre% das Gleiche wie %class=pre%.

Vordefinierte Stilkurznamen

PmWiki definiert einige Stilkurznamen:

  • Textfarben: black, white, red, yellow, blue, gray, silver, maroon, green, navy, purple (Kurznamen für: %color=...%)
  • Ausrichtung: %center% und %right%
  • Bilder und Rahmen
    • Linker oder rechter 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)

Stile aktivieren

Stile, die oben nicht definiert sind, kann ein Wiki-Administrator aktivieren, indem er die local/config.php-Datei verändert. Um z. B. das "line-height"-Stilattribut zu aktivieren, fügt er die folgende Zeile hinzu:

$WikiStyleCSS[] = 'line-height';

Gültigkeitsbereich für andere HTML-Elemente definieren

Sie können zusätzliche HTML-Elemente zu $WikiStyleApply hinzufügen um WikiStyles auf weitere HTML-Elemente anzuwenden. Um zum Beispiel Stile für Tabellenzeilen zu erlauben, oder Anker-Tags.

Um einen Stil auf Anker-Tags anzuwenden, setzen Sie folgende Zeile in die config.php:

$WikiStyleApply['link'] = 'a';

Dann können Sie eine Klasse oder einen Stil auf einen Anker-Verweis anwenden:

%apply=link red%[[PmWiki.WikiStyles | test link]]

test link

Oder ,um ein ID-Atribut zu einer Tabellenzeile hinzuzufügen, setzen Sie die folgende Zeile in die config.php:

$WikiStyleApply['row'] = 'tr';

und in einer erweiterten Tabelle schreiben Sie:

(:cellnr:) %apply=row id=myid bgcolor=pink% cell content

Das geht auch auch in einer einfachen Tabelle:

|| border=1
|| %apply=row id=myrowid% 1 || 2 || 3 || 4 ||

Anmerkung: der %apply=row...%-WikiStil sollte in der gleichen Zeile wie (:cellnr:) stehen.

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. Statt dessen schreibt man %block width=50pct %.
  • Denken Sie daran, wenn Sie mehrere Werte für ein Attribut angeben (z. B. border="2px solid blue"), diese in Anführungszeichen zu setzen.
  • Benutzen Sie nur Kleinbuchstaben für Rot-Grün-Blau-Farben, wenn Sie die Werte in Hexadezimalzahlen angeben, %color=#aa3333% wird akzeptiert, %color=#AA3333% möglicherweise nicht.

Siehe auch

< Tabellendirektiven | Dokumentations-Index | Beispiele zu Wikistilen >


Übersetzung von PmWiki.WikiStyles Originalseite auf PmWikiDe.WikiStyles - Rückverweise
Zuletzt geändert:
PmWikiDe.WikiStyles am 01.04.2015
PmWiki.WikiStyles am 24.11.2022

Zuletzt geändert am 01.04.2015 15:34 Uhr