Wiki styly

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