Sintassi

Il wiki ingloba un semplice linguaggio di marcatori per formattare il testo. Questa pagina contiene la sintassi da usare nell'editing delle pagine. Puoi dare un'occhiata al sorgente di questo documento cliccando su “modifica questa pagina” nella parte alta della pagina.

Formattazione di base del testo

Ciò che appare nei riquadri è il codice per formattare il testo usato nel sorgente della pagina. Sotto, il risultato ottenuto per ogni sintassi utilizzata.

 testo in **grassetto**

testo in grassetto

 testo in //corsivo//

testo in corsivo

 testo in ''monospazio''

testo in monospazio

 testo in <sup>apice</sup> 

testo in apice

 testo in <sub>pedice</sub>

testo in pedice

 testo <del>cancellato</del>

testo cancellato

I paragrafi sono creati da righe vuote. Se vuoi forzare un “a capo” senza creare un paragrafo, puoi usare due barre inverse (\\) seguite da uno spazio o dalla fine della riga. Dovresti forzare un “a capo” solo se è veramente indispensabile.

Questo è un testo con degli “a capo”
Nota che due barre inverse sono riconosciute solo alla fine di una riga
o seguite da
uno spazio \\questo succede se non ce lo metti.

 Questo è un testo con degli "a capo"\\ Nota che
 due barre inverse sono riconosciute solo alla fine di una riga\\
 o seguite da\\ uno spazio \\questo succede se non ce lo metti.

È possibile pure la quotazione del testo

Questa è la domanda

Risposta 1
Risposta 2
Risposta 3
 Questa è la domanda
 > Risposta 1
 >> Risposta 2
 >>> Risposta 3

Collegamenti

In DokuWiki ci sono vari modi per creare collegamenti (links).

Collegamenti esterni

