Strumenti Utente

Strumenti Sito


wiki:syntax
Traduzioni di questa pagina:

Sintassi per la formattazione

DokuWiki supporta un linguaggio semplice per la formattazione, col quale si cerca di rendere il più leggibile possibile i file dei documenti. Questa pagina contiene tutte le regole sintattiche a disposizione per editare il testo. Date un'occhiata alla sorgente di questa pagina premendo il pulsante “Modifica questa pagina”. Se volete provare a scrivere qualcosa usate la pagina playground. Le formattazioni sono facilmente assegnabili anche tramite la barra strumenti.

Questo documento è una traduzione incompleta della pagina relativa in inglese.

Le parti che non sono state tradotte non sono necessarie ai fini del presente manuale; vengono tuttavia lasciate per completezza di informazione.

Formattazione base del testo

DokuWiki supporta testo in grassetto, italico, sottolineato e a spaziatura fissa. Ovviamente questi stili si possono combinare assieme.

DokuWiki supporta testo in **grassetto**, //italico//, __sottolineato__ e ''a spaziatura fissa''.
Ovviamente questi stili si possono **__//''combinare''//__** assieme.

Potete usare deponenti ed esponenti.

Potete usare <sub>deponenti</sub> ed <sup>esponenti</sup>.

Potete anche segnare qualcosa come cancellato.

Potete anche segnare qualcosa come <del>cancellato</del>.

I paragrafi si creano lasciando una riga vuota. Se volete andare a capo senza creare un paragrafo, alla fine della riga scrivete due backslash seguite da uno spazio.

Questo è del testo con alcuni a capo
Si noti che le due backslash vengono riconosciute alla fine di una riga
o quando seguite da
uno spazio \\senza il quale succede questo.

Questo è del testo con alcuni a capo\\ Si noti che le
due backslash vengono riconosciute alla fine di una riga\\
o quando seguite da\\ uno spazio \\senza il quale succede questo.

Forzate gli a capo solo se necessario.

Collegamenti

DokuWiki permette diversi modi per la creazione di collegamenti.

Esterni

I collegamenti esterni sono gestiti automaticamente: http://www.google.com o esmplicemente www.google.com - ma potete comunque assegnare un testo al collegamento: Questo collegamento punta a google. Sono anche riconosciuti indirizzi email come questo: andi@splitbrain.org.

I collegamenti esterni sono gestiti automaticamente: http://www.google.com o esmplicemente www.google.com - ma potete comunque assegnare un testo al collegamento: [[http://www.google.com|Questo collegamento punta a google]]. Sono anche riconosciuti indirizzi email come questo: <andi@splitbrain.org>.

Interni

I collegamenti interni si creano usando le parentesi quadre. Potete sia indicare una pagina sia specificare un testo del collegamento.

I collegamenti interni si creano usando le parentesi quadre. Potete sia indicare una [[pagina]] sia specificare un [[pagina|testo del collegamento]].

I nomi di pagine Wiki sono convertiti automaticamente in caratteri minuscoli e non accettano caratteri speciali.

Potete specificare una categoria inserendo il carattere di due punti nel nome di pagina.

Potete specificare una [[categoria:categoria]] inserendo il carattere di due punti nel nome di pagina.

Per dettagli sulle categorie si veda namespaces.

Potete inoltre fare un collegamento a una specifica sezione. Così come nell'HTML, basta aggiungere il nome della sezione immediatamente dopo il carattere di cancelletto. Questo è un collegamento a questa sezione.

