====== 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 'PHP Logo !'; echo 'Un logo generato da PHP:'; echo 'PHP Logo !'; **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]]//