Indice
Sintassi dei formati
DokuWiki fornisce un semplice linguaggio a marcatori, che cerca di rendere i testi il più leggibili possibile. Qui trovi le indicazioni sulla sintassi che devi usare quando scrivi o modifichi una pagina. Basta che tu dia uno sguardo al sorgent di questa pèagina premendo il pulsante Modifica questa pagina posto sia in cima che in fondo alla pagina. Se vuoi provare qualcosa, usa la pagina delle prove. I marcatori più usat i sono accessibili anche attraverso i pulsantiquickbuttons.
Formattazione di base del testo
DokuWiki supporta testi in grassetto, in corsivo, sottolineati e monospaziati
. Naturalmente tu puoi combinarli
tutti tra di loro.
DokuWiki supporta testi **in grassetto**, //in corsivo//, __sottolineati__ and ''monospaziati''. Naturalmente tu puoi **__//''combinarli''//__** tutti tra di loro.
Puoi usare anche indici e apici.
Puoi usare anche <sub>indici</sub> e <sup>apici</sup>.
Puoi anche segnare qualcosa come cancellato.
Puoi anche segnare qualcosa come <del>cancellato</del>.
I paragrafi sono realizzati mediante righe vuote. Se desideri forzare una riga nuova senza un paragrafo, puoi usare due barre rovesciate
seguite da uno spazio bianco o da un a capo.
Questo è un testo con delle interruzioni di riga
Nota che
le due barre rovesciate sono riconosciute solo alla fine della riga
o se seguite da
uno spazio. \\Senza lo spazio succede così.
Questo è un testo con delle interruzioni di riga\\ Nota che le due barre rovesciate sono riconosciute solo alla fine della riga\\ o se seguite da\\ uno spazio. \\Senza lo spazio succede così.
Si dovrebbero usare i comandi di a capo solo se effettivamente necessari.
Collegamenti (Links)
DokuWiki ha molti modi per realizzare collegamenti.
Esterni
I collegamenti esterni sono riconosiuti da Dokuwiki in modo automagico: http://www.google.com o semplicemente www.google.com - È possibile mettere anche dei testi: Questo collegamento rimanda a Google. Sono riconosciuti anche i collegamenti a caselle di posta elettronica andi@splitbrain.org come questo.
I collegamenti esterni sono riconosiuti da Dokuwiki in modo automagico: http://www.google.com o semplicemente www.google.com - È possibile mettere anche dei testi: [[http://www.google.com|Questo collegamento rimanda a Google]]. Sono riconosciuti anche i collegamenti a caselle di posta elettronica <andi@splitbrain.org> come questo.
Interni
I collegamenti interni sono realizzati con parentesi quadre. Puoi semplicemente dare un wiki:pagename o usare un Titolo del testo addizionale. I nomi delle pagine Wiki sono convertiti in maniera automatica in carattere minuscolo, non sono ammessi caratteri speciali.
I collegamenti interni sono realizzati con parentesi quadre. Puoi semplicemente dare un [[doku>wiki:pagename]] o usare un [[doku>wiki:pagename|Titolo del testo]] addizionale. I nomi delle pagine Wiki sono convertiti in maniera automatica in carattere minuscolo, non sono ammessi caratteri speciali.
Puoi usare namespaces mettendo un doppio punto nel nome della pagina.
Puoi usare [[wiki:namespaces]] mettendo un doppio punto nel nome della pagina.
Per i dettagli puoi vedere wiki:namespaces.
È possibile anche colegarsi ad una specifica sezione. Basta aggiungere un nome di sezione dietro ad un carattere di diesis, analogamente all'HTML.
Questo collegamento rimanda a questa sezione.
Questo collegamento rimanda a [[syntax#interni|questa sezione]].
Note:
- I collegamenti a pagine esistenti sono mostrati in modo diverso dai collegamenti a pagine non esistenti.
- Se si cambia il titolo di una sezione cambia anche l'indirizzo di collegamento, perciò non affidatevi troppo ai collegamenti di sezione.
Interwiki
DokuWiki è in grado di gestire anche collegamenti Interwiki. Sono collegamenti veloci ad altri Wiki. Per esempio questo è un collegamento alla pagina sui Wki di Wikipedia: Wiki.
DokuWiki è in grado di gestire anche collegamenti [[doku>wiki:interwiki|Interwiki]]. Sono collegamenti veloci ad altri Wiki. Per esempio questo è un collegamento alla pagina sui Wki di Wikipedia: [[wp>Wiki]].
Condivisioni di Windows
Sono riconosciute anche le condivisioni Windows come questa. Per cortesia tenete presente che questo ha senso solo in una lan locale o un ambiente Intranet.
Sono riconosciute anche le condivisioni Windows come [[\\server\share|questa]].
Note:
- Per ragioni di sicurezza la navigazione diretta di condivisioni windows funziona soltanto in Microsoft Internet Explorer per default (e solo nella “zona locale”).
- Per Mozilla and Firefox può essere abilitato con la configurazione security.checkloaduri ma non è raccomandato
- Vedi 151 per maggiori informazioni
Collegamenti tramite immagini
Con un'immagine ppotete collegarvi ad un altra pagina esterna o interna combinando la sintassi per i collegamenti e le immagini (vedi più avanti) come in questo esempio:
[[http://www.php.net|{{wiki:dokuwiki-128.png}}]]
Prendete nota: la formattazione delle immagini è la sola sintassi di fromato accettata nei nomi dei collegamenti.
É supportata l'intera sintassi dell'immagine e dei collegamenti (compreso il ridimensionamento, le immagini interne ed esterne e i collegamenti URL e interwiki.
Note a piè di pagina
Potete aggiungere note a piè di pagina 1) usando le doppie parentesi.
Potete aggiungere note a piè di pagina ((This is a footnote)) usando le doppie parentesi.
Sezioni
Potete usare fino a cinque diversi livelli di intestazioni per strutturare il vostro documento. Se avete più di tre intestazioni viene generato automaticamente un indice dei contenuti – Questa funzione può essere disabilitata iserendo nel documenti la stringa ~~NOTOC~~
.
Intestazione di levello 3
Intestazione di levello 4
Intestazione di levello 5
==== Intestazione di levello 3 ==== === Intestazione di levello 4 === == Intestazione di levello 5 ==
4 o più segni meno consecutivi ----
producono una linea orizzontale:
Immagini ed altri file
Potete includere images immagini interne ed esterne con le parentesi graffe. Potete specifdicare opzionalmente la loro dimensione.
Ridimensionata ad una certa larghezza:
Ridimensionata ad una certa larghezza ed altezza:
Immagine esterna ridimensionata:
Dimensione reale: {{wiki:dokuwiki-128.png}} Ridimensionata ad una certa larghezza: {{wiki:dokuwiki-128.png?50}} Ridimensionata ad una certa larghezza ed altezza: {{wiki:dokuwiki-128.png?200x50}} Immagine esterna ridimensionata: {{http://de3.php.net/images/php.gif?200x50}}
{{ wiki:dokuwiki-128.png}} {{wiki:dokuwiki-128.png }} {{ wiki:dokuwiki-128.png }}
Naturalmente potete aggiungere un titolo (visualizzato da molti browser).
{{ wiki:dokuwiki-128.png |Questo è un titolo}}
Se specificate un nome di file (esterno o nterno) che non è un'immagine (gif,jpeg,png
), allora esso sarà mostrato come un collegamento.
Per collegare un'immagine ad un'altra pagina si veda la sezione precedente Collegamenti tramite immagini.
Liste
Dokuwiki gestisce liste non ordinate o ordinate. Per creare un elemento di una lista, indenta identa il testo di due spazi e usa un *
per le liste non ordinate o un -
per quelle ordinate.
- Questa è una lista
- Secondo elemento
- Puoi avere più livelli
- Un altro elemento
- Come sopra, ma ordinata
- Secondo elemento
- Usa l'identazione per evere più livelli
- Questo è tutto
* Questa è una lista * Secondo elemento * Puoi avere più livelli * Un altro elemento - Come sopra, ma ordinata - Secondo elemento - Usa l'identazione per evere più livelli - Questo è tutto
Smileys
DokuWiki converte le emoticons usate più di frequente nei loro equivalenti grafici. È possibile aggiungere altre smilies nella directory smiley
e configuraròe nel file conf/smileys.conf
. Ecco una rassegna delle smiley incluse in DokuWiki.
- 8-)
- 8-O
- :-(
- :-)
- =)
- :-/
- :-\
- :-?
- :-D
- :-P
- :-O
- :-X
- :-|
- ;-)
- ^_^
- :?:
- :!:
- LOL
- FIXME
- DELETEME
Tipografia
DokuWiki sa convertire alcune sequenze di caratteri di testo nel loro equivalente tipografico. Ecco un esempio dei caratteri riconosciuti.
→ ← ↔ ⇒ ⇐ ⇔ » « – — 640×480 © ™ ® “Pensò 'It's a man's world'…”
-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) "Pensò 'It's a man's world'..."
Prendete nota: Queste conversioni possono essere disabilitate con opzioni di configurazione e un pattern file.
Citazioni
A volte volete segnare un testo per evidenziare che è una risposta o un commento. Potete usare la seguente sintassi:
Io penso che dovremmo farlo > No non dovremmo >> Bene, io dico che dovremmo > Davvero? >> Sì! >>> E allora facciamolo!
Io penso che dovremmo farlo
No non dovremmo
Bene, io dico che dovremmo
Davvero?
Sì!
E allora facciamolo!
Tabelle
DokuWiki fornisce una semplice sintassi per creare delle tabelle.
Intestazione 1 | Intestazione 2 | Intestazione 3 |
---|---|---|
Riga 1 Col 1 | Riga 1 Col 2 | Riga 1 Col 3 |
Riga 2 Col 1 | Colonna multipla (notare il doppio || ) |
|
Riga 3 Col 1 | Riga 2 Col 2 | Riga 2 Col 3 |
Le righe devono iniziare con un |
per le righe normali o con un ^
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 | Colonna multipla (notare il doppio ''||'') || | Riga 3 Col 1 | Riga 2 Col 2 | Riga 2 Col 3 |
Per fondere le celle orizzontalmente fate le celle successive completamente vuote, come mostrato sopra. Siate sicuri di avere sempre lo stesso numero di separatori di celle!
È possibile inserire anche intesatzioni di colonna.
Intestazione 1 | Intestazione 2 | |
---|---|---|
Intestazione 3 | Riga 1 Col 2 | Row 1 Col 3 |
Intestazione 4 | nessuna colonna multipla stavolta | |
Intestazione 5 | Riga 3 Col 2 | Riga 3 Col 3 |
Come vedete è il separatore davanti alla cella che definisce il formato:
| ^ Intestazione 1 ^ Intestazione 2 ^ ^ Intestazione 3 | Riga 1 Col 2 | Row 1 Col 3 | ^ Intestazione 4 | nessuna colonna multipla stavolta | | ^ Intestazione 5 | Riga 3 Col 2 | Riga 3 Col 3 |
Note: Non è possibile fondere le righe.
Potete allineare i contenuti delle tabelle. Aggiungete almeno due spazi sul lato opposto del vostro testo: due spazi a sinistra per allineare a destra, due spazi a destra per allineare a sinistra, dues spazi a destra e sinistra per centrare il testo.
Tabbella con allineamento | ||
---|---|---|
destra | centro | sinistra |
sinistra | destra | centro |
xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
Ecco come appare nel sorgente:
^ Tabbella con allineamento ^^^ | destra| centro |sinistra | |sinistra | destra| centro | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
Blocchi non analizzati
Potete includere blocchi non analizzati sintatticamente nei vostri documenti sia identandoli di almeno due spazi (come fatto negli esempi prcedenti) o usando i due marcatori code
o file
.
Questo è un codice prformattato; tutti gli spazi sono conservati: come <-qui
Questo è praticamente lo stesso, ma puoi usarlo per mostrare che hai citato un file
Per consentire all'analizzatore di ignorare completamente un'area (cioè senza applicare formati) chiudete l'area tra due marcatori nowiki
o ancora più semplicemente, con un doppio segno di percento %%
.
Questo è un testo che contiene un indirizzo come questo: http://www.splitbrain.org and **un formato grassetto**, ma non viene applicato.
Guardate il sorgente della pagina per vedere come è stato realizzato.
Evidenziare la sintassi
DokuWiki può evidenziare il codice sorgente per facilitarne la lettura. Esso usa il GeSHi Generic Syntax Highlighter – così ogni linguaggio supportato da GeSHi è supportato. La sintassi è la stessa come nel marcatore <code> della sezione precedente ma questa volta viene inserito il nome del linguaggio dentro al marcatore . Per es. <code java>
.
/** * The HelloWorldApp class implements an application that * simply displays "Hello World!" to the standard output. */ class HelloWorldApp { public static void main(String[] args) { System.out.println("Hello World!"); //Display the string. } }
Attualmente sono riconosciuti i seguenti linguaggi: actionscript, actionscript-french, ada, apache, applescript, asm, asp, autoit, bash, blitzbasic, caddcl, cadlisp, c, c_mac, cfm, cpp, csharp, css, delphi, diff, d, div, dos, eiffel, freebasic, gml, html4strict, ini, inno, java, java5, javascript, lisp, lua, matlab, mpasm, mysql, nsis, objc, ocaml, ocaml-brief, oobas, oracle8, pascal, perl, php-brief, php, python, qbasic, scheme, sdlbasic, smarty, sql, tsql, robots, ruby, vb, vbnet, vhdl, visualfoxpro, xml
Inserire HTML e PHP
Potete inserire all'interno del testo codice HTML o PHP usando i marcatori html
o php
:
<html> Questo è <font color="red" size="+1">HTML</font> </html>
<html> Questo è <font color=“red” size=“+1”>HTML</font> </html>
<php> echo 'Un logo generato da PHP:'; echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />'; </php>
<php> echo 'Un logo generato da PHP:'; echo '<img src=“' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '” alt=“PHP Logo !” />'; </php>
Prendete nota: l'inserimento di codice HTML and PHP è disabilitato nella configurazione standard. Se l'inserimento è disabilitato il codice è mostrato invece che eseguito. Su WikiKarli è abilitato HTML, ma non PHP.
Estensioni della sintassi
La sintassi di DokuWiki può essere estesa con dei Plugins. Come si usano i plugin installati è descritto nelle loro pagine di descrizione. In questa installazione sono disponibili i seguenti plugin:
- Gallery Plugin 2023-12-08 da Andreas Gohr
Creates a gallery of images from a namespace or RSS/ATOM feed - Plugin imagebox 2023-08-21 da Lukas Rademacher, CvH, Dr-Yukon, FFTiger & myst6re
Syntax for display an image with a caption, like Wikipedia.org - include plugin 2023-09-22 da Michael Hamann, Gina Häussge, Christopher Smith, Michael Klier, Esther Brunner
Functions to include another page in a wiki page - Open Document Plugin 2023-03-03 da Andreas Gohr, Aurelien Bompard, Florian Lamml, LarsDW223
Export the current Wiki page to a OpenOffice ODT file - Video Sharing Site Plugin 2024-02-28 da Andreas Gohr
Easily embed videos from various Video Sharing sites. Example: {{youtube>XXXXXX}} - Wrap Plugin 2023-08-13 da Anika Henke
Universal plugin which combines functionalities of many other plugins. Wrap wiki text inside containers (divs or spans) and give them a class (choose from a variety of preset classes), a width and/or a language with its associated text direction.
— vai alla pagina indice della documentazione del sito
— vai alla pagina indice di WikiKarli