Differenze
Queste sono le differenze tra la revisione selezionata e la versione attuale della pagina.
wiki:syntax [15/12/2017 13:12] FelynX |
wiki:syntax [22/01/2021 15:14] |
||
---|---|---|---|
Linea 1: | Linea 1: | ||
- | ====== Sintassi di formattazione ====== | ||
- | [[benvenuto|welcome]] supporta del semplice linguaggio di formattazione, | ||
- | ===== Basi per la Formattazione del testo ===== | ||
- | DokuWiki supporta testi in **grassetto**, | ||
- | |||
- | DokuWiki supporta testi in **grassetto**, | ||
- | Naturalmente tutti questi si possono **__//'' | ||
- | |||
- | Si possono usare anche < | ||
- | |||
- | Si possono usare anche < | ||
- | |||
- | Inoltre si può contrassegnare qualcosa come < | ||
- | |||
- | Inoltre si può contrassegnare qualcosa come < | ||
- | |||
- | I **paragrafi** sono creati da righe vuote. Se si vuole **forzare un ritorno a capo** senza un paragrafo, si possono usare due barre retroverse seguite da uno spazio bianco o dalla fine della riga. | ||
- | |||
- | Questo è del testo con qualche interruzione di linea\\ Notare che le | ||
- | due barre retroverse sono riconosciute soltanto alla fine di una linea\\ | ||
- | oppure quando seguite da\\ uno spazio bianco \\ecco cosa succede senza di questo. | ||
- | |||
- | Questo è del testo con qualche interruzione di linea\\ Notare che le | ||
- | due barre retroverse sono riconosciute soltanto alla fine di una riga\\ | ||
- | oppure quando seguite da\\ uno spazio bianco \\ecco cosa succede senza di questo. | ||
- | |||
- | I ritorni a capo forzati dovrebbero essere usati solo quando realmente necessari. | ||
- | ===== Collegamenti ===== | ||
- | |||
- | DokuWiki supporta molteplici modi per la creazione di collegamenti. | ||
- | ==== Esterni ==== | ||
- | |||
- | I collegamenti esterni sono riconosciuti automaticamente: | ||
- | |||
- | DokuWiki supporta molteplici modi per la creazione di collegamenti. I collegamenti esterni sono riconosciuti | ||
- | automaticamente: | ||
- | anche i testi dei collegamenti: | ||
- | ==== Interni ==== | ||
- | |||
- | I collegamenti interni sono creati usando le parentesi quadre. Si può immettere un [[doku> | ||
- | |||
- | I collegamenti interni sono creati usando le parentesi quadre. Si può immettere un [[it: | ||
- | o, in alternativa, | ||
- | |||
- | [[doku> | ||
- | |||
- | Si può specificare la [[doku> | ||
- | |||
- | Si può specificare la [[it: | ||
- | |||
- | Per i dettagli si veda [[doku> | ||
- | |||
- | È pure possibile realizzare collegamenti a una specifica sezione. È sufficiente aggiungere il nome della sezione prima del carattere //diesis// (#), come è noto dall' | ||
- | |||
- | Questo collegamento punta a [[syntax# | ||
- | |||
- | Note: | ||
- | |||
- | * I collegamenti a [[doku> | ||
- | * DokuWiki non usa la sintassi [[wpit> | ||
- | * Quando l' | ||
- | |||
- | ==== Interwiki ==== | ||
- | |||
- | Dokuwiki supporta i collegamenti [[doku> | ||
- | |||
- | Dokuwiki supporta i collegamenti [[doku> | ||
- | Per esempio, questo collegamento punta alla pagina in italiano di Wikipedia riguardante i Wiki: [[wpit> | ||
- | |||
- | |||
- | ==== Partizioni Windows ==== | ||
- | |||
- | Le partizioni Windows come [[\\server\share|questa]] sono pure riconosciute. Notare che esse hanno un senso soltanto in un gruppo omogeneo di utenti come in una [[wpit> | ||
- | |||
- | Le partizioni Windows come [[\\server\share|questa]] sono pure riconosciute. | ||
- | |||
- | Note: | ||
- | |||
- | * Per ragioni di sicurezza la navigazione diretta di partizioni Windows funziona solo in Microsoft Internet Explorer, in modo predefinito (e soltanto nella "zona locale" | ||
- | * Per Mozilla e Firefox questa può essere abilitata mediante l' | ||
- | * Vedere [[bug> | ||
- | ==== Collegamenti a immagini ==== | ||
- | |||
- | Si può anche usare un' | ||
- | |||
- | [[http:// | ||
- | |||
- | [[http:// | ||
- | |||
- | Notare: la formattazione dell' | ||
- | |||
- | L' | ||
- | |||
- | ----- | ||
- | |||
- | |||
- | ===== Note a piè di pagina ===== | ||
- | |||
- | Si possono aggiungere note a piè di pagina ((Questa è una nota a piè di pagina)) usando parentesi doppie. | ||
- | |||
- | Si possono aggiungere note a piè di pagina ((Questa è una nota a piè di pagina)) usando parentesi doppie. | ||
- | ===== Suddivisione in sezioni ===== | ||
- | |||
- | Si possono usare fino a cinque differenti livelli di intestazione per strutturare il contenuto. Se si hanno più di tre intestazioni, | ||
- | |||
- | |||
- | ==== Livello di intestazione 3 ==== | ||
- | === Livello di intestazione 4 === | ||
- | == Livello di intestazione 5 == | ||
- | |||
- | ==== Livello di intestazione 3 ==== | ||
- | === Livello di intestazione 4 === | ||
- | == Livello di intestazione 5 == | ||
- | |||
- | Usando quattro o più trattini, si può fare una linea orizzontale: | ||
- | ---- | ||
- | ===== Immagini e altri file ===== | ||
- | |||
- | Si possono includere [[doku> | ||
- | |||
- | Dimensione reale: | ||
- | |||
- | Ridimensionata a una larghezza data: {{wiki: | ||
- | |||
- | Ridimensionata a larghezza e altezza date((quando il rapporto tra la larghezza e l' | ||
- | |||
- | Immagine esterna ridimensionata: | ||
- | |||
- | Dimensione reale: | ||
- | Ridimensionata a una larghezza data: {{wiki: | ||
- | Ridimensionata a larghezza e altezza date: {{wiki: | ||
- | Immagine esterna ridimensionata: | ||
- | |||
- | |||
- | Usando spazi bianchi a sinistra o a destra si può scegliere l' | ||
- | |||
- | {{ wiki: | ||
- | |||
- | {{wiki: | ||
- | |||
- | {{ wiki: | ||
- | |||
- | |||
- | {{ wiki: | ||
- | {{wiki: | ||
- | {{ wiki: | ||
- | |||
- | Naturalmente, | ||
- | |||
- | {{ wiki: | ||
- | |||
- | {{ wiki: | ||
- | |||
- | Se si specifica il nome di un file (esterno o interno) che non è un' | ||
- | |||
- | Per collegare un' | ||
- | |||
- | |||
- | ===== Liste ===== | ||
- | |||
- | Dokuwiki supporta liste ordinate e non-ordinate. Per creare un elemento di una lista, indentare il testo con due spazi e usare un asterisco ('' | ||
- | |||
- | * 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' | ||
- | - È tutto | ||
- | |||
- | < | ||
- | * 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' | ||
- | - È 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> | ||
- | |||
- | * 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 ==== | ||
- | |||
- | [[benvenuto|DokuWiki]] può convertire semplici caratteri di testo nelle rispettive entità tipograficamente corrette. Ecco un esempio dei caratteri riconosciuti. | ||
- | |||
- | -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) | ||
- | "He thought ' | ||
- | |||
- | < | ||
- | -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) | ||
- | "He thought ' | ||
- | </ | ||
- | |||
- | La stesso può essere fatto per produrre ogni tipo di codice HTML, e necessario soltanto aggiungerlo nel [[doku> | ||
- | |||
- | Esistono tre eccezioni che non provengono dal pattern file: moltiplicazione di entità (640×480) ' | ||
- | ===== 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ì! | ||
- | | ||
- | >>> | ||
- | |||
- | Penso che dovremmo farlo | ||
- | |||
- | > No, non dovremmo | ||
- | |||
- | >> Be', dico che dovremmo | ||
- | |||
- | > Davvero? | ||
- | |||
- | >> Sì! | ||
- | |||
- | >>> | ||
- | ===== 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 '' | ||
- | |||
- | ^ 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, | ||
- | |||
- | È 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 '':::'' | ||
- | |||
- | ^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. | ||
- | |||
- | ^ | ||
- | | destra| | ||
- | |sinistra | ||
- | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | | ||
- | |||
- | Ecco come appare nel sorgente: | ||
- | |||
- | |||
- | ^ | ||
- | | destra| | ||
- | |sinistra | ||
- | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | | ||
- | |||
- | Nota: l' | ||
- | ===== Nessuna formattazione ===== | ||
- | |||
- | Se avete bisogno di visualizzare il testo esattamente come è scritto (senza alcuna formattazione), | ||
- | |||
- | < | ||
- | Questo è del testo che contiene indirizzi come questo http:// | ||
- | </ | ||
- | Lo stesso è vero per %%// | ||
- | |||
- | < | ||
- | Questo è del testo che contiene indirizzi come questo: http:// | ||
- | </ | ||
- | Lo stesso è vero per %%// | ||
- | ===== Blocchi di codice ===== | ||
- | |||
- | È possibile includere blocchi di codice nei documenti sia indentandoli con almeno due spazi (come negli esempi precedenti), | ||
- | |||
- | Questo testo è intentrato con due spazi. | ||
- | | ||
- | |||
- | < | ||
- | </ | ||
- | |||
- | < | ||
- | </ | ||
- | |||
- | |||
- | Questi blocchi sono stati creati da questi sorgenti: | ||
- | |||
- | Questo testo è indentrato con due spazi. | ||
- | |||
- | < | ||
- | Questo è codice preformato ogni spazio è preservato: come <-questo | ||
- | </ | ||
- | |||
- | < | ||
- | Questo è praticamente la stessa cosa, ma si potrebbe usare per mostrare che è stato citato un file. | ||
- | </ | ||
- | ==== Evidenziazione di sintassi ==== | ||
- | |||
- | [[benvenuto|DokuWiki]] può sottolineare il codice sorgente, che lo rende più facile da leggere. Usa la [[http:// | ||
- | |||
- | <code java> | ||
- | /** | ||
- | * La classe HelloWorldApp implementa un' | ||
- | * mostra semplicemente "Hello World!" | ||
- | */ | ||
- | class HelloWorldApp { | ||
- | public static void main(String[] args) { | ||
- | System.out.println(" | ||
- | } | ||
- | } | ||
- | </ | ||
- | |||
- | Le seguenti stringhe di linguaggio sono correntemente riconosciuti: | ||
- | ==== Blocchi di codice scaricabili ==== | ||
- | |||
- | Quando si usa la sintassi '' | ||
- | |||
- | < | ||
- | <file php myexample.php> | ||
- | <?php echo "hello world!"; | ||
- | </ | ||
- | </ | ||
- | |||
- | <file php myexample.php> | ||
- | <?php echo "hello world!"; | ||
- | </ | ||
- | |||
- | Se non si vuole un file scaricabile senza nessuna evidenziazione, | ||
- | ===== Incorporare codice HTML e PHP ===== | ||
- | |||
- | Potete incorporare righe di codice HTML o PHP nei vostri documenti usando i marcatori '' | ||
- | |||
- | Esempio HTML: | ||
- | |||
- | < | ||
- | < | ||
- | Questo è <span style=" | ||
- | </ | ||
- | < | ||
- | <p style=" | ||
- | </ | ||
- | </ | ||
- | |||
- | < | ||
- | Questo è <span style=" | ||
- | </ | ||
- | < | ||
- | <p style=" | ||
- | </ | ||
- | |||
- | Esempio PHP: | ||
- | |||
- | < | ||
- | <php> | ||
- | echo 'Un logo generato da PHP:'; | ||
- | echo '< | ||
- | echo ' | ||
- | </ | ||
- | <PHP> | ||
- | echo '< | ||
- | echo '< | ||
- | echo '</ | ||
- | </ | ||
- | </ | ||
- | |||
- | <php> | ||
- | echo 'Un logo generato da PHP:'; | ||
- | echo '< | ||
- | echo ' | ||
- | </ | ||
- | <PHP> | ||
- | echo '< | ||
- | echo '< | ||
- | echo '</ | ||
- | </ | ||
- | |||
- | **Notate bene**: l' | ||
- | ===== Aggregazione di sorgenti RSS/ATOM ===== | ||
- | [[benvenuto|DokuWiki]] può integrare dati da sorgenti XML esterne. Per l' | ||
- | |||
- | ^ Parametro | ||
- | | any number | ||
- | | reverse | ||
- | | author | ||
- | | date | visualizza le date degli elementi | | ||
- | | description | ||
- | | // | ||
- | |||
- | Il periodo di aggiornamento predefinito è di 4 ore. Ogni valore al di sotto di 10 minuti sarà considerato come 10 minuti. Generalmente [[benvenuto|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 [[benvenuto|DokuWiki]] di ricaricare nuovamente la pagina se è trascorso un tempo superiore a //periodo di aggiornamento// | ||
- | |||
- | **Esempio: | ||
- | |||
- | {{rss> | ||
- | |||
- | {{rss> | ||
- | ===== 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~~%% | ||
- | | %%~~NOCACHE~~%% | DokuWiki si serve automaticamente della memoria cache. Talvolta questo comportamento potrebbe non essere voluto (ad esempio quando è usata la sintassi %%< | ||
- | ===== Moduli aggiuntivi per la sintassi ===== | ||
- | |||
- | La sintassi di DokuWiki può essere estesa mediante [[doku> | ||
- | |||
- | ~~INFO: |