Beispiele zu Wikistilen

für die Liste aller Seiten

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

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.

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.  

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.

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.  

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.

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%
%define=strike text-decoration=line-through%

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

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

Gliederungen sind mit vordefinierten %ROMAN%, %roman%, %ALPHA%, und %alpha% Listenblockstilen möglich. Der Stil muss für 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).

Q&A

Wie erhalte ich einen Block mit vorformatiertem Text?

>>white-space=pre<<
Dieser Testblock ist ''vorformatiert'', sehen Sie,   all die       Leerzeichen
und     Zeilenumbrüche
bleiben erhalten. Verweise wie [[wiki styles|+]] funktionieren auch.
>><<

Wie erhalte ich einen vorformatierten Text mit farbigen Hintergrund und Umrandung?

%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

Wie erhalte ich einen Textblock (einschließlich Wiki-Markup) mit farbigem Hintergrund und Umrandung?

>>teal background-color:silver border:'medium dotted green'<<
Hallo Welt
* Knöpfchen
# Nummer
>><<

Wie bekommen ich einen Textblock (einschließlich Wiki-Markup) mit Umrandung, der links eingerückt ist und nicht bis ganz rechts reicht? Ich bin nicht daran interessiert, später Text an der rechten Seite zu haben, wie er bei lfloat erscheint ...

Vor der Einrückung ...
>>frame indent width=50pct<<
Hallo Welt
* Knöpfchen
# Nummer
>><<
... nach der Einrückung!

für die Liste aller Seiten