Ti trovi in: Benvenuto su Poigps Wiki » wiki » Sintassi dei formati
array(2) { [0]=> string(82) " : https://svn.debugger.ru/repos/common/DokuWiki/Indexmenu2/tags/Indexmenu2.v2.0.3" [1]=> string(6) "v2.0.3" }
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:

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:

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 d

i 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 livello 3

Intestazione di livello 4

Intestazione di livello 5
==== Intestazione di livello 3 ==== 
=== Intestazione di livello 4 === 
== Intestazione di livello 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.

Dimensione reale:

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).

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.

  1. Come sopra, ma ordinata
  2. Secondo elemento
    1. Usa l’identazione per evere più livelli
  3. 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.

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>

Questo è < font color="red" size="+1">HTML 

 
<php> 
echo 'Un logo generato da PHP:'; 
echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />'; 
</php> 

 
echo 'Un logo generato da PHP:'; 
echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="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 Poigps Wiki è 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:

1) This is a footnote