authors (basic)
Concetti di base
I Wiki styles permettono agli autori di modificare lo stile del testo.
Uno stile si scrive usando il carattere percento; ad esempio: %red% oppure %bgcolor=lightblue%.
L'uso più immediato degli stili wiki è la modifica di alcune proprietà del testo, come il colore, lo sfondo e il font. PmWiki fornisce una serie di stili per cambiare il colore del testo:%black%, %white%, %red%, %yellow%, %blue%, %gray%, %silver%, %maroon%, %green%, %navy%, and %purple%.
Nel cesto ci sono %red% mele, %blue% mirtilli, %purple% melanzane, %green% lime %% e altro.
| Nel cesto ci sono mele, mirtilli, melanzane, lime e altro.
|
Per colori diversi da quelli predefiniti si deve usare lo stile %color=...%. (Nota: i colori specificati come RGB (#rrggbb) devono essere sempre scritti con lettere minuscole, per evitare conflitti con WikiWord?.)
Vorrei anche qualche %color=#ff7f00% arancia rossa%%!
| Vorrei anche qualche arancia rossa!
|
Per cambiare il colore di sfondo bisogna usare il wikistyle %bgcolor=...%:
Questa frase contiene %bgcolor=green yellow% testo giallo su sfondo verde.
| Questa frase contiene testo giallo su sfondo verde.
|
Si veda Colori con stili wiki per ulteriori informazioni sui colori.
Campi di applicazione
Gli stili sono caratterizzati da un campo di validità. Normalmente, uno stile si applica al testo che ne segue la definizione, fino all'applicazione di un altro stile o alla fine del paragrafo. È possibile specificare un campo di applicazione alternativo, per applicare lo stile a:
- un intero paragrafo (
%p ...%),
- un'intera lista (
%list ...%),
- l'elemento di una lista (
%item ...%), o
- qualunque blocco (
%block ...%).
I campi appena mostrati sono scorciatoie per l'attributo "apply=", discusso più avanti.
%p bgcolor=#ffeeee% Lo stile specificato all'inizio di questa linea si applica all'intero paragrafo, anche se %blue% altri stili %% sono specificati nello stesso paragrafo.
|
Lo stile specificato all'inizio di questa linea si applica all'intero paragrafo, anche se altri stili sono specificati nello stesso paragrafo.
|
Il blocco >>style<< può essere usato per applicare uno stile wiki a un blocco. Questo stile viene interrotto dal successivo >><<.
>>blue font-style:italic bgcolor=#ffffcc<<
Tutto questo viene scritto in blu e in corsivo,
Quindi anche
testo preformattato
* liste
-> elementi rientrati
>><<
|
Tutto questo viene scritto in blu e in corsivo,
Quindi anche
testo preformattato
elementi rientrati
|
La direttiva (:div style:) funziona quasi come >>style<<, ma le informazioni sullo stile sono inserite nell'attributo HTML style="".
(:div class="green" style="font-style:italic; border:1px solid blue; background-color:#ffffcc":)
Tutto questo testo è in verde e in corsivo.
Quindi anche
testo preformattato
* liste
-> elementi rientrati
(:divend:)
|
Tutto questo testo è in verde e in corsivo.
Quindi anche
testo preformattato
elementi rientrati
|
Gli stili wiki si possono applicare anche a Tabelle e Direttive per tabelle
||class="green" style="font-style:italic; border:1px solid blue; background-color:#ffffcc"
||Tutto questo è in verde e in corsivo. ||
|| ||
||Quindi anche ||
|| testo preformattato ||
||* liste ||
||-> elementi rientrati ||
| | Tutto questo è in verde e in corsivo. |
| |
| Quindi anche |
| testo preformattato |
| * liste |
| -> elementi rientrati |
|
(:table class="green" style="font-style:italic; border:1px solid blue; background-color:#ffffcc":)
(:cellnr:)
Tutto questo è in verde e in corsivo.
Quindi anche
testo preformattato
* liste
-> elementi rientrati
(:tableend:)
| |
Tutto questo è in verde e in corsivo.
Quindi anche
testo preformattato
elementi rientrati
|
|
Attributi
Nella specifica di uno stile sono riconosciuti i seguenti attributi:
| ------------- 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 |
Gli attributi elencati nelle prime due colonne corrispondono alle proprietà dei fogli di stile CSS (cascading style sheet). Gli attributi nella terza colonna si applicano solo ad alcuni elementi:
class= e id= assegnano una classe o un id CSS a un elemento HTML
target=name fa aprire i link in una finestra del browser chiamata "name"
rel=name in un link definisce la relazione con la pagina di destinazione
accesskey=x imposta il tasto 'x' come scorciatoia per i link che seguono
value=9 imposta il numero dell'elemento corrente in una lista numerata.
* Gli attributi "width" e "height" sono indicati con asterischi perché hanno un valore speciale nel caso di tag <img .../>. Se usati da soli (cioè senza il parametro "apply="), allora impostano i parametri omonimi di tutte i tag <img ... /> che seguono. Altrimenti impostano le proprietà omonime dell'elemento a cui si stà applicando lo stile.
Applicare stili a blocchi
Un wikistyle si applica normalmente a una serie di linee di testo; l'attributo apply= permette di applicarlo a qualcos'altro. I valori predefiniti per apply= sono:
| apply=img | applica a tutte le immagini che seguono | |
| apply=p | applica al paragrafo corrente | * |
| apply=pre | applica al testo preformattato corrente | |
| apply=list | applica alla lista corrente | * |
| apply=item | applica all'elemento corrente della lista | * |
| apply=div | applica al <div> corrente | |
| apply=block | applica al blocco corrente, sia esso
un paragrafo, preformattato, una lista, un titolo
o un <div>. | * |
Gli elementi contrassegnati con un asterisco hanno alcune scorciatoie già definite; quindi %p color=blue% è lo stesso che %apply=p color=blue%, e %list ROMAN% vale come %apply=list list-style=upper-roman%.
Alcune scorciatoie includono "apply", come ad esempio %right% corrisponde a %text-align=right apply=block%.
Un wikistile con "apply" ha effetto solo se si trova nella prima linea di ciò che esso deve modificare. In altre parole, un wikistyle nella terza linea di un paragrafo non può modificare quest'ultimo:
questo paragrafo è
diviso su più linee, quindi se vogliamo
%apply=p color=blue% cambiare il suo colore
a metà non ci riusciamo, perché lo stile
è specificato quando il paragrafo è già
iniziato.
| questo paragrafo è
diviso su più linee, quindi se vogliamo
cambiare il suo colore
a metà non ci riusciamo, perché lo stile
è specificato quando il paragrafo è già
iniziato.
|
Questo paragrafo, invece, %p color=red%
''diventa'' rosso, perché lo stile di blocco è inserito
nella prima linea del testo.
| Questo paragrafo, invece,
diventa rosso, perché lo stile di blocco è inserito
nella prima linea del testo.
|
* Elemento di una lista
* %list red% Ops, è troppo tardi per modificare tutta la lista!
| - Elemento di una lista
- Ops, è troppo tardi per modificare tutta la lista!
|
Abilitare gli stili
L'amministratore di PmWiki può abilitare altri stili, che non siano quelli descritti finora. Per fare questo bisogna modificare il file local/config.php. Per esempio, è possibile abilitare l'attributo "line-height" aggiungendo la linea:
$WikiStyleCSS[] = 'line-height';
al file suddetto.
Scorciatoie personalizzate
L'attributo define= si può usare per definire scorciatoie per qualunque stile.
Questa scorciatoia può essere usata successivamente:
%define=box block bgcolor=#ddddff border="2px dotted blue"%
%box% [@
$ echo "Ciao mondo"
Ciao mondo
$ exit
@]
%box font-weight=bold color=green% [@
$ echo "Ho detto CIAO"
@]
|
$ echo "Ciao mondo"
Ciao mondo
$ exit
$ echo "Ho detto CIAO"
|
Suggerimento: Utilizzate gli stili personalizzati per associare un significato al testo, anziché solo un colore. Per esempio, se gli avvertimenti devono essere mostrati in verde, definite
%define=warn green% e quindi usate
%warn% nel documento, anziché
%green%. Così facendo, se doveste cambiare idea in futuro, sarà molto più facile aggiornare gli stili di tutti gli avvertimenti: basterà modificare una sola definizione!
Suggerimento: Un WikiStyle non definito viene automaticamente trattato come una richiesta di una classe. Ad esempio, %pre% ha lo stesso effetto che %class=pre%.
Scorciatoie predefinite
PmWiki definisce un gran numero di scorciatoie.
- Colore del testo: black, white, red, yellow, blue, gray, silver, maroon, green, navy, purple (scorciatoie per
%color=...%)
- Allineamento:
%center% and %right%
- Immagini e riquadri
- Flottanti a destra e sinistra:
%rfloat% and %lfloat%
- Testo incorniciato:
%frame%, %rframe%, and %lframe%
- Anteprima rimpicciolita:
%thumb%
- Link che si aprono in una nuova finestra:
%newwin% (scorciatoia per %target=_blank%)
- Commenti:
%comment% (shortcut for %display=none%)
- Liste ordinate:
%decimal%, %roman%, %ROMAN%, %alpha%, %ALPHA% (si veda anche Cookbook:OutlineLists)
Esempi
Esempi di stili wiki contiene numerosi esempi.
Problemi conosciuti
- I segni percentuali nelle definizioni degli stili (ad esempio:
%block width=50% %) devono essere scritti "pct" anziché "%".
Altri riferimenti
<< Markup per blocchi | Indice documentazione | Esempi di stili wiki >>
