Codex

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

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

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

  • liste
elementi rientrati

Attributi

Nella specifica di uno stile sono riconosciuti i seguenti attributi:

------------- CSS --------------- HTML --
colorbgcolorclass
background-colormarginid
text-alignpaddinghspace
text-decorationbordervspace
font-sizefloattarget
font-familylist-stylerel
font-weightwidth*accesskey
font-styleheight*value
Speciali: define, apply

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=imgapplica a tutte le immagini che seguono 
apply=papplica al paragrafo corrente*
apply=preapplica al testo preformattato corrente 
apply=listapplica alla lista corrente*
apply=itemapplica all'elemento corrente della lista*
apply=divapplica al <div> corrente 
apply=blockapplica 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"
@]
Suggerimento: Spesso è una buona idea inserire gli stili più usati nelle pagine Group Header?, in modo da condividerli con tutte le pagine di un gruppo. In alternativa, il wiki administrator? può inserire stili validi per tutto il sito attraverso un file di local customization? (si veda Stili wiki personalizzati).
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 >>

Alcuni colori non funzionano! Ad esempio %color=#AAAAAA% funziona, ma %color=#AA3333% no. Perché?

Attenzione a usare solo lettere minuscole per specificare colori RGB in esadecimale. Altrimenti, PmWiki potrebbe pensare che si tratti di WikiWord?.

Perché questo non funziona?

(:div class="blue rframe" style="font-size:smaller":)
Questo testo dovrebbe essere piccolo, blu e circondato da una cornice flottante a destra.
(:divend:)

Questo testo dovrebbe essere piccolo, blu e circondato da una cornice flottante a destra.

Perché rframe non è una class.

(:div class="blue rfloat frame" style="font-size:smaller":)
Questo testo dovrebbe essere piccolo, blu e circondato da una cornice flottante a destra.
(:divend:)

Questo testo dovrebbe essere piccolo, blu e circondato da una cornice flottante a destra.


Traduzione di PmWiki.WikiStyles - Pagina originale: PmWikiIt.WikiStyles - Links de retorno
Ultime modifiche:
PmWikiIt.WikiStyles: 10 de setembro de 2011, às 12:52
PmWiki.WikiStyles: 04 de agosto de 2015, às 07:04