(deutsche Übersetzung der Seite PmWiki.WikiStyleExamples, Stand 22.09.2005)
PmWiki benutzt Wikistile als einen Mechanismus, um Text mit Farbe und anderen Eigenschaften zu gestalten. PmWiki 2.0 ermöglicht weitere Stile und diese auch auf Blöcke anzuwenden.
Die Grundlagen der Wikistile haben sich nicht verändert - grundsätzlich wird ein Stil innerhalb von zwei %-Zeichen festgelegt und auf den darauf folgenden Text angewendet.
Dieser Text ist %color=red% rot, %color=blue% blau, %% und standard (schwarz). |
Dieser Text ist rot, blau, und standard (schwarz). |
Es gibt eine große Anzahl von verfügbaren Stilparametern, welche vornehmlich an HTML und CSS angelehnt sind. Darüber hinaus kann der Autor eine Kürzel (Shortcuts) festlegen, indem er die define= Eigenschaft zu Hilfe nimmt. Um beispilesweise einen Stil für %rot% festzulegen:
%color=red define=Meinstil% Hier gibts ein bisschen %Meinstil% rote Schrift, die durch Verwendung einer Stilvorlage erzeugt wurde. |
Hier gibts ein bisschen rote Schrift, die durch Verwendung einer Stilvorlage erzeugt wurde. |
Kürzel können mit anderen Stilen als auch mit anderen Kürzeln kombiniert werden:
%color=red define=inRot% %bgcolor=yellow define=gelberGrund% %inRot% Diese Schrift ist rot, %red bgcolor=#ccc% rot auf grauem Grund und %inRot gelberGrund% rot auf einem gelben Hintergrund. |
Diese Schrift ist rot, rot auf grauem Grund und rot auf einem gelben Hintergrund. |
Soweit ist die Funktionalität fast identisch mit PmWiki 1.0. PmWiki 2.0 kann neuerdings Stile auf Blöcke mit der Stileigenschaft apply= anwenden. Wenn man apply=block als Wikistil definiert, wirkt das auf den gesamten Block, anstatt nur auf den folgenden Text:
Der gesamte Block %apply=block bgcolor=yellow% hat einen gelben Hintergrund, selbst wenn der WikiStyle in der Zeilenmitte auftaucht. %bgcolor=pink% Andere Inline (Nicht-Block) WikiStyles können in der Mitte der Textzeile sichtbar werden,%% und nach diesem (Nicht-Block) WikiStyle gehts weiter wie vor seinem Einschub in den Block. |
Der gesamte Block hat einen gelben Hintergrund, selbst wenn der WikiStyle in der Zeilenmitte auftaucht. Andere Inline (Nicht-Block) WikiStyles können in der Mitte der Textzeile sichtbar werden, und nach diesem (Nicht-Block) WikiStyle gehts weiter wie vor seinem Einschub in den Block. |
Text kann rechtsbündig oder zentriert ausgerichtet werden:
%block text-align=right% Der Text dieses Absatzes ist rechtsbündig. %block text-align=center% Der Text dieses Absatzes ist zentriert. |
Der Text dieses Absatzes ist rechtsbündig. Der Text dieses Absatzes ist zentriert. |
In PmWiki sind die %right% und %center% Stilkürzel vordefiniert, so dass es noch einfacher geht:
%right% Das ist rechtsbündig. %center% Dieses ist zentriert. |
Das ist rechtsbündig. Dieses ist zentriert. |
Autoren können ihre eigenen angepassten Stile festlegen:
%block bgcolor=#fdf define=Pm% %center bgcolor=#dfd border='3px dotted green' define=der designer% %right bgcolor=#ffffcc border='1px dotted red' define=Nichtraucher% %Pm% Alle Schrift auf einem hellrosa Hintergrund zeigt einen Kommentar von [[~Pm]] an. %der Designer% Hier hat der Designer etwas geschrieben. %Nichtraucher% Nicht nachts am Rechner Rauchen! %der designer% Hallo, ich bin %strike%überhaupt nicht%% glücklich Sie zu treffen. |
Alle Schrift auf einem hellrosa Hintergrund zeigt einen Kommentar von Pm? an. Hier hat der Designer etwas geschrieben. Nicht nachts am Rechner Rauchen! Hallo, ich bin überhaupt nicht glücklich Sie zu treffen. |
Stile können auf fast alle Arten von Blöcken angewendet werden:
* %block bgcolor=yellow% Hier ist ein Listenpunkt * Da gibt's einen anderen Listenpunkt. * Hier gibts noch mehr von der Liste # Eine neue Liste |
|
Outlines sind mit vordefinierten %ROMAN%, %roman%, %ALPHA%, und %alpha% Listenblockstilen möglich. Der Stil muss auf das erste Listenmerkmal in der Liste definiert werden (und möglicherweise entwickeln wir eine andere Syntax für diese Art gegliederter Listen):
# %ROMAN% Obere Ebene ## %ALPHA% Zweite Ebene ## Zweite Ebene ## Zweite Ebene ### Dritte Ebene ### Dritte Ebene ## Zweite Ebene ### Dritte Ebene #### %alpha% Vierte Ebene ##### %roman% Fünfte Ebene ##### Fünfte Ebene #### Vierte Ebene # Obere Ebene # Obere Ebene |
|
Wikistile können mit CSS Stylesheets kombiniert werden, um dies zu automatisieren (Siehe Cookbook:OutlineLists).
Wie erzeugt man einen vorformatierten text mit farbigen Hintergrund und Umrandung?
Man verwendet in etwa so etwas:
%block bgcolor=#f0f9ff border='1px solid gray' padding=5px%[@ ip access-list extended example-acl remark ** This is an example acl ** deny ip any host 10.0.0.1 permit ip any any @] |
ip access-list extended example-acl remark ** This is an example acl ** deny ip any host 10.0.0.1 permit ip any any |
<< Wikistile | Dokumentationsindex | Direktiven >>