DokuWiki supporta del semplice linguaggio di formattazione, che rende comodamente leggibili i file di dati. Questa pagina contiene tutta la sintassi possibile che si può usare quando si modificano le pagine. Si può dare un'occhiata al codice sorgente di questa pagina premendo il bottone Modifica questa pagina nel Menu di sinistra. Se volete fare qualche prova, usate la pagina sandbox. La formattazione più semplice è facilmente accessibile anche attraverso i Pulsanti di accesso rapido.

DokuWiki supporta testi in grassetto, corsivo, sottolineato ed equispaziato. Naturalmente tutti questi si possono combinare.

DokuWiki supporta testi in **grassetto**, //corsivo//, __sottolineato__ ed ''equispaziato''.
Naturalmente tutti questi si possono **__//''combinare''//__**.

Si possono usare anche _pedice e ^apice.

Si possono usare anche <sub>pedice</sub> e <sup>apice</sup>.

Inoltre si può contrassegnare qualcosa come cancellato.

Inoltre si può contrassegnare qualcosa come <del>cancellato</del>.

I paragrafi sono creati da linee vuote. Se si vuole forzare un ritorno a capo senza un paragrafo, si possono usare due barre retroverse seguite da uno spazio bianco o dalla fine di una linea.

Questo è del testo con qualche interruzione di linea
Notare che le due barre retroverse sono riconosciute soltanto alla fine di una linea
oppure quando seguite da
uno spazio bianco \\ecco cosa succede senza di questo.

Questo è del testo con qualche interruzione di linea\\ Notare che le
due barre retroverse sono riconosciute soltanto alla fine di una linea\\
oppure quando seguite da\\ uno spazio bianco \\ecco cosa succede senza di questo.

I ritorni a capo forzati dovrebbero essere usati solo quando realmente necessario.

DokuWiki supporta diversi modi per la creazione di collegamenti.

I collegamenti esterni sono riconosciuti automaticamente: http://www.google.com o semplicemente www.google.com

- Si possono impostare anche i nomi dei collegamenti: Questo collegamento punta a Google.

- Gli indirizzi di posta elettronica come questo: andi@splitbrain.org sono pure riconosciuti.