I collegamenti esterni sono magicamente riconosciuti da soli: http://www.google.it o semplicemente www.google.it Si possono aggiungere anche i nomi ai collegamenti: Questo collegamento porta a Google. Sono pure riconosciuti gli indirizzi email come questo: admin@compagniadelgiardinaggio.it

 I collegamenti esterni sono magicamente riconosciuti da soli: 
 http://www.google.it o semplicemente www.google.it
 Si possono aggiungere anche i nomi ai collegamenti: 
 [[http://www.google.it|Questo collegamento porta a Google]]. 
 Sono pure riconosciuti gli indirizzi email come questo: <admin@compagniadelgiardinaggio.it>

Collegamenti interni

I collegamenti interni sono creati usando doppie parentesi quadre. Ad esempio, per creare un collegamento interno alla scheda sulla Gardenia:

 [[piante:Gardenia]]

Potete anche usare un titolo aggiuntivo, ad esempio: scheda sulla Gardenia.

 [[piante:gardenia|scheda sulla Gardenia]].

I collegamenti con le pagine esistenti sono mostrati in verde, mentre quelli alle non esistenti sono in rosso. Ad esempio, non esiste la scheda della Pianta Nettuno:

 [[piante:Pianta Nettuno]]

I nomi di pagina (pagenames) sono convertiti automaticamente in minuscole, i caratteri speciali non sono consentiti.

È possibile pure il collegamento ad una specifica sezione. Semplicemente aggiungi il nome della sezione dopo il carattere cancelletto come avviene in HTML. Questo è un collegamento a questa sezione.

 Questo è un collegamento [[wiki:syntax#collegamenti|a questa sezione]].

Interwiki

DokuWiki riconosce i collegamenti interwiki. Questi sono collegamenti veloci ad altri Wiki. Per esempio, questo è un collegamento alla pagina di Wikipedia sulla Gardenia: Gardenia.

 DokuWiki riconosce i collegamenti [[doku>wiki:interwiki|Interwiki]]. 
 Questi sono collegamenti veloci ad altri Wiki. 
 Per esempio, questo è un collegamento alla pagina di Wikipedia sulla Gardenia: [[wp>Gardenia]].

Collegamenti tramite immagini

Puoi usare anche collegamenti con dimmagini ad altre pagine sia interne che esterne combinando la sintassi per i collegamenti con quella per le immagini (vedi in seguito) come segue:

 [[http://wiki.splitbrain.org|{{wiki:dokuwiki-128.png}}]]

Nota bene: la formattazione delle immagini è l'unica formattazione ammessa nei nomi dei collegamenti.

Note a piè di pagina

Puoi inserire note a piè di pagina 1) usando una doppia parentesi.

Puoi inserire note a piè di pagina ((Questa è una nota a piè di pagina)) usando una doppia parentesi.

Sezioni

Si possono usare fino a cinque differenti livelli di intestazione per strutturare i contenuti. Se ci sono più di tre intestazioni viene generato automaticamente un indice – questo può essere disabilitato inserendo la stringa ~~NOTOC~~ nel documento.

Intestazione livello 3

Intestazione livello 4

Intestazione livello 5
==== Intestazione livello 3 ====
=== Intestazione livello 4 ===
== Intestazione livello 5 ==

Usando quattro lineette si fa una linea orizzontale:


Immagini

Si possono includere immagini esterne ed interne usando le parentesi graffe. Volendo si può specificare anche la loro dimensione.

 Dimensioni reali:                              {{wiki:dokuwiki-128.png}}
 Ridimensionamento a larghezza data:            {{wiki:dokuwiki-128.png?50}}
 Ridimensionamento a larghezza ed altezza data: {{wiki:dokuwiki-128.png?200x50}}
 Ridimensionamento di immagine esterna:         {{http://de3.php.net/images/php.gif?200x50}}

Utilizzando gli spazi a destra o a sinistra si può scegliere l'allineamento:

{{ wiki:dokuwiki-128.png}}
{{wiki:dokuwiki-128.png }}
{{ wiki:dokuwiki-128.png }}

Naturalmente si può aggiungere anche un nome all'immagine (che viene mostrato nella maggioranza dei browsers con una scritta fluttuante)

Questo è il nome dell'immagine

{{ wiki:dokuwiki-128.png |Questo è il nome dell'immagine}}

Se si specifica il nome di un file (interno o esterno) che non sia una immagine(gif,jpeg,png), in tal caso verrà mostrato come collegamento.

Liste

Dokuwiki utilizza liste numerate e non numerate. Per creare un elemento di una lista, occorre indentare il testo di due spazi ed usare un * per le liste non numerate e un - per quelle numerate.

  • Questa è una lista
  • Il secondo elemento
    • Si possono avere differenti livelli
  • Un altro elemento
  1. La stessa lista numerata
  2. Un altro elemento
    1. Usa l'indentazione per livelli più profondi
  3. Ecco fatto
  * Questa è una lista
  * Il secondo elemento
    * Si possono avere differenti livelli
  * Un altro elemento

  - La stessa lista numerata
  - Un altro elemento
    - Usa l'indentazione per livelli più profondi
  - Ecco fatto

Caratteri speciali

DokuWiki può convertire semplici caratteri di testo nei loro corretti equivalenti tipografici. Ecco un esempio di caratteri riconosciuti:

→ ← ↔ ⇒ ⇐ ⇔ » « – — 640×480 © ™ ® “He thought 'It's a man's world'…”

-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"He thought 'It's a man's world'..."

Tabelle

DokuWiki ha una sintassi semplice per costruire delle tabelle.

Titolo 1 Titolo 2 Titolo 3
Riga 1 Col 1 Riga 1 Col 2 Riga 1 Col 3
Riga 2 Col 1 unione celle (nota la doppia barra)
Riga 3 Col 1 Riga 2 Col 2 Riga 2 Col 3

Le righe di una tavola iniziano con | per le righe normali o con ^ per le intestazioni.

 ^ Titolo 1        ^ Titolo 2         ^ Titolo 3            ^
 | Riga 1 Col 1    | Riga 1 Col 2     | Riga 1 Col 3        |
 | Riga 2 Col 1    | unione celle (nota la doppia barra)   ||
 | Riga 3 Col 1    | Riga 2 Col 2     | Riga 2 Col 3        |

Per collegare le celle in orizzontale basta lasciare completamente vuota la cella successiva come mostrato qui sopra. Accertatevi che ci sia sempre lo stesso numero di separatori!

Sono possibili anche delle intestazioni verticali nelle tabelle.

Titolo 1 Titolo 2
Titolo 3 Riga 1 Col 2 Riga 1 Col 3
Titolo 4 niente unione, stavolta
Titolo 5 Riga 2 Col 2 Riga 2 Col 3

Come si può notare, è il separatore di cella che sta davanti alla cella a decidere la formattazione:

 |              ^ Titolo 1                ^ Titolo 2          ^
 ^ Titolo 3     | Riga 1 Col 2            | Riga 1 Col 3      |
 ^ Titolo 4     | niente unione, stavolta |                   |
 ^ Titolo 5     | Riga 2 Col 2            | Riga 2 Col 3      |

Nota: Unioni verticali di celle non sono possibili.

E' pure possibile allineare i contenuti della tabella. Semplicemente aggiungendo almeno due spazi dalla parte opposta del testo: aggiungendo due spazi alla sinistra per allineare a destra, due spazi a destra per allineare a sinistra e due spazi almeno da entrambe le parti per centrare il testo.

Tabella allineata
destra centro sinistra
sinistra destra centro
xxxxxxxxxxxx xxxxxxxxxxxx xxxxxxxxxxxx

This is how it looks in the source:

^           Tabella allineata              ^^^
|        destra|    centro    |sinistra      |
|sinistra      |        destra|    centro    |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
1) Questa è una nota a piè di pagina

Tools personali