* Questa è una lista
* Il secondo elemento
* Si possono avere livelli differenti
* Un altro elemento
- La stessa lista ma ordinata
- Un altro elemento
- Usare semplicemente l'indentazione per ottenere livelli più profondi
- È tutto
===== Conversioni di testo =====
DokuWiki può convertire alcuni caratteri predefiniti o stringhe in immagini altro testo o HTML.
La conversione di testo in immagini è fatta principalmente per le faccine. E la conversione del testo in formato HTML è usata per sostituzione tipografica ma può essere configurata per usare anche altro HTML.
==== Conversioni di testo in immagini ====
DokuWiki converte le [[wpit>Emoticon|emoticon]] comunemente usate nei rispettivi equivalenti grafici. Queste [[doku>smileys|faccine]] e altre immagini possono essere configurate ed estese. Ecco una panoramica delle faccine incluse in DokuWiki.
* 8-) %% 8-) %%
* 8-O %% 8-O %%
* :-( %% :-( %%
* :-) %% :-) %%
* =) %% =) %%
* :-/ %% :-/ %%
* :-\ %% :-\ %%
* :-? %% :-? %%
* :-D %% :-D %%
* :-P %% :-P %%
* :-O %% :-O %%
* :-X %% :-X %%
* :-| %% :-| %%
* ;-) %% ;-) %%
* ^_^ %% ^_^ %%
* :?: %% :?: %%
* :!: %% :!: %%
* LOL %% LOL %%
* FIXME %% FIXME %%
* DELETEME %% DELETEME %%
==== Conversioni di testo in HTML ====
[[doku>it:DokuWiki|DokuWiki]] può convertire semplici caratteri di testo nelle rispettive entità tipograficamente corrette. Ecco un esempio dei caratteri riconosciuti.
-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"He thought 'It's a man's world'..."
-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"He thought 'It's a man's world'..."
La stesso può essere fatto per produrre ogni tipo di codice HTML, e necessario soltanto aggiungerlo nel [[doku>it:entities|pattern file]]
Esistono tre eccezioni che non provengono dal pattern file: moltiplicazione di entità (640×480) 'singole' e " doppie virgolette". Possono essere disattivate tramite un'[[doku>it:config:typography|opzione di configurazione]]
===== Citazioni =====
Talvolta si vuole contrasegnare del testo per mostrare che esso è una risposta o un commento. Si può usare la sintassi seguente:
Penso che dovremmo farlo
> No, non dovremmo
>> Be', dico che dovremmo
> Davvero?
>> Sì!
>>> Allora facciamolo!
Penso che dovremmo farlo
> No, non dovremmo
>> Be', dico che dovremmo
> Davvero?
>> Sì!
>>> Allora facciamolo!
===== Tabelle =====
DokuWiki supporta una semplice sintasi per la creazione di tabelle.
^ Intestazione 1 ^ Intestazione 2 ^ Intestazione 3 ^
| Riga 1 Col 1 | Riga 1 Col 2 | Riga 1 Col 3 |
| Riga 2 Col 1 | Celle unite (notare il doppio pipe) ||
| Riga 3 Col 1 | Riga 3 Col 2 | Riga 3 Col 3 |
Le righe delle tabelle devono iniziare e terminare con un carattere ''|'' per le righe normali o con il carattere ''^'' 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 | Celle unite (notare il doppio pipe) ||
| Riga 3 Col 1 | Riga 3 Col 2 | Riga 3 Col 3 |
Per unire le celle orizzontalmente, è sufficiente rendere completamente vuota la cella successiva come mostrato sopra. Assicurarsi di avere sempre lo stesso numero totale di separatori di celle!
È pure possibile realizzare intestazioni verticali di tabella.
| ^ Intestazione 1 ^ Intestazione 2 ^
^ Intestazione 3 | Riga 1 Col 2 | Riga 1 Col 3 |
^ Intestazione 4 | niente fusione questa volta | |
^ Intestazione 5 | Riga 2 Col 2 | Riga 2 Col 3 |
Come si può notare, è il separatore di cella prima di una cella che decide il tipo di formattazione:
| ^ Intestazione 1 ^ Intestazione 2 ^
^ Intestazione 3 | Riga 1 Col 2 | Riga 1 Col 3 |
^ Intestazione 4 | niente fusione questa volta | |
^ Intestazione 5 | Riga 2 Col 2 | Riga 2 Col 3 |
Si possono avere celle unite verticalmente aggiungendo '':::'' dentro le celle sotto quella a cui devono connettersi.
^Intestazione 1 ^ Intestazione 2 ^ Intestazione 3 ^
| Riga 1 Col 1 | questa cella è unita verticalmente | Row 1 Col 3 |
| Riga 2 Col 1 | ::: | Row 2 Col 3 |
| Riga 3 Col 1 | ::: | Row 2 Col 3 |
A parte la sintassi di unione quelle celle non devono contenere niente altro.
^ Intestazione 1 ^ Intestazione 2 ^ Intestazione 3 ^
| Riga 1 Col 1 | questa cella è unita verticalmente | Riga 1 Col 3 |
| Riga 2 Col 1 | ::: | Riga 2 Col 3 |
| Riga 3 Col 1 | ::: | Riga 3 Col 3 |
Si può allineare anche il contenuto di una tabella. È sufficiente aggiungere almeno due spazi bianchi al lato opposto del testo: aggiungere due spazi a sinistra per allineare a destra, due spazi a destra per allineare a sinistra e almeno due spazi ad entrambi i lati per il testo centrato.
^ Tabella con allineamento ^^^
| destra| centro |sinistra |
|sinistra | destra| centro |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
Ecco come appare nel sorgente:
^ Tabella con allineamento ^^^
| destra| centro |sinistra |
|sinistra | destra| centro |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
Nota: l'allineamento verticale non è supportato.
===== Nessuna formattazione =====
Se avete bisogno di visualizzare il testo esattamente come è scritto (senza alcuna formattazione), racchiudete l'area sia con il marcatore ''%%Questo è codice preformattato e tutti gli spazi sono preservati: come <-questo
Questo è codice preformato ogni spazio è preservato: come <-questo
/**
* La classe HelloWorldApp implementa un'applicazione che
* mostra semplicemente "Hello World!" come risultato.
*/
class HelloWorldApp {
public static void main(String[] args) {
System.out.println("Hello World!"); //Visualizza la stringa.
}
}
Le seguenti stringhe di linguaggio sono correntemente riconosciuti: //4cs, abap, actionscript-french, actionscript, actionscript3, ada, apache, applescript, asm, asp, autoconf, autohotkey, autoit, avisynth, awk, bash, basic4gl, bf, bibtex, blitzbasic, bnf, boo, c, c_mac, caddcl, cadlisp, cfdg, cfm, chaiscript, cil, clojure, cmake, cobol, cpp, cpp-qt, csharp, css, cuesheet, d, dcs, delphi, diff, div, dos, dot, ecmascript, eiffel, email, erlang, fo, fortran, freebasic, fsharp, gambas, genero, genie, gdb, glsl, gml, gnuplot, groovy, gettext, gwbasic, haskell, hicest, hq9plus, html, icon, idl, ini, inno, intercal, io, j, java5, java, javascript, jquery, kixtart, klonec, klonecpp, latex, lisp, locobasic, logtalk, lolcode, lotusformulas, lotusscript, lscript, lsl2, lua, m68k, magiksf, make, mapbasic, matlab, mirc, modula2, modula3, mmix, mpasm, mxml, mysql, newlisp, nsis, oberon2, objc, ocaml-brief, ocaml, oobas, oracle8, oracle11, oxygene, oz, pascal, pcre, perl, perl6, per, pf, php-brief, php, pike, pic16, pixelbender, plsql, postgresql, povray, powerbuilder, powershell, progress, prolog, properties, providex, purebasic, 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, vala, vbnet, vb, verilog, vhdl, vim, visualfoxpro, visualprolog, whitespace, winbatch, whois, xbasic, xml, xorg_conf, xpp, z80//
==== Blocchi di codice scaricabili ====
Quando si usa la sintassi ''%%%%'' o ''%%%%'' come sopra, si potrebbe volere rendere il codice mostrato disponibile per anche per il prelevamento. Si può fare specificando un nome di file dopo il codice del linguaggio come questo:
Se non si vuole un file scaricabile senza nessuna evidenziazione, specificate un trattino (''-'') come codice del linguaggio: ''%%%%''.
===== Incorporare codice HTML e PHP =====
Potete incorporare righe di codice HTML o PHP nei vostri documenti usando i marcatori ''%%%%'' o ''%%%%''. (Usate i marcatori maiuscoli se è necessario includere gli elementi in blocchi)
Esempio HTML:
Questo è HTML in riga
E questo è un blocco HTML
Questo è HTML in riga
E questo è un blocco HTML
Esempio PHP:
echo 'Un logo generato da PHP:';
echo ' . ')
';
echo '(generated inline HTML)';
echo 'Lo stesso, ma all'interno di un elemento di livello blocco: ';
echo '
';
echo 'Un logo generato da PHP:';
echo '';
echo '(inline HTML)';
echo 'Lo stesso, ma all'interno di un elemento di livello blocco: ';
echo '
';
**Notate bene**: l'incorporazione di codice HTML e PHP è disabilitata per impostazione predefinita nella configurazione. Se disabilitata, il codice è visualizzato invece di essere eseguito.
===== Aggregazione di sorgenti RSS/ATOM =====
[[doku>it:DokuWiki|DokuWiki]] può integrare dati da sorgenti XML esterne. Per l'analisi sintattica delle sorgenti XML è usato [[http://simplepie.org/|SimplePie]]. Tutti i formati riconosciuti da SimplePie possono essere usati anche in DokuWiki. Si può modificare la visualizzazione mediante diversi parametri separati da uno spazio:
^ Parametro ^ Descrizione ^
| any number | sarà usato come numero massimo di elementi da visualizzare, predefinito a 8 |
| reverse | visualizza per primi gli ultimi elementi |
| author | visualizza i nomi degli autori degli elementi |
| date | visualizza le date degli elementi |
| description | visualizza la descrizione dell'elemento. Se [[doku>config#htmlok|HTML]] è disabilitato, tutti i tag HTML saranno rimossi |
| //n//[dhm] | periodo di aggiornamento, dove d=giorni, h=ore, m=minuti. (ad es. 12h = 12 ore). |
Il periodo di aggiornamento predefinito è di 4 ore. Ogni valore al di sotto di 10 minuti sarà considerato come 10 minuti. Generalmente [[doku>it:DokuWiki|DokuWiki]] cercherà di fornire una versione della pagina memorizzata localmente; ciò è ovviamente inappropriato quando la pagina contiene del contenuto esterno dinamico. Il parametro dice a [[doku>it:DokuWiki|DokuWiki]] di ricaricare nuovamente la pagina se è trascorso un tempo superiore a //periodo di aggiornamento// dall'ultima volta che la pagina è stata visualizzata.
**Esempio:**
{{rss>http://slashdot.org/index.rss 5 author date 1h }}
{{rss>http://slashdot.org/index.rss 5 author date 1h }}
===== Macro di Controllo =====
Alcune sintassi influenzano come DokuWiki restituisce una pagina senza creare risultati a sé. Le seguenti macro di controllo sono disponibili:
^ Macro ^ Descrizione |
| %%~~NOTOC~~%% | Se questa macro è trovata nella pagina, la tabella dei contenuti non sarà creata |
| %%~~NOCACHE~~%% | DokuWiki si serve automaticamente della memoria cache. Talvolta questo comportamento potrebbe non essere voluto (ad esempio quando è usata la sintassi %%%% di cui sopra), aggiungendo questa macro si forza DokuWiki a ricaricare la pagina ad ogni richiesta|
===== Moduli aggiuntivi per la sintassi =====
La sintassi di DokuWiki può essere estesa mediante [[doku>it:plugins|Moduli aggiuntivi]]. Come sono utilizzati i moduli aggiuntivi è spiegato nelle rispettive pagine di descrizione del caso. I seguenti moduli aggiuntivi per la sintassi sono disponibili in questa particolare installazione di DokuWiki:
~~INFO:syntaxplugins~~