DokuWiki supporta diversi modi per la creazione di collegamenti. I collegamenti esterni sono riconosciuti
automaticamente: http://www.google.com o semplicemente www.google.com
- Si possono impostare anche i nomi dei collegamenti: [[http://www.google.com|Questo collegamento punta a Google]].
- Gli indirizzi di posta elettronica come questo: <andi@splitbrain.org> sono pure riconosciuti.

I collegamenti interni sono creati usando le parentesi quadre. Si può usare Pagenames o, in alternativa, usare un Testo del titolo aggiuntivo. I nomi delle pagine del Wiki sono convertiti automaticamente in minuscolo, i caratteri speciali non sono consentiti.

I collegamenti interni sono creati usando le parentesi quadre. Si può usare [[wiki:pagename]]
o, in alternativa, usare un [[wiki:pagename|Testo del titolo]] aggiuntivo. I nomi delle pagine
del Wiki sono convertiti automaticamente in minuscolo, i caratteri speciali non sono consentiti.

Si può specificare wiki:namespaces usando i due punti (:) nel nome della pagina.

Si può specificare [[doku>wiki:namespaces]] usando i due punti (:) nel nome della pagina.

Per i dettagli riguardo le categorie (namespaces) vedere wiki:namespaces.

È pure possibile realizzare collegamenti a una specifica sezione. È sufficiente aggiungere il nome della sezione dietro un carattere diesis (#), come è noto dall'HTML. Questo collegamento punta a questa sezione.

Questo collegamento punta a [[sintassi#interni|questa sezione]].

Note:

• I collegamenti a pagine esistenti sono visualizzati con uno stile differente da quelle inesistenti
  (come potete vedere dai 2 differenti colori).
• DokuWiki non usa la sintassi :it:CamelCase per creare collegamenti in modo predefinito, ma questo comportamento può essere abilitato nel file wiki:config. Suggerimento: se DokuWiki è un collegamento, allora esso è abilitato.
• Quando l'intestazione di una sezione è modificata, anche il suo segnalibro (bookmark) cambia. Pertanto non bisogna fare troppo affidamento sui collegamenti alle sezioni.

Dokuwiki supporta i collegamenti Interwiki. Si tratta di collegamenti rapidi ad altri Wiki. Per esempio, questo collegamento punta alla pagina di Wikipedia riguardante i Wiki: :it:Wiki.

Dokuwiki supporta i collegamenti [[doku>wiki:interwiki|Interwiki]]. Si tratta di collegamenti rapidi ad altri Wiki.
Per esempio, questo collegamento punta alla pagina di Wikipedia riguardante i Wiki: [[wp>:it:Wiki]].

Si possono personalizzare le iconcine (per vedere quelle da noi usate andare qui) che dirigono il lettore a queste pagine esterne, facilitandolo anche visivamente nel dove lo si sta mandando nel web. Ad esempio:

Wiki italiano

Corriere della sera

e così via.
Per far questo basta avere la favicon del sito che ci interessa e salvarla in formato PNG o GIF con le misure 16×16 e metterla nel cassetto lib/images/interwiki dandogli il nome appropriato.
Poi creare con un buon e semplice Editor di testo il file interwiki.local.conf, scriverci il nome appropriato e l'indirizzo web del sito e metterlo nel cassetto conf.

Tornando all'esempio del Corriere della sera:

• abbiamo salvato la favicon, l'abbiamo trasformata in formato PNG col nome cor.png e l'abbiamo messa in lib/images/interwiki
• abbiamo creato il file interwiki.local.conf e ci abbiamo scritto al primo rigo
  cor http://www.corriere.it/
  e lo abbiamo messo nel cassetto conf

da questo momento tutti i link a pagine del Corriere avranno la sua immagine.

Naturalmente nel file interwiki.local.conf aggiungeremo via via gli altri interwiki usando un rigo alla volta.
Il file porta, non a caso, il nome di “local” in quanto è il nostro personale file che si differenzia da quello che già si ha di default da DokuWiki, in modo che se un domani si aggiorna la versione il nostro sarà sempre lì.

Nota bene:
quando si fa questo la iconcina non si vede a causa della cache del Wiki.
Leggere qui come abbiamo risolto.

Le partizioni Windows come questa sono pure riconosciute. Notare che esse hanno un senso soltanto in un gruppo omogeneo di utenti come in una :it:Intranet aziendale.

Le partizioni Windows come [[\\server\share|questa]] sono pure riconosciute.

Note:

• Per ragioni di sicurezza la navigazione diretta di partizioni Windows funziona solo in Microsoft Internet Explorer, in modo predefinito (e soltanto nella “zona locale”).
• Per Mozilla e Firefox questa può essere abilitata mediante l'opzione di configurazione security.checkloaduri ma non è raccomandata.
• Vedere 151 per maggiori informazioni.

Si può anche usare un'immagine per creare un collegamento a un'altra pagina, interna o esterna, combinando la sintassi per i collegamenti e immagine come questa:

[[http://www.php.net|{{wiki:dokuwiki-128.png}}]]

http://www.php.net

Notare: la formattazione dell'immagine è l'unica sintassi di formattazione accettata nei nomi dei collegamenti.

L'intera sintassi immagine e collegamento è supportata (incluso il ridimensionamento, immagini interne ed esterne e i collegamenti di tipo URL e Interwiki).

Si possono aggiungere note a piè di pagina ¹⁾ usando parentesi doppie.

Si possono aggiungere note a piè di pagina ((Questa è una nota a piè di pagina)) usando parentesi doppie.

Andando in fondo pagina la leggerete, ma ricordarsi che le “note” sono leggibili anche andando col puntatore sopra al numeretto che viene creato!

Si possono usare fino a cinque differenti livelli di intestazione per strutturare un contenuto. Se si hanno più di tre intestazioni, una tabella dei contenuti è generata automaticamente - ciò può essere disabilitato includendo la stringa ~~NOTOC~~ nel documento.

==== Livello di intestazione 3 ====
=== Livello di intestazione 4 ===
== Livello di intestazione 5 ==

Usando quattro o più trattini, si può fare una linea orizzontale:

Si possono includere immagini esterne e interne mediante parentesi graffe. In alternativa, se ne possono specificare le dimensioni.

Dimensione reale:

Ridimensionata a una larghezza data:

Ridimensionata a larghezza e altezza date:

Immagine esterna ridimensionata:

Dimensione reale:                          {{wiki:dokuwiki-128.png}}
Ridimensionata a una larghezza data:       {{wiki:dokuwiki-128.png?50}}
Ridimensionata a larghezza e altezza date: {{wiki:dokuwiki-128.png?200x50}}
Immagine esterna ridimensionata:           {{http://de3.php.net/images/php.gif?200x50}}

Usando spazi vuoti a sinistra o a destra si può scegliere l'allineamento.

{{ wiki:dokuwiki-128.png}}  - spazio vuoto a sinistra e l'immagine andrà a destra
{{wiki:dokuwiki-128.png }}  - spazio vuoto a destra e l'immagine andrà a sinistra
{{ wiki:dokuwiki-128.png }} - spazio vuoto a sinistra e a destra e l'immagine andrà al centro

Naturalmente, si può aggiungere anche un titolo visualizzabile (come suggerito dalla maggior parte dei programmi di navigazione).

{{ wiki:dokuwiki-128.png |Questa è la didascalia}}
basta andare col puntatore sulla immagine per leggerla

nota bene
in questo ultimo caso lo spazio vuoto a sinistra è quello vicino alle graffe, mentre quello a destra è quello vicino al segno | (pipe) prima della didascalia!

Se si specifica il nome di un file (esterno o interno) che non è un'immagine (gif, jpeg, png), allora questo sarà visualizzato come collegamento.

Per collegare un'immagine a un'altra pagina, vedere Collegamenti a immagini qui sopra.

Dokuwiki supporta liste ordinate e non-ordinate. Per creare un elemento di una lista, indentare il testo con due spazi e usare un asterisco (*) per le liste non ordinate oppure un trattino (-) per quelle ordinate.

• Questa è una lista
• Il secondo elemento
  • Si possono avere livelli differenti
• Un altro elemento

1. La stessa lista ma ordinata
2. Un altro elemento
   1. Usare semplicemente l'indentazione per ottenere livelli più profondi
3. È tutto

  * Questa è una lista
  * Il secondo elemento
    * Si possono avere livelli differenti
  * Un altro elemento

  - La stessa lista ma ordinata
  - Un altro elemento
    - Usare semplicemente l'indentazione per ottenere livelli più profondi
  - È tutto

DokuWiki converte le :it:emoticon comunemente usate nei rispettivi equivalenti grafici. Ulteriori smileys possono essere messi nella directory smiley e configurati nel file conf/smileys.conf. Ecco un riepilogo degli smiley inclusi in DokuWiki.

• 8-)
• 8-O
• :-(
• :-)
• =)
• :-/
• :-\
• :-?
• :-D
• :-P
• :-O
• :-X
• :-|
• ;-)
• ^_^
• :?:
• :!:
• LOL
• FIXME
• DELETEME

DokuWiki riesce a convertire semplici caratteri testuali nelle rispettive entità tipograficamente corrette. Ecco un esempio dei caratteri riconosciuti.

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

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

Notare: queste conversioni possono essere disabilitate mediante una opzione di configurazione e un file di entità.

Talvolta si vuole evidenziare del testo per mostrare che esso è una risposta o un commento. Si può usare la sintassi seguente:

Penso che dovremmo farlo

> No, non dovremmo  

>> Be', dico che dovremmo  

> Davvero?  

>> Sì!  

>>> Allora facciamolo!  

Penso che dovremmo farlo

No, non dovremmo

Be', dico che dovremmo

Davvero?

Sì!

Allora facciamolo!

Come vedete qui abbiamo 3 interlocutori che si fanno riconoscere col semplice uso di uno o più simboli di maggiore (>).

DokuWiki supporta una semplice sintasi per la creazione di tabelle.

Le righe delle tabelle devono iniziare e terminare con un carattere | per le righe normali o con il carattere ^ per le intestazioni.

^ Intestazione 1 ^ Intestazione 2  ^ Intestazione 3      ^
| Riga 1 Col 1   | Riga 1 Col 2    | Riga 1 Col 3        |
| Riga 2 Col 1   | colonne fuse (notare il doppio pipe) ||
| Riga 3 Col 1   | Riga 2 Col 2    | Riga 2 Col 3        |

Per collegare le celle orizzontalmente, è sufficiente rendere completamente vuota la cella successiva come mostrato sopra. Assicurarsi di avere sempre lo stesso numero totale di separatori di celle!

È pure possibile realizzare intestazioni di tabella verticali.

Come si può notare, è il separatore di cella prima di una cella che decide il tipo di formattazione:

|                 ^ Intestazione 1              ^ Intestazione 2     ^
^ Intestazione 3  | Riga 1 Col 2                | Riga 1 Col 3       |
^ Intestazione 4  | niente fusione questa volta |                    |
^ Intestazione 5  | Riga 2 Col 2                | Riga 2 Col 3       |

Nota: le fusioni verticali di celle (rowspan) non sono possibili.

Si può allineare anche il contenuto di una tabella. È sufficiente aggiungere almeno due spazi bianchi al lato opposto del testo: aggiungere due spazi a sinistra per allineare a destra, due spazi a destra per allineare a sinistra e almeno due spazi ad entrambi i lati per il testo centrato.

Ecco come appare nel testo sorgente:

^         Tabella con allineamento         ^^^
|        destra|    centro    |sinistra      |
|sinistra      |        destra|    centro    |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |

È possibile includere blocchi non analizzati sintatticamente nei documenti sia indentandoli con almeno due spazi (come usato per gli esempi precedenti), sia usando i marcatori (tag) code o file.

Questo è codice preformattato e tutti gli spazi sono preservati: come              <-questo

Questo è pressapoco la stessa cosa, ma potrebbe essere usato per mostrare che è stato citato un file.

Per consentire all'analizzatore sintattico di ignorare completamente un'area (per es. per non fare alcuna formattazione in essa), racchiudere l'area con i marcatori nowiki o, più semplicemente, con un doppio segno di percentuale %%.

Questo è del testo che contiene indirizzi come questo: http://www.splitbrain.org e **formattazione**, ma niente è applicato.

Vedere il testo sorgente di questa pagina per capire come usare questi blocchi.

DokuWiki può evidenziare codice sorgente in modo da renderlo più facile da leggere. Esso usa GeSHi (Generic Syntax Highlighter, evidenziatore di sintassi generica) - in questo modo qualsiasi linguaggio supportato da GeSHi è accettato. La sintassi è la stessa del blocco di codice nella sezione precedente, ma questa volta il nome del linguaggio usato è inserito all'interno del marcatore (tag). Per es. <code java>.

/** 
 * La classe HelloWorldApp implementa una applicazione che
 * visualizza semplicemente "Hello World!" in uscita.
 */
class HelloWorldApp {
    public static void main(String[] args) {
        System.out.println("Hello World!"); //Visualizza la stringa.
    }
}

Le seguenti stringhe di identificazione di linguaggio sono attualmente riconosciute: abap actionscript-french, actionscript, ada, apache, applescript, asm, asp, autoit, bash, blitzbasic, bnf, caddcl, cadlisp, cfdg, cfm, c_mac, c, cpp, cpp-qt, csharp, css, delphi, diff, div, dos, dot, d, eiffel, fortran, freebasic, genero, gml, groovy, haskell, html, idl, ini, inno, io, java5, java, javascript, latex, lisp, lua, m68k, matlab, mirc, mpasm, mysql, nsis, objc, ocaml-brief, ocaml, oobas, oracle8, pascal, perl, per, php-brief, php, plsql, python, qbasic, rails, reg, robots, ruby, sas, scheme, sdlbasic, smalltalk, smarty, sql, tcl, text, thinbasic, tsql, vbnet, vb, vhdl, visualfoxpro, winbatch, xml, xpp, z80

DokuWiki può integrare dati da sorgenti esterne XML. Per l'analisi sintattica delle sorgenti XML è usato SimplePie. Tutti i formati riconosciuti da SimplePie possono pure essere usati in DokuWiki. Si può modificare la visualizzazione mediante diversi parametri separati da uno spazio:

Il periodo di aggiornamento predefinito è di 4 ore. Ogni valore al di sotto di 10 minuti sarà considerato come 10 minuti. Generalmente DokuWiki cercherà di fornire una versione della pagina memorizzata localmente; ciò è ovviamente inappropriato quando la pagina contiene del contenuto esterno dinamico. Il parametro dice a DokuWiki di visualizzare nuovamente la pagina se è trascorso un tempo superiore a periodo di aggiornamento dall'ultima volta che la pagina è stata visualizzata.

Esempio

{{rss>http://slashdot.org/index.rss 5 author date 1h }}  

• HDD Price Update: How the Thai Floods Have Affected Prices, 3 Months Later da Soulskill (08/02/2012 02:19)
• Pasadena Police Encrypt, Deny Access To Police Radio da Soulskill (08/02/2012 00:15)
• 4G Phones Are Really Fast — At Draining Batteries da Soulskill (07/02/2012 22:11)
• Ask Slashdot: Making JavaScript Tolerable For a Dyed-in-the-Wool C/C++/Java Guy? da Soulskill (07/02/2012 20:10)
• Should Next-Gen Game Consoles Be Upgradeable? da Soulskill (07/02/2012 19:30)

Esempi italiani

• Corriere della sera

• <a href="http://lettura.corriere.it/">La politica separata dalla scienza|</a> (08/02/2012 02:35)
• Ritratti italiani. D &#039;autore da Giuseppe Di Piazza (08/02/2012 02:29)
• Falcao allena la squadra di Jorge Amado E incrocia Cerezo per un amarcord giallorosso da Redazione Online (08/02/2012 02:26)
• Carabiniere spara alla moglie e si uccide davanti alle due figlie di 12 e 6 anni da Redazione Online (08/02/2012 02:25)
• Maldive, il presidente si dimesso Forze di polizia occupano la tv di Stato da Redazione Online (08/02/2012 02:23)
• <a href="http://bergamo.corriere.it/bergamo/notizie/cronaca/12_febbraio_7/yara-dna-prova-1903183493942.shtml">Yara: dal Dna spunta una nuova pista Individuato un profilo interessante</a> (08/02/2012 02:22)
• Bocciato lo spot di Celentano Invitava a cambiare canale da Renato Franco (08/02/2012 02:09)
• Barroso insiste: Atene resti nell&#039;euro da Redazione Online (08/02/2012 02:06)

• La Stampa

• Droga, stroncato maxi-traffico Olanda-Italia &quot;In una settimana piazzavano cinquanta chili&quot; da DANIELA LANNI (AGB) (08/02/2012 01:35)
• Maltempo, allarme economia I morti per il gelo salgono a 40 da F. SCHIANCHI, G. LONGO (08/02/2012 01:35)
• Primarie Usa la tripletta di Santorum da MAURIZIO MOLINARI (08/02/2012 01:35)
• Moretti: &quot;Ecco perchè le Fs non potevano fare di più. Anche all'estero chiudono le linee&quot; da INTERVISTA DI PAOLO BARONI (08/02/2012 01:35)
• Blitz anti-camorra, indagato un neomelodico &quot;Nelle canzoni per i boss un invito a delinquere&quot; da ANTONIO SALVATI (08/02/2012 01:35)
• Legge elettorale, intesa Pdl-Pd: no a nominati da UGO MAGRI (08/02/2012 01:35)
• Monti a Obama: &quot;Un patto con l'Ue&quot; da MAURIZIO MOLINARI (08/02/2012 01:35)
• Torino, viaggio nel gigante di Piano il palazzo un gradino sotto la Mole da GUIDO TIBERGA (08/02/2012 01:35)

E, così facendo, ogni volta che verrete qui potrete leggere le ultimissime.
Noteremo anche che i webmaster di questi grandi giornali non è che abbiano capito bene quello che fanno e così spesso vedremo errori nel codice.

Si può incapsulare codice HTML o PHP all'interno dei documenti mediante l'uso dei tag html o php come segue:

<html>
Questo è un po' di <span style="color:red;font-size:150%;">HTML incapsulato</span>
</html>
<HTML>
<p style="border:2px dashed red;">E questo è un blocco HTML</p>
</HTML>

Questo è un po' di HTML incapsulato

E questo è un blocco HTML

Nota bene:
l'incapsulamento di HTML e PHP è disabilitato in modo predefinito, nella configurazione. Se disabilitato, il codice è visualizzato invece di essere eseguito.

Basta scrivere

----

4 trattini consecutivi

Qui sotto, essendo finita la pagina, vedete l'esempio di Note a piè di pagina.