Stili wiki

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.

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

Per cambiare il colore di sfondo bisogna usare il wikistyle %bgcolor=...%:

Questa frase contiene %bgcolor=green yellow% 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.

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

    testo preformattato

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

    testo preformattato

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

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

    testo preformattato

Attributi

Nella specifica di uno stile sono riconosciuti i seguenti attributi:

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.

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:

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, invece, %p color=red%
''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!

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:

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"

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

• Stili wiki personalizzati
• Markup per blocchi Questa pagina descrive tutte le possibili combinazioni di markup per blocchi
• Stili per gli elenchi Stili per gli elenchi

<< Markup per blocchi | Indice documentazione | Esempi di stili wiki >>