Wiki styly umo¾òují mìnit barvu a jiné vlastnosti obsahu stránek. Wiki styly se zapisují uzavøené znaménky procent, tedy %red% nebo %bgcolor=blue%.
Základní pou¾ití stylù je pro zmìnu atributù textu jako je barva textu, barva pozadí, font písma. PmWiki definuje nìkolik stylù pro zmìnu barev %black%, %white%, %red%, %yellow%, %blue%, %gray%, %silver%, %maroon%, %green%, %navy%, and %purple%.
Ko¹ík obsahuje %red% tøe¹nì, %blue%
borùvky, %purple% mango, %green%
limetky, %% a dal¹í.
Ko¹ík obsahuje tøe¹nì, borùvky, mango, limetky, a dal¹í.
Pro dal¹í barvy mimo tyto základní pou¾ijte wikistyl %color=...%. (Poznámka: RGB barvy (#rrggbb) v¾dy udávejte malými písmeny, abyste zamezili chybné interpretaci jako Wiki Slova?).
I'd like to have some %color=#ff7f00%
tangerines%%, too!
I'd like to have some tangerines, too!
Pro zmìnu pozadí pou¾ijte wikistyl %bgcolor=...%:
Tato vìta obsahuje %bgcolor=green
yellow% ¾lutý text na zeleném
pozadí.
Wikistyly je mo¾né definovat s urèeným rozsahem. Bez urèení rozsahu je styl aplikován na jakýkoli následující text a¾ do konce odstavce nebo do pou¾ití jiného stylu. Zahrnutím definice rozsahu je mo¾no urèit pou¾ití stylu na celý odstavec (%p ...%), na celý seznam (%list ...%), na polo¾ku uvnitø seznamu (%item ...%), nebo na celý blok block ? (%block ...%). Tyto rozsahy jsou pøeddefinovanými zkratkami pro atribut "apply=", popsaném ní¾e.
%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 .
Pou¾ití wikistylu, který zaèíná na prvním øádku odstavce a je pou¾it a¾ do konce, pøesto¾e je zde následnì pou¾itý jiný styl, který by jinak zpùsobil ukonèení jeho platnosti .
Pro oznaèení velkého úseku textu pou¾ijte znaèku>>style<<; jí definovaný styl bude platit a¾ do ukonèení znaèkou >><<.
>>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
>><<
V¹e od tohoto øádku bude modrou kurzívou,
To zahrnuje
pevnì formátovaný text
seznamy
odsazené polo¾ky
Znaèka(:div style:) plní ve vìt¹inì pøípadù stejnou funkci jako >>style<<,
ale informace je umístìna do atributu style=""
(: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:)
V¹e od tohoto øádku je zelenou kurzívou,
Zahrnuje to
pevnì formátovaný text
seznamy
odsazené polo¾ky
Atributy
Ve specifikaci wikystylù jsou zahrnuty následující atributy:
------------ 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í (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.
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:
apply=img
pou¾ije se na jakýkoli následující obrázek
apply=p
pou¾ije se na souèasný odstavec
*
apply=pre
pou¾ije se na souèasný pevnì formátovaný text
apply=list
na seznam
*
apply=item
na polo¾ku seznamu
*
apply=div
na odstavec div
apply=block
pou¾ije styly na aktuální blok, a» se jedná o odstavec, seznam, polo¾ku seznamu, heading nebo division.
*
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.
zde je odstavec textu
a pokud se pokusíme
pou¾ít wikistyl
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.
Naopak, tento 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!
Toto je seznam
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.
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%.