Questo è un collegamento a [[syntax#interni|questa sezione]].

Note:

  • I collegamenti a pagine esistenti vengono mostrati con uno stile diverso dai collegamenti a pagine inesistenti.
  • Di default, DokuWiki non utilizza CamelCase per creare automaticamente collegamenti, ma questa opzione si può abilitare nel file config. Suggerimento: se DokuWiki è un collegamento significa che è abilitata.
  • Se l'intestazione di una sezione cambia, cambia anche il suo riferimento. Non usate troppo i collegamenti diretti alle singole sezioni.

Interwiki

DokuWiki supporta i collegamenti Interwiki. Si tratta di collegamenti rapidi ad altre Wiki. Per esempio, questo è un link alla pagina di Wikipedia che tratta le Wiki: Wiki.

DokuWiki supporta i collegamenti [[doku>Interwiki]]. Si tratta di collegamenti rapidi ad altre Wiki. Per esempio, questo è un link alla pagina di Wikipedia che tratta le Wiki: [[wp>Wiki]].

Condivisioni Windows

Le condivisioni Windows come questa sono riconosciute. Ovviamente hanno senso solo in un gruppo di utenti omogeneo come una Intranet aziendale.

Le condivisioni Windows come [[\\server\share|questa]] sono riconosciute.

Per approfondimenti si veda la sezione Windows Shares (in inglese)

Collegamenti con immagini

Potete usare una immagine come collegamento a una pagina interna o esterna combinando la sintassi dei collegamenti e delle immagini (si veda sotto) come qui:

[[http://www.php.net|{{wiki:dokuwiki-128.png}}]]

Nota: la formattazione dell'immagine è l'unica accettata nei nomi dei collegamenti.

Sono completamente supportate le sintassi dell'immagine e dei collegamenti (inclusi il ridimensionamento dell'immagine, le immagini interne ed esterne e i collegamenti interwiki e a URL).

Note a piè di pagina

Potete aggiungere note a piè di pagina 1) scrivendole tra doppie parentesi tonde.

Potete aggiungere note a piè di pagina ((Questa è una nota a piè di pagina)) scrivendole tra doppie parentesi tonde.

Sezioni

Per strutturare il contenuto potete usare fino a cinque diversi livelli di intestazione. Se avete più di tre intestazioni verrà generata automaticamente una tavola dei contenuti – che può essere rimossa inserendo nel documento 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 ==

Con quattro o più trattini otterrete una linea orizzontale:


Immagini e Altri File

Potete includere immagini esterne e interne usando parentesi graffe. Opzionalmente potete specificare la loro dimensione.

Dimensione reale:

Ridimensionamento a una data larghezza:

Ridimensionamento a larghezza e altezza date 2):

Immagine esterna ridimensionata:

Dimensione reale:                             {{wiki:dokuwiki-128.png}}
Ridimensionamento a una data larghezza:       {{wiki:dokuwiki-128.png?50}}
Ridimensionamento a larghezza e altezza data: {{wiki:dokuwiki-128.png?200x50}}
Immagine esterna ridimensionata:              {{http://de3.php.net/images/php.gif?200x50}}

Potete scegliere l'allineamento inserendo spazi a destra o sinistra.

{{ wiki:dokuwiki-128.png}}
{{wiki:dokuwiki-128.png }}
{{ wiki:dokuwiki-128.png }}

Potete aggiungere un titolo (mostrato dalla maggioranza dei browser come un suggerimento).

Questa è la didascalia

{{ wiki:dokuwiki-128.png |Questa è la didascalia}}

Se il nome del file (esterno o interno) non è un'immagine (gif, jpeg, png), allora il file verrà mostrato come un collegamento.

Per usare un'immagine come collegamento a un'altra pagina si veda Collegamenti con immagini sopra.

Elenchi

Dokuwiki supporta elenchi numerati e puntati. Per creare un elemento dell'elenco fate rientrare il testo con due spazi e usate * per gli elenchi puntati o - per i numerati.

  • Questo è un elenco
  • Il secondo elemento
    • Potete avere diversi livelli
  • Un altro elemento
  1. Lo stesso elenco ma numerato
  2. Un altro elemento
    1. Usate l'indentazione per ulteriori livelli
  3. E così via
  * Questo è un elenco
  * Il secondo elemento
    * Potete avere diversi livelli
  * Un altro elemento

  - Lo stesso elenco ma numerato
  - Un altro elemento
    - Usate l'indentazione per ulteriori livelli
  - E così via

Per approfondimenti vi rimandiamo alla FAQ sugli elementi degli elenchi (in inglese).

Conversioni di Testi

Si veda la relativa sezione Texts Conversions (in inglese).

Citazioni

Si veda la relativa sezione Quoting (in inglese).

Tabelle

Per creare tabelle DokuWiki supporta una sintassi semplice.

Intestazione 1 Intestazione 2 Intestazione 3
Riga 1 Col 1 Riga 1 Col 2 Riga 1 Col 3
Riga 2 Col 1 colonna doppia (notare il doppio pipe)
Riga 3 Col 1 Riga 3 Col 2 Riga 3 Col 3

Le righe di tabella devono iniziare e finire con un | per le righe normali o 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 doppia (notare il doppio //pipe//) ||
| Riga 3 Col 1   | Riga 3 Col 2    | Riga 3 Col 3       |

Per collegare celle in orizzontale è sufficiente che la cella successiva sia completamente vuota, così come mostrato sopra. Assicuratevi di avere sempre lo stesso numero di separatori di cella!

Sono inoltre disponibili intestazioni verticali.

Intestazione 1 Intestazione 2
Intestazione 3 Riga 1 Col 2 Riga 1 Col 3
Intestazione 4 nessuna colonna doppia stavolta
Intestazione 5 Riga 3 Col 2 Riga 3 Col 3

Come potete vedere è il separatore di cella prima di una cella a impostare la formattazione:

|                 ^ Intestazione 1                  ^ Intestazione 2     ^
^ Intestazione 3  | Riga 1 Col 2                    | Riga 1 Col 3       |
^ Intestazione 4  | nessuna colonna doppia stavolta |                    |
^ Intestazione 5  | Riga 3 Col 2                    | Riga 3 Col 3       |

Potete avere righe espanse (celle collegate verticalmente) aggiungendo ::: nelle celle al di sotto della cella a cui devono essere collegate.

Intestazione 1 Intestazione 2 Intestazione 3
Riga 1 Col 1 questa cella si espande verticalmente Riga 1 Col 3
Riga 2 Col 1 Riga 2 Col 3
Riga 3 Col 1 Riga 2 Col 3

Tranne la sintassi per l'espansione verticale, queste celle non dovrebbero contenere altro.

^ Intestazione 1  ^ Intestazione 2                        ^ Intestazione 3      ^
| Riga 1 Col 1    | questa cella si espande verticalmente | Riga 1 Col 3        |
| Riga 2 Col 1    | :::                                   | Riga 2 Col 3        |
| Riga 3 Col 1    | :::                                   | Riga 2 Col 3        |

Potete anche allineare i contenuti delle tabelle. Basta aggiungere almeno due spazi al testo, opposti rispetto al lato cui si vuole allinearlo: due spazi a sinistra per allinearlo a destra, due spazi a destra per allinearlo a sinistra e due spazi da ambo i lati per centrarlo.

Tabella con allineamenti
destra centro sinistra
sinistra destra centro
xxxxxxxxxxxx xxxxxxxxxxxx xxxxxxxxxxxx

Nella sorgente della pagina è scritta in questo modo:

^          Tabella con allineamenti         ^^^
|        destra|    centro     |sinistra      |
|sinistra      |         destra|    centro    |
| xxxxxxxxxxxx | xxxxxxxxxxxx  | xxxxxxxxxxxx |

Nota: l'allineamento verticale non è supportato.

Nessuna Formattazione

Se avete bisogno di mostrare il testo esattamente come è scritto (senza alcuna formattazione), racchiudete l'area con il tag <nowiki> o più semplicemente, con due caratteri di percento %%.

Questo è del testo contenente indirizzi come questo: http://www.splitbrain.org e **formattazione**, ma non viene elaborato.

Lo stesso avviene per //__questo__ testo// con uno smiley ;-).

<nowiki>
Questo è del testo contenente indirizzi come questo: http://www.splitbrain.org e **formattazione**, ma non viene elaborato.
</nowiki>

Lo stesso avviene per %%//__questo__ testo// con uno smiley ;-)%%.

Blocchi Codice

Nei vostri documenti potete inserire blocchi di codice indentandoli con almeno due spazi (come è stato fatto per gli esempi precedenti) o usando i tag <code> o file.

Questo testo è indentato con due spazi.
In questo codice sono preservati tutti gli spazi: come            <-questo
Per questo è circa lo stesso, ma potete usarlo per evidenziare che avete citato un file.

I blocchi mostrati sono creati così:

    Questo testo è indentato con due spazi.
<code>
In questo codice sono preservati tutti gli spazi: come            <-questo
</code>
<file>
Per questo è circa lo stesso, ma potete usarlo per evidenziare che avete citato un file.
</file>

Syntax Highlighting

DokuWiki can highlight sourcecode, which makes it easier to read. It uses the GeSHi Generic Syntax Highlighter – so any language supported by GeSHi is supported. The syntax uses the same code and file blocks described in the previous section, but this time the name of the language syntax to be highlighted is included inside the tag, e.g. <code java> or <file 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.
    }
}

The following language strings are currently recognized: 4cs, 6502acme, 6502kickass, 6502tasm, 68000devpac, abap, actionscript-french, actionscript, actionscript3, ada, algol68, apache, applescript, asm, asp, autoconf, autohotkey, autoit, avisynth, awk, bascomavr, bash, basic4gl, bf, bibtex, blitzbasic, bnf, boo, c, c_loadrunner, c_mac, caddcl, cadlisp, cfdg, cfm, chaiscript, cil, clojure, cmake, cobol, coffeescript, cpp, cpp-qt, csharp, css, cuesheet, d, dcs, delphi, diff, div, dos, dot, e, epc, ecmascript, eiffel, email, erlang, euphoria, f1, falcon, fo, fortran, freebasic, fsharp, gambas, genero, genie, gdb, glsl, gml, gnuplot, go, groovy, gettext, gwbasic, haskell, hicest, hq9plus, html, html5, icon, idl, ini, inno, intercal, io, j, java5, java, javascript, jquery, kixtart, klonec, klonecpp, latex, lb, lisp, llvm, locobasic, logtalk, lolcode, lotusformulas, lotusscript, lscript, lsl2, lua, m68k, magiksf, make, mapbasic, matlab, mirc, modula2, modula3, mmix, mpasm, mxml, mysql, newlisp, nsis, oberon2, objc, objeck, ocaml-brief, ocaml, oobas, oracle8, oracle11, oxygene, oz, pascal, pcre, perl, perl6, per, pf, php-brief, php, pike, pic16, pixelbender, pli, plsql, postgresql, povray, powerbuilder, powershell, proftpd, progress, prolog, properties, providex, purebasic, pycon, python, q, qbasic, rails, rebol, reg, robots, rpmspec, rsplus, ruby, sas, scala, scheme, scilab, sdlbasic, smalltalk, smarty, sql, systemverilog, tcl, teraterm, text, thinbasic, tsql, typoscript, unicon, uscript, vala, vbnet, vb, verilog, vhdl, vim, visualfoxpro, visualprolog, whitespace, winbatch, whois, xbasic, xml, xorg_conf, xpp, yaml, z80, zxbasic

Downloadable Code Blocks

When you use the <code> or <file> syntax as above, you might want to make the shown code available for download as well. You can do this by specifying a file name after language code like this:

<file php myexample.php>
<?php echo "hello world!"; ?>
</file>
myexample.php
<?php echo "hello world!"; ?>

If you don't want any highlighting but want a downloadable file, specify a dash (-) as the language code: <code - myfile.foo>.

Embedding HTML and PHP

You can embed raw HTML or PHP code into your documents by using the <html> or <php> tags. (Use uppercase tags if you need to enclose block level elements.)

HTML example:

<html>
This is some <span style="color:red;font-size:150%;">inline HTML</span>
</html>
<HTML>
<p style="border:2px dashed red;">And this is some block HTML</p>
</HTML>

This is some <span style="color:red;font-size:150%;">inline HTML</span>

<p style="border:2px dashed red;">And this is some block HTML</p>

PHP example:

<php>
echo 'A logo generated by PHP:';
echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />';
echo '(generated inline HTML)';
</php>
<PHP>
echo '<table class="inline"><tr><td>The same, but inside a block level element:</td>';
echo '<td><img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" /></td>';
echo '</tr></table>';
</PHP>

echo 'A logo generated by PHP:'; echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />'; echo '(inline HTML)';

echo '<table class="inline"><tr><td>The same, but inside a block level element:</td>';
echo '<td><img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" /></td>';
echo '</tr></table>';

Please Note: HTML and PHP embedding is disabled by default in the configuration. If disabled, the code is displayed instead of executed.

RSS/ATOM Feed Aggregation

DokuWiki can integrate data from external XML feeds. For parsing the XML feeds, SimplePie is used. All formats understood by SimplePie can be used in DokuWiki as well. You can influence the rendering by multiple additional space separated parameters:

Parameter Description
any number will be used as maximum number items to show, defaults to 8
reverse display the last items in the feed first
author show item authors names
date show item dates
description show the item description. If HTML is disabled all tags will be stripped
n[dhm] refresh period, where d=days, h=hours, m=minutes. (e.g. 12h = 12 hours).

The refresh period defaults to 4 hours. Any value below 10 minutes will be treated as 10 minutes. DokuWiki will generally try to supply a cached version of a page, obviously this is inappropriate when the page contains dynamic external content. The parameter tells DokuWiki to re-render the page if it is more than refresh period since the page was last rendered.

Example:

{{rss>http://slashdot.org/index.rss 5 author date 1h }}

Control Macros

Some syntax influences how DokuWiki renders a page without creating any output it self. The following control macros are availble:

Macro Description
~~NOTOC~~ If this macro is found on the page, no table of contents will be created
~~NOCACHE~~ DokuWiki caches all output by default. Sometimes this might not be wanted (eg. when the <php> syntax above is used), adding this macro will force DokuWiki to rerender a page on every call

Syntax Plugins

DokuWiki's syntax can be extended by Plugins. How the installed plugins are used is described on their appropriate description pages. The following syntax plugins are available in this particular DokuWiki installation:

1) Questa è una nota a piè di pagina
2) quando le nuove proporzioni non combaciano a quelle dell'immagine, questa verrà tagliata alle nuove proporzioni prima di venire ridimensionata
wiki/syntax.txt · Ultima modifica: 09/04/2014 18:19 da etien