Ko¹ík obsahuje %red% tøe¹nì, %blue% borùvky, %purple% mango, %green% limetky, %% a dal¹í.

I'd like to have some %color=#ff7f00% tangerines%%,  too!

Tato vìta obsahuje %bgcolor=green yellow% ¾lutý text na zeleném pozadí.

%p bgcolor=#ffeeee% Pou¾ití wikistylu, který zaèíná na prvním øádku odstavce a je pou¾it a¾ do konce, pøesto¾e %blue% je zde následnì pou¾itý jiný styl%%, který by jinak zpùsobil ukonèení jeho platnosti .

>>blue font-style:italic bgcolor=#ffffcc<<
V¹e od tohoto øádku bude modrou kurzívou,

To zahrnuje
    pevnì formátovaný text
* seznamy
-> odsazené polo¾ky
>><<

    pevnì formátovaný text

(:div style="font-style:italic; border:1px solid blue; background-color:#ffffcc; color:green":)
V¹e od tohoto øádku je zelenou kurzívou,

Zahrnuje to
    pevnì formátovaný text
* seznamy
-> odsazené polo¾ky
(:divend:)

    pevnì formátovaný text

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

    Speciální: define, apply

Atributy prvních dvou sloupcù odpovídají cascading style sheet (CSS) vlastnostem stejného jména. Atributy tøetího sloupce je mo¾né aplikovat pouze na vybrané polo¾ky:

• class= a id= pøiøazuje CSS tøídu nebo identifikuje HTML element
• target=name otevírá odkaz v rámu "name"
• rel=name in a link identifies the relationship of a target page
• accesskey=x pøiøazuje 'x' jako klávesovou zkratku pro následující odkaz
• value=9 nastavuje poèet polo¾ek uspoøádaného seznamu

* Atributy width a height jsou vyèlenìny pro tag obrázkù <img .../>. Pøi pou¾ití bez parametru "apply=" urèují vý¹ku a ¹íøku nìjakého obrázku <img ... /> který následuje. Jinak nastavují 'width:' a 'height:' vlastnosti stylovaného elementu.

Pou¾ití wikistylù na bloky?

Normálnì se wikistyly pou¾ijí na úsek textu, ale atribut apply= umo¾òuje roz¹íøit úèinnost stylu na dal¹í prvky. Pøeddefinované hodnoty apply= jsou:

Oznaèené hvìzdièkou mají definované také zkratky, tedy %p color=blue% má stejný význam jako %apply=p color=blue%, a %list ROMAN% se shoduje s %apply=list list-style=upper-roman%.

Nìkteré zkratky wikistylù v sobì zahrnují atribut apply=, jako %right% je zkratka pro %text-align=right apply=block%.

Pou¾ití wikistylu se projeví pouze pokud je pou¾it v první øádce úseku, který má být formátován; jinými slovy pou¾ití wikistylu na tøetím øádku odstavce nemù¾e zmìnit jeho barvu textu:

zde je odstavec textu
a pokud se pokusíme
pou¾ít wikistyl %apply=p color=blue% 
a zmìnit barvu textu, 
neuspìjeme, nebo» zmìna je zaznamenána a¾ po
zaèátku odstavce.

Naopak, tento %p color=red% odstavec
''bude'' èervený, nebo» blokový styl
byl pou¾it ji¾ v prvním øádku.

* Toto je seznam
* %list red% Oops, pozdì na ovlivnìní seznamu!

Povolení stylování

Styly neuvedené vý¹e mù¾e PMWiki Adminstrator povolit zmìnou souboru local/config.php. Pro povolení atributu"line-height" pøidá øádku:

    $WikiStyleCSS[] = 'line-height';

to the local/config.php file.

U¾ivatelské styly

Atribut define= umo¾ní propojit zkratku s jakýmkoli wikistylem, zároveò mù¾e být pou¾it pro definování dal¹ího wikistylu.

%define=box block bgcolor=#ddddff border="2px dotted blue"%

%box% [@
$ echo "Hello world"
Hello World
$ exit
@]

%box font-weight=bold color=green% [@
$ echo "I said, HELLO"
@]

$ echo "Hello world"
Hello World
$ exit

$ echo "I said, HELLO"

Tip: Je vhodné umístit u¾ivatelskou definici stylù do stránky Group Header?, èím¾ se stane platná pro v¹echny stránky skupiny. Nebo wiki administrator? mù¾e pøeddefinovat styly, local customization? (viz Custom Wiki Styles).

Tip: Dobrým zvykem je také stylování podle významu textu. Pokud budete chtít napøíklad zobrazovat dùle¾itá sdìlení na va¹ich stránkách zelenì, definujte %define=dulezite green% a pou¾ívejte v dokumentech %dulezite% namísto %green%. A¾ se vám pozdìji zelená znelíbí, bude výraznì jednodu¹¹í zmìnit (jednu) definici stylu ne¾ v¹echny výskyty %green% celého webu.

Tip: Jakýkoli nedefinovaný WikiStyl je automaticky uchopen jako odkaz na tøídu, tedy %pre% je shodné s %class=pre%.

Pøeddefinované styly

PmWiki definuje následující styly.

• Barva textu: black, white, red, yellow, blue, gray, silver, maroon, green, navy, purple (shortcut for %color=...%)
• Zarovnání textu: %center% and %right%
• Obrázky a objekty
  • Plovoucí vlevo èi vpravo: %rfloat% and %lfloat%
  • Rámce: %frame%, %rframe%, and %lframe%
  • Nastavení jako miniatura: %thumb%
• Otevøení odkazu v novém oknì: %newwin% (shortcut for %target=_blank%)
• Komentáøe: %comment% (shortcut for %display=none%)
• Seznamy: %decimal%, %roman%, %ROMAN%, %alpha%, %ALPHA% (viz také Cookbook:OutlineLists)

Pøíklady

Pøíklady Wiki stylù obsahuje øadu pøíkladù pou¾ití wikistylù na stránkách.

Známé problémy

• Procenta zapisovaná v definici stylù (like: %block width=50% %) je nutno zapisovat "pct" místo "%".

Odkazy

• Custom Wiki Styles
• Block markup?
• List Styles Typy stylù pou¾itelných ve wikiseznamech

<< Tabulkové direktivy | Index dokumentace | Pøíklady WikiStylù >>

(:div class="frame green" style="font-size:smaller":)
This text should be small, green, and surrounded by a frame
(:divend:)

(:div class="blue rframe" style="font-size:smaller":)
This text should be small, blue, and surrounded by a right floated frame
(:divend:)