====== Sintassi dei formati ======
[[wiki: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 [[playground:playground|pagina delle prove]]. I marcatori più usat i sono accessibili anche attraverso i pulsanti[[doku>wiki:quickbuttons|quickbuttons]].
===== 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 indici e apici.
Puoi anche segnare qualcosa come cancellato.
Puoi anche segnare qualcosa come cancellato.
**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: [[http://www.google.com|Questo collegamento rimanda a Google]].
Sono riconosciuti anche i collegamenti a caselle di posta elettronica 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 come questo.
==== Interni ====
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.
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 [[wiki: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 [[doku>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 [[syntax#interni|questa sezione]].
Questo collegamento rimanda a [[syntax#interni|questa sezione]].
Note:
* I collegamenti a [[wiki:syntax|pagine esistenti]] sono mostrati in modo diverso dai collegamenti a [[wiki:nonexisting|pagine non esistenti]].
* DokuWiki non usa [[wp>CamelCase]] per creare automaticamente collegamentima questa funzione può essere attivata nel file [[doku>config]] file. Osservazione: If DokuWiki è un collegamento, allora la funzione è abilitata.
* 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 [[doku>wiki:interwiki|Interwiki]]. Sono collegamenti veloci ad altri Wiki. Per esempio questo è un collegamento alla pagina sui Wki di Wikipedia: [[wp>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 [[\\server\share|questa]]. Per cortesia tenete presente che questo ha senso solo in una lan locale o un ambiente [[wp>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 [[http://www.mozilla.org/quality/networking/docs/netprefs.html#file|security.checkloaduri]] ma non è raccomandato
* Vedi [[bug>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 [[#images_and_other_files|le immagini]] (vedi più avanti) come in questo esempio:
[[http://www.php.net|{{wiki:dokuwiki-128.png}}]]
[[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'[[#images_and_other_files|immagine]] e dei [[#links|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 ((This is a footnote)) 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 [[doku>images]] immagini interne ed esterne con le parentesi graffe. Potete specifdicare opzionalmente la loro dimensione.
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}}
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}}
{{wiki:dokuwiki-128.png }}
{{ wiki:dokuwiki-128.png }}
Naturalmente potete aggiungere un titolo (visualizzato da molti browser).
{{ wiki:dokuwiki-128.png |Questo è un titolo}}
{{ 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 [[wp>emoticon]]s 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-) %%
* 8-O %% 8-O %%
* :-( %% :-( %%
* :-) %% :-) %%
* =) %% =) %%
* :-/ %% :-/ %%
* :-\ %% :-\ %%
* :-? %% :-? %%
* :-D %% :-D %%
* :-P %% :-P %%
* :-O %% :-O %%
* :-X %% :-X %%
* :-| %% :-| %%
* ;-) %% ;-) %%
* ^_^ %% ^_^ %%
* :?: %% :?: %%
* :!: %% :!: %%
* LOL %% LOL %%
* FIXME %% FIXME %%
* DELETEME %% DELETEME %%
===== Tipografia =====
[[DokuWiki]] sa convertire alcune sequenze di caratteri di testo nel loro equivalente tipografico. Ecco un esempio dei caratteri riconosciuti.
-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"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 [[doku>wiki:config#typography|opzioni di configurazione]] e un [[doku>wiki:entities|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 [[http://qbnz.com/highlighter/|GeSHi]] Generic Syntax Highlighter -- così ogni linguaggio supportato da GeSHi è supportato. La sintassi è la stessa come nel marcatore
della sezione precedente ma questa volta viene inserito il nome del linguaggio dentro al marcatore . Per es. ''
''.
/**
* 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'':
Questo è HTML
Questo è HTML
echo 'Un logo generato da PHP:';
echo '';
echo 'Un logo generato da PHP:';
echo '';
**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 [[doku>wiki:plugins|Plugins]]. Come si usano i plugin installati è descritto nelle loro pagine di descrizione. In questa installazione sono disponibili i seguenti plugin:
~~INFO:syntaxplugins~~
----
--- //[[start|vai alla pagina indice della documentazione del sito]]//\\
--- //[[:start|vai alla pagina indice di WikiKarli]]//