Informazioni sulla privacy

Strumenti Utente

Strumenti Sito


wiki:sintassi

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.

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.
  • DokuWiki non usa CamelCase per creare automaticamente collegamentima questa funzione può essere attivata nel file 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 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.

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.

  • Questa è una lista
  • Secondo elemento
    • Puoi avere più livelli
  • Un altro elemento
  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.

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

→ ← ↔ ⇒ ⇐ ⇔ » « – — 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</font>

<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 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:


vai alla pagina indice della documentazione del sito
vai alla pagina indice di WikiKarli

1)
This is a footnote
Queste pagine web fanno uso dei cookies. Usando queste pagine tu accetti che alcuni cookies siano memorizzati sul tuo computer. Usando queste pagine, inoltre, tu accetti di aver letto e compreso le nostre regole sulla privacy. Se non condividi queste regole ti chiediamo di lasciare questa pagina. In questa pagina trovi maggiori informazioni sul nostro uso dei cookies e la nostra gestione della privacy.
wiki/sintassi.txt · Ultima modifica: 21-03-2020 04:24 (modifica esterna)