Hauptseite | Hilfe | Wikistile


Wikistile

Grundlagen

Wikistile erlauben es Ihnen, die Farbe und andere Merkmale eines Seiteninhalts zu verändern. Ein Wikistil wird von Prozentzeichen eingerahmt wie z. B. bei %red% oder %bgcolor=blue%. Wikistile werden meist zum Ändern von Textattributen wie Farbe, Hintergrundfarbe und Schriftart verwendet. Die Pm Wiki -Software definiert bereits einige Wikistile für die Veränderung der Farbe: %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 verwenden Sie bitte den %color=...% Wikistil. Hinweis: RGB-Farben (#rrggbb) sollten dabei immer mit Kleinbuchstaben definiert werden, damit sie nicht versehentlich als WikiWort? erkannt werden.

Ich hätte auch gerne noch %color=#ff7f00% Mandarinen%%!

Ich hätte auch gerne noch

Mandarinen
!

Auch die Hintergrundfarbe von Flächen und Texten können Sie verändern: mit dem Wikistil %bgcolor=...%.

Dieser Satz enthält %bgcolor=green yellow% gelben Text auf grünem
Hintergrund. 

Dieser Satz enthält

gelben Text auf grünem Hintergrund.

Gültigkeitsbereiche

Wikistile können auch einen Gültigkeitsbereich angeben. Wenn Sie keinen Gültigkeitsbereich angeben, wird der Wikistil dem nachfolgenden Text bis zum nächsten Wikistil oder bis zum Ende des Absatzes zugewiesen, je nachdem, was zuerst kommt (ein neuer Absatz oder ein neuer Wikistil). Wenn Sie einen Gültigkeitsbereich angegeben, gilt dieser Wikistil für einen Absatz (%p ...%), eine Liste (%list ...%), einem Listeneintrag (%item ...%) oder für einen Block (%block ...%).

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

Der >>style<< kann für die Zuweisung eines Wikistils für einen größeren Bereich verwendet werden. Der Wikistil wird dann bis zum nächsten >><< verwendet.

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

Das beinhaltet
    vorformatierten Text,
* Listen und
-> eingerückte Zeilen.
>><<

Alles nach der obigen Zeile ist mit blauem, kursivem Text geschrieben.

Das beinhaltet

    vorformatierten Text,
  • Listen und
eingerückte 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 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

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

Tip: Meist ist es eine gute Idee, gemeinsame eigene Wikistildefinitionen in den Kopfzeilen der Wikigruppe? 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.

Ein weiterer Tip: Verwenden Sie bei der Definition von Wikistilen 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 Warnungen vielleicht doch anders dargestellt werden sollen. Es ist viel einfacher, eine Definition (%warn%) anstatt vieler (%green%) zu ändern.

Vordefinierte Stilkurznamen

Das Pm Wiki -System definiert einige Wikistilkurznamen:

  • Textfarben: black, white, red, yellow, blue, gray, silver, maroon, green, navy, purple (Kurznamen für: %color=...%)
  • Ausrichtung: %center%, %left% und %right%
  • Bilder und Rahmen
    • linken oder rechten Textumfluss: %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%. Weitere vordefinierte Wikistilkurznamen für nummerierte Listen finden Sie auch unter Cookbook:Outline Lists? .

Beispiele

Hier einige weitere Beispiele für Wikistile, wie sie in Seiten eingesetzt werden können.

Pm Wiki benutzt Wikistile als Mechanismus, um Text mit Farbe und anderen Eigenschaften zu gestalten. Die hier verwendete Pm Wiki 2.0-Version ermöglicht weitere Stile und die Anwendung auf Blöcke. Die Grundlagen der Wikistile haben sich nicht verändert: Grundsätzlich wird ein Wikistil 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 einige Kürzel (Shortcuts) festlegen, indem er die define=-Eigenschaft zu Hilfe nimmt. Um beispielsweise einen Wikistil 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 Wikistilen 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.

Pm Wiki kann neuerdings Wikistile 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 Wikistil erst in der Zeilenmitte auftaucht. 
%bgcolor=pink% Andere Inline (Nicht-Block) Wikistile können in der Mitte
der Textzeile sichtbar werden,%% und nach diesem (Nicht-Block) Wikistil
geht´s weiter wie vor seinem Einschub in den Block.

Der gesamte Block hat einen gelben Hintergrund, selbst wenn der Wikistil erst in der Zeilenmitte auftaucht.

Andere Inline (Nicht-Block) Wikistile können in der Mitte der Textzeile sichtbar werden,
und nach diesem (Nicht-Block) Wikistil geht´s 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 Pm Wiki 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.

Sie können jederzeit auch 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.

Sie können Wikistile auf fast alle Arten von Blöcken anwenden:

* %block bgcolor=yellow% Hier ist ein Listenpunkt
* Da gibt's einen anderen Listenpunkt.

* Hier gibt´s noch mehr von der Liste

# Eine neue Liste
  • Hier ist ein Listenpunkt
  • Da gibt's einen anderen Listenpunkt.
  • Hier gibt´s noch mehr von der Liste
  1. Eine neue Liste

Auch Outlines sind mit vordefinierten %ROMAN%, %roman%, %ALPHA%, und %alpha% Listenblockstilen möglich. Der Wikistil muss auf das erste Listenmerkmal in der Liste definiert werden:

# %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
  1. Obere Ebene
    1. Zweite Ebene
    2. Zweite Ebene
    3. Zweite Ebene
      1. Dritte Ebene
      2. Dritte Ebene
    4. Zweite Ebene
      1. Dritte Ebene
        1. Vierte Ebene
          1. Fünfte Ebene
          2. Fünfte Ebene
        2. Vierte Ebene
  2. Obere Ebene
  3. Obere Ebene

Wikistile können mit CSS-Stylesheets kombiniert werden. Sie finden unter Cookbook:OutlineLists? Hinweise, wie das zu automatisieren ist.

Auch die Erzeugung vorformatierten Textes mit farbigem Hintergrund und Umrandung ist kein Problem, das geht etwa so:

%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

Bekannte Probleme

  • Prozentzeichen funktionieren in den Wikistildefinitionen (z.B.: %block width=50% %) derzeit nicht, da sie nicht von der Endmarkierung der Wikistildefinition unterschieden werden können.


Hauptseite | Hilfe | Wikistile



FacebookTwitThis
Pin ItMister Wong