Strumenti Utente

Strumenti Sito


wiki:syntax

Differenze

Queste sono le differenze tra la revisione selezionata e la versione attuale della pagina.

Link a questa pagina di confronto

Entrambe le parti precedenti la revisione Revisione precedente
Prossima revisione
Revisione precedente
wiki:syntax [09/04/2014 18:17]
etien [Elenchi]
wiki:syntax [27/07/2018 17:40] (versione attuale)
Linea 1: Linea 1:
-====== ​Sintassi per la formattazione ​======+====== ​Formatting Syntax ​======
  
-[[doku>​DokuWiki]] ​supporta un linguaggio semplice per la formattazionecol quale si cerca di rendere il più leggibile possibile i file dei documentiQuesta pagina contiene tutte le regole sintattiche a disposizione per editare il testoDate un'​occhiata alla sorgente di questa pagina premendo il pulsante ​"Modifica questa pagina"​. ​Se volete provare a scrivere qualcosa usate la pagina ​[[playground:​playground|playground]]. ​Le formattazioni sono facilmente assegnabili anche tramite la [[doku>​toolbar|barra strumenti]].+[[doku>​DokuWiki]] ​supports some simple markup languagewhich tries to make the datafiles to be as readable as possibleThis page contains all possible syntax you may use when editing the pagesSimply have a look at the source of this page by pressing ​"Edit this page"​. ​If you want to try something, just use the [[playground:​playground|playground]] ​pageThe simpler markup is easily accessible via [[doku>​toolbar|quickbuttons]], too.
  
-<WRAP info round> +===== Basic Text Formatting =====
-Questa pagina è una traduzione incompleta della [[en:​wiki:​syntax|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. +
-</​WRAP>​+
  
-===== Formattazione base del testo =====+DokuWiki supports **bold**, //italic//, __underlined__ and ''​monospaced''​ texts. Of course you can **__//''​combine''//​__** all these.
  
-DokuWiki ​supporta testo in **grassetto**, //italico//, __sottolineato__ e ''​a spaziatura fissa''​. ​Ovviamente questi stili si possono ​**__//''​combinare''//​__** ​assieme.+  ​DokuWiki ​supports ​**bold**, //italic//, __underlined__ and ''​monospaced'' ​texts. 
 +  Of course you can **__//''​combine''//​__** ​all these.
  
-  DokuWiki supporta testo in **grassetto**,​ //italico//, __sottolineato__ e ''​a spaziatura fissa''​. +You can use <​sub>​subscript<​/sub> and <​sup>​superscript<​/sup>too.
-  Ovviamente questi stili si possono **__//''​combinare''//​__** assieme.+
  
-Potete usare <sub>deponenti</​sub> ​ed <sup>esponenti</​sup>​.+  You can use <sub>subscript</​sub> ​and <sup>superscript</​sup>​, too.
  
-  Potete usare <sub>deponenti</sub> ed <​sup>​esponenti</​sup>.+You can mark something as <del>deleted</delas well.
  
-Potete anche segnare qualcosa come <del>cancellato</​del>​.+  You can mark something as <del>deleted</​del> ​as well.
  
-  Potete anche segnare qualcosa come <​del>​cancellato</​del>​.+**Paragraphs** are created from blank lines. If you want to **force a newline** without a paragraph, you can use two backslashes followed by a whitespace or the end of line.
  
-I **paragrafi** si creano lasciando una riga vuota. Se volete **andare ​capo** senza creare un paragrafo, alla fine della riga scrivete due //​backslash//​ seguite da uno spazio.+This is some text with some linebreaks\\ Note that the 
 +two backslashes are only recognized at the end of line\\ 
 +or followed by\\ a whitespace \\this happens without it.
  
-Questo è del testo con alcuni a capo\\ Si noti che le +  This is some text with some linebreaks\\ Note that the 
-due backslash vengono riconosciute alla fine di una riga\\ +  two backslashes are only recognized at the end of a line\\ 
-o quando seguite da\\ uno spazio ​\\senza il quale succede questo.+  or followed by\\ a whitespace ​\\this happens without it.
  
-  Questo è del testo con alcuni a capo\\ Si noti che le +You should use forced newlines only if really needed.
-  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.+===== Links =====
  
 +DokuWiki supports multiple ways of creating links.
  
 +==== External ====
  
-===== Collegamenti =====+External links are recognized automagically:​ http://​www.google.com or simply www.google.com - You can set the link text as well: [[http://​www.google.com|This Link points to google]]. Email addresses like this one: <​andi@splitbrain.org>​ are recognized, too.
  
-DokuWiki ​permette diversi modi per la creazione di collegamenti.+  ​DokuWiki ​supports multiple ways of creating links. External links are recognized 
 +  automagically:​ http://​www.google.com or simply www.google.com - You can set 
 +  link text as well: [[http://​www.google.com|This Link points to google]]. Email 
 +  addresses like this one: <​andi@splitbrain.org>​ are recognized, too.
  
 +==== Internal ====
  
-==== Esterni ====+Internal links are created by using square brackets. You can either just give a [[pagename]] or use an additional [[pagename|link text]].
  
-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>​.+  Internal links are created by using square bracketsYou can either just give 
 +  a [[pagename]] or use an additional [[pagename|link text]].
  
-  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>​.+[[doku>​pagename|Wiki pagenames]] are converted to lowercase automatically,​ special characters are not allowed.
  
 +You can use [[some:​namespaces]] by using a colon in the pagename.
  
-==== Interni ====+  You can use [[some:​namespaces]] by using a colon in the pagename.
  
-I collegamenti interni si creano usando le parentesi quadre. Potete sia indicare una [[pagina]] sia specificare un [[pagina|testo del collegamento]].+For details about namespaces see [[doku>​namespaces]].
  
-  I collegamenti interni si creano usando le parentesi quadrePotete sia indicare una [[pagina]] sia specificare un [[pagina|testo del collegamento]].+Linking to a specific section is possible, tooJust add the section name behind a hash character as known from HTML. This links to [[syntax#​internal|this Section]].
  
-[[doku>​pagina|I nomi di pagine Wiki]] sono convertiti automaticamente in caratteri minuscoli e non accettano caratteri speciali.+  This links to [[syntax#​internal|this Section]].
  
-Potete specificare una [[categoria:categoria]] inserendo il carattere di due punti nel nome di pagina. +Notes:
- +
-  Potete specificare una [[categoria:​categoria]] inserendo il carattere di due punti nel nome di pagina. +
- +
-Per dettagli sulle categorie si veda [[doku>​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 [[syntax#​interni|questa sezione]]. +
- +
-  Questo è un collegamento a [[syntax#​interni|questa sezione]]. +
- +
-Note: +
- +
-  * I collegamenti a [[syntax|pagine esistenti]] vengono mostrati con uno stile diverso dai collegamenti a [[pagine inesistenti]]. +
-  * Di default, DokuWiki non utilizza [[wp>​CamelCase]] per creare automaticamente collegamenti,​ ma questa opzione si può abilitare nel file [[doku>​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.+
  
 +  * Links to [[syntax|existing pages]] are shown in a different style from [[nonexisting]] ones.
 +  * DokuWiki does not use [[wp>​CamelCase]] to automatically create links by default, but this behavior can be enabled in the [[doku>​config]] file. Hint: If DokuWiki is a link, then it's enabled.
 +  * When a section'​s heading is changed, its bookmark changes, too. So don't rely on section linking too much.
  
 ==== Interwiki ==== ==== Interwiki ====
  
-DokuWiki ​supporta i collegamenti ​[[doku>​Interwiki]]. ​Si tratta di collegamenti rapidi ad altre WikiPer esempio, questo è un link alla pagina di Wikipedia ​che tratta le Wiki: [[wp>​Wiki]].+DokuWiki ​supports ​[[doku>​Interwiki]] ​linksThese are quick links to other WikisFor example this is a link to Wikipedia's page about Wikis: [[wp>​Wiki]].
  
-  DokuWiki ​supporta i collegamenti ​[[doku>​Interwiki]]. ​Si tratta di collegamenti rapidi ad altre WikiPer esempio, questo è un link alla pagina di Wikipedia ​che tratta le Wiki: [[wp>​Wiki]].+  DokuWiki ​supports ​[[doku>​Interwiki]] ​linksThese are quick links to other Wikis. 
 +  For example this is a link to Wikipedia's page about Wikis: [[wp>​Wiki]].
  
 +==== Windows Shares ====
  
-==== Condivisioni ​Windows ​====+Windows ​shares like [[\\server\share|this]] are recognized, too. Please note that these only make sense in a homogeneous user group like a corporate [[wp>​Intranet]].
  
-Le condivisioni ​Windows ​come [[\\server\share|questa]] sono riconosciute. Ovviamente hanno senso solo in un gruppo di utenti omogeneo come una [[wp>​Intranet]] aziendale.+  ​Windows ​Shares like [[\\server\share|this]] are recognized, too.
  
-  Le condivisioni Windows come [[\\server\share|questa]] sono riconosciute.+Notes:
  
-Per approfondimenti si veda la sezione ​[[en:wiki:​syntax#​Windows Shares]] (in inglese)+  * For security reasons direct browsing of windows shares only works in Microsoft Internet Explorer per default (and only in the "local zone"​). 
 +  * For Mozilla and Firefox it can be enabled through different workaround mentioned in the [[http://​kb.mozillazine.org/​Links_to_local_pages_do_not_work|Mozilla Knowledge Base]]. However, there will still be a JavaScript warning about trying to open a Windows Share. To remove this warning ​(for all users), put the following line in ''​conf/​lang/​en/​lang.php''​ (more details at [[doku>​localization#​changing_some_localized_texts_and_strings_in_your_installation|localization]]): <code - conf/​lang/​en/​lang.php>​ 
 +<?php 
 +/** 
 + * Customization of the english language file 
 + * Copy only the strings that needs to be modified 
 + */ 
 +$lang['​js'​]['​nosmblinks'​] = '';​ 
 +</​code>​
  
 +==== Image Links ====
  
-==== Collegamenti con immagini ====+You can also use an image to link to another internal or external page by combining the syntax for links and [[#​images_and_other_files|images]] (see below) like this:
  
-Potete usare una immagine come collegamento a una pagina interna o esterna combinando la sintassi dei collegamenti e delle [[#Immagini e Altri File|immagini]] (si veda sotto) come qui:+  ​[[http://​php.net|{{wiki:​dokuwiki-128.png}}]]
  
-  ​[[http://www.php.net|{{wiki:​dokuwiki-128.png}}]]+[[http://​php.net|{{wiki:​dokuwiki-128.png}}]]
  
-[[http://www.php.net|{{wiki:​dokuwiki-128.png}}]]+Please noteThe image formatting is the only formatting syntax accepted in link names.
  
-Nota: la formattazione dell'​immagine è l'​unica accettata nei nomi dei collegamenti.+The whole [[#​images_and_other_files|image]] and [[#​links|link]] syntax is supported (including image resizing, internal and external images and URLs and interwiki links).
  
-Sono completamente supportate le sintassi dell'​[[#​images_and_other_files|immagine]] e dei [[#​links|collegamenti]] (inclusi il ridimensionamento dell'​immagine,​ le immagini interne ed esterne e i collegamenti interwiki e a URL).+===== Footnotes =====
  
-===== Note piè di pagina =====+You can add footnotes ((This is footnote)) by using double parentheses.
  
-Potete aggiungere note a piè di pagina ​((Questa è una nota piè di pagina)) scrivendole tra doppie parentesi tonde.+  You can add footnotes ​((This is footnote)) by using double parentheses.
  
-  Potete aggiungere note a piè di pagina ((Questa è una nota a piè di pagina)) scrivendole tra doppie parentesi tonde.+===== Sectioning =====
  
 +You can use up to five different levels of headlines to structure your content. If you have more than three headlines, a table of contents is generated automatically -- this can be disabled by including the string ''<​nowiki>​~~NOTOC~~</​nowiki>''​ in the document.
  
-===== Sezioni ​=====+==== Headline Level 3 ==== 
 +=== Headline Level 4 === 
 +== Headline Level 5 ==
  
-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 ''<​nowiki>​~~NOTOC~~</​nowiki>''​.+  ==== Headline Level 3 ==== 
 +  === Headline Level 4 === 
 +  == Headline Level 5 ==
  
-==== Intestazione di Livello 3 ==== +By using four or more dashes, you can make a horizontal line:
-=== 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:​ +===== Media Files =====
- +
-----+
  
-===== Immagini e Altri File =====+You can include external and internal [[doku>​images|images,​ videos and audio files]] with curly brackets. Optionally you can specify the size of them.
  
-Potete includere [[doku>​images|immagini]] esterne e interne usando parentesi graffe. Opzionalmente potete specificare la loro dimensione.+Real size:                        {{wiki:​dokuwiki-128.png}}
  
-Dimensione reale                            ​{{wiki:​dokuwiki-128.png}}+Resize to given width           {{wiki:​dokuwiki-128.png?50}}
  
-Ridimensionamento a una data larghezza      ​{{wiki:​dokuwiki-128.png?​50}}+Resize to given width and height((when the aspect ratio of the given width and height doesn'​t match that of the image, it will be cropped to the new ratio before resizing)): {{wiki:​dokuwiki-128.png?​200x50}}
  
-Ridimensionamento a larghezza e altezza date ((quando le nuove proporzioni non combaciano a quelle dell'​immagine,​ questa verrà tagliata alle nuove proporzioni prima di venire ridimensionata)): {{wiki:dokuwiki-128.png?200x50}}+Resized external image          ​{{http://php.net/​images/​php.gif?200x50}}
  
-Immagine esterna ridimensionata             {{http://de3.php.net/​images/​php.gif?​200x50}}+  Real size                       ​{{wiki:​dokuwiki-128.png}} 
 +  Resize to given width: ​           {{wiki:​dokuwiki-128.png?​50}} 
 +  Resize to given width and height: {{wiki:​dokuwiki-128.png?​200x50}} 
 +  Resized external image: ​          {{http://​php.net/​images/​php.gif?​200x50}}
  
-  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.+By using left or right whitespaces you can choose the alignment.
  
 {{ wiki:​dokuwiki-128.png}} {{ wiki:​dokuwiki-128.png}}
Linea 153: Linea 157:
   {{ wiki:​dokuwiki-128.png }}   {{ wiki:​dokuwiki-128.png }}
  
-Potete aggiungere un titolo ​(mostrato dalla maggioranza dei browser come un suggerimento).+Of course, you can add a title (displayed as a tooltip by most browsers), too.
  
-{{ wiki:​dokuwiki-128.png |Questa è la didascalia}}+{{ wiki:​dokuwiki-128.png |This is the caption}}
  
-  {{ wiki:​dokuwiki-128.png |Questa è la didascalia}}+  {{ wiki:​dokuwiki-128.png |This is the caption}}
  
-Se il nome del file (esterno o interno) non è un'​immagine (''​gif,​ jpeg, png''​),​ allora il file verrà mostrato come un collegamento.+For linking an image to another page see [[#Image Links]] above.
  
-Per usare un'​immagine come collegamento a un'​altra pagina si veda [[#​Collegamenti con immagini]] sopra.+==== Supported Media Formats ====
  
 +DokuWiki can embed the following media formats directly.
  
-===== Elenchi =====+| Image | ''​gif'',​ ''​jpg'',​ ''​png'' ​ | 
 +| Video | ''​webm'',​ ''​ogv'',​ ''​mp4''​ | 
 +| Audio | ''​ogg'',​ ''​mp3'',​ ''​wav'' ​ | 
 +| Flash | ''​swf'' ​                   |
  
-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.+If you specify a filename that is not a supported media format, then it will be displayed as a link instead.
  
-  * Questo è un elenco +By adding ''?​linkonly''​ you provide a link to the media without displaying it inline
-  * Il secondo elemento +
-    * Potete avere diversi livelli +
-  * Un altro elemento+
  
-  - Lo stesso elenco ma numerato +  ​{{wiki:​dokuwiki-128.png?​linkonly}} 
-  - Un altro elemento + 
-    - Usate l'​indentazione per ulteriori livelli +{{wiki:​dokuwiki-128.png?​linkonly}} This is just a link to the image. 
-  - E così via+ 
 +==== Fallback Formats ==== 
 + 
 +Unfortunately not all browsers understand all video and audio formats. To mitigate the problem, you can upload your file in different formats for maximum browser compatibility. 
 + 
 +For example consider this embedded mp4 video: 
 + 
 +  ​{{video.mp4|A funny video}} 
 + 
 +When you upload a ''​video.webm''​ and ''​video.ogv''​ next to the referenced ''​video.mp4'',​ DokuWiki will automatically add them as alternatives so that one of the three files is understood by your browser. 
 + 
 +Additionally DokuWiki supports a "​poster"​ image which will be shown before the video has started. That image needs to have the same filename as the video and be either a jpg or png file. In the example above a ''​video.jpg''​ file would work. 
 + 
 +===== Lists ===== 
 + 
 +Dokuwiki supports ordered and unordered lists. To create a list item, indent your text by two spaces and use a ''​*''​ for unordered lists or a ''​-''​ for ordered ones. 
 + 
 +  * This is a list 
 +  * The second item 
 +    ​* You may have different levels 
 +  * Another item 
 + 
 +  ​The same list but ordered 
 +  - Another item 
 +    - Just use indention for deeper levels 
 +  - That's it
  
 <​code>​ <​code>​
-  * Questo è un elenco +  * This is a list 
-  * Il secondo elemento +  * The second item 
-    * Potete avere diversi livelli +    * You may have different levels 
-  * Un altro elemento+  * Another item
  
-  - Lo stesso elenco ma numerato +  - The same list but ordered 
-  - Un altro elemento +  - Another item 
-    - Usate l'​indentazione per ulteriori livelli +    - Just use indention for deeper levels 
-  - E così via+  - That's it
 </​code>​ </​code>​
  
-Per approfondimenti vi rimandiamo alla [[doku>​faq:​lists|FAQ ​sugli elementi degli elenchi]] (in inglese).+Also take a look at the [[doku>​faq:​lists|FAQ ​on list items]].
  
-===== Conversioni di Testi =====+===== Text Conversions ​=====
  
-Si veda la relativa sezione [[en:​wiki:​syntax#​Texts Conversions]] (in inglese).+DokuWiki can convert certain pre-defined characters or strings into images or other text or HTML.
  
 +The text to image conversion is mainly done for smileys. And the text to HTML conversion is used for typography replacements,​ but can be configured to use other HTML as well.
  
-===== Citazioni =====+==== Text to Image Conversions ​====
  
-Si veda la relativa sezione ​[[en:​wiki:​syntax#​Quoting]] (in inglese).+DokuWiki converts commonly used [[wp>​emoticon]]s to their graphical equivalentsThose [[doku>​Smileys]] and other images can be configured and extended. Here is an overview of Smileys included in DokuWiki:
  
 +  * 8-) %%  8-)  %%
 +  * 8-O %%  8-O  %%
 +  * :-( %%  :-(  %%
 +  * :-) %%  :-)  %%
 +  * =)  %%  =)   %%
 +  * :-/ %%  :-/  %%
 +  * :-\ %%  :-\  %%
 +  * :-? %%  :-?  %%
 +  * :-D %%  :-D  %%
 +  * :-P %%  :-P  %%
 +  * :-O %%  :-O  %%
 +  * :-X %%  :-X  %%
 +  * :-| %%  :-|  %%
 +  * ;-) %%  ;-)  %%
 +  * ^_^ %%  ^_^  %%
 +  * :?: %%  :?:  %%
 +  * :!: %%  :!:  %%
 +  * LOL %%  LOL  %%
 +  * FIXME %%  FIXME %%
 +  * DELETEME %% DELETEME %%
  
-===== Tabelle =====+==== Text to HTML Conversions ​====
  
-Per creare tabelle ​DokuWiki ​supporta una sintassi semplice.+Typography: [[DokuWiki]] can convert simple text characters to their typographically correct entities. Here is an example of recognized characters.
  
-^ Intestazione 1 ^ Intestazione 2  ^ Intestazione 3     ^ +-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r
-| Riga 1 Col 1   | Riga 1 Col 2    | Riga 1 Col 3       | +"He thought '​It'​s a man's world'​..."​
-| 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.+<​code>​ 
 +-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) 
 +"He thought ​'It's a man's world'..." 
 +</​code>​
  
-  ^ Intestazione 1 ^ Intestazione 2  ^ Intestazione 3     ^ +The same can be done to produce any kind of HTML, it just needs to be added to the [[doku>​entities|pattern file]].
-  | 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 sopraAssicuratevi di avere sempre lo stesso numero di separatori di cella!+There are three exceptions which do not come from that pattern file: multiplication entity (640x480), '​single'​ and "​double quotes"​. They can be turned off through a [[doku>​config:​typography|config option]].
  
-Sono inoltre disponibili intestazioni verticali.+===== Quoting =====
  
 +Some times you want to mark some text to show it's a reply or comment. You can use the following syntax:
  
-|                 ^ Intestazione 1                  ^ Intestazione 2     ^ +<​code>​ 
-^ Intestazione 3  | Riga 1 Col 2                    | Riga 1 Col 3       | +I think we should do it
-^ 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:​+> No we shouldn'​t
  
-  |                 ^ Intestazione 1                  ^ Intestazione 2     ^ +>> Well, I say we should
-  ^ 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.+> Really?
  
-^ Intestazione 1  ^ Intestazione 2                        ^ Intestazione 3      ^ +>> Yes!
-| 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.+>>>​ Then lets do it! 
 +</​code>​
  
-  ^ Intestazione 1  ^ Intestazione 2                        ^ Intestazione 3      ^ +I think we should do it
-  | 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.+> No we shouldn'​t
  
-^          Tabella con allineamenti ​        ^^^ +>> Well, I say we should
-|        destra| ​   centro ​    ​|sinistra ​     | +
-|sinistra ​     |         ​destra| ​   centro ​   | +
-| xxxxxxxxxxxx | xxxxxxxxxxxx ​ | xxxxxxxxxxxx |+
  
 +> Really?
  
-Nella sorgente della pagina è scritta in questo modo:+>> Yes!
  
-  ^          Tabella con allineamenti ​        ^^^ +>>>​ Then lets do it!
-  |        destra| ​   centro ​    ​|sinistra ​     | +
-  |sinistra ​     |         ​destra| ​   centro ​   | +
-  | xxxxxxxxxxxx | xxxxxxxxxxxx ​ | xxxxxxxxxxxx |+
  
-Nota: l'​allineamento verticale non è supportato.+===== Tables =====
  
-===== Nessuna Formattazione =====+DokuWiki supports a simple syntax to create tables.
  
-Se avete bisogno di mostrare il testo esattamente come è scritto ​(senza alcuna formattazione), racchiudete l'​area ​con il tag ''​%%<​nowiki>​%%'' ​o più semplicementecon due caratteri di percento ​''<​nowiki>​%%</​nowiki>''​.+^ Heading 1      ^ Heading 2       ^ Heading 3          ^ 
 +| Row 1 Col 1    | Row 1 Col 2     | Row 1 Col 3        | 
 +| Row 2 Col 1    | some colspan ​(note the double pipe|| 
 +| Row 3 Col 1    | Row 3 Col 2     | Row 3 Col 3        | 
 + 
 +Table rows have to start and end with a ''​|''​ for normal rows or a ''​^''​ for headers. 
 + 
 +  ^ Heading 1      ^ Heading 2       ^ Heading 3          ^ 
 +  | Row 1 Col 1    | Row 1 Col 2     | Row 1 Col 3        | 
 +  | Row 2 Col 1    | some colspan (note the double pipe) || 
 +  | Row 3 Col 1    | Row 3 Col 2     | Row 3 Col 3        | 
 + 
 +To connect cells horizontallyjust make the next cell completely empty as shown above. Be sure to have always the same amount of cell separators! 
 + 
 +Vertical tableheaders are possible, too. 
 + 
 +|              ^ Heading 1            ^ Heading 2          ^ 
 +^ Heading 3    | Row 1 Col 2          | Row 1 Col 3        | 
 +^ Heading 4    | no colspan this time |                    | 
 +^ Heading 5    | Row 2 Col 2          | Row 2 Col 3        | 
 + 
 +As you can see, it's the cell separator before a cell which decides about the formatting:​ 
 + 
 +  |              ^ Heading 1            ^ Heading 2          ^ 
 +  ^ Heading 3    | Row 1 Col 2          | Row 1 Col 3        | 
 +  ^ Heading 4    | no colspan this time |                    | 
 +  ^ Heading 5    | Row 2 Col 2          | Row 2 Col 3        | 
 + 
 +You can have rowspans (vertically connected cells) by adding ''​%%:::​%%''​ into the cells below the one to which they should connect. 
 + 
 +^ Heading 1      ^ Heading 2                  ^ Heading 3          ^ 
 +| Row 1 Col 1    | this cell spans vertically | Row 1 Col 3        | 
 +| Row 2 Col 1    | :::                        | Row 2 Col 3        | 
 +| Row 3 Col 1    | :::                        | Row 2 Col 3        | 
 + 
 +Apart from the rowspan syntax those cells should not contain anything else. 
 + 
 +  ^ Heading 1      ^ Heading 2                  ^ Heading 3          ^ 
 +  | Row 1 Col 1    | this cell spans vertically | Row 1 Col 3        | 
 +  | Row 2 Col 1    | :::                        | Row 2 Col 3        | 
 +  | Row 3 Col 1    | :::                        | Row 2 Col 3        | 
 + 
 +You can align the table contents, too. Just add at least two whitespaces at the opposite end of your text: Add two spaces on the left to align right, two spaces on the right to align left and two spaces at least at both ends for centered text. 
 + 
 +^           Table with alignment ​          ^^^ 
 +|         ​right| ​   center ​   |left          | 
 +|left          |         ​right| ​   center ​   | 
 +| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | 
 + 
 +This is how it looks in the source: 
 + 
 +  ^           Table with alignment ​          ^^^ 
 +  |         ​right| ​   center ​   |left          | 
 +  |left          |         ​right| ​   center ​   | 
 +  | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | 
 + 
 +Note: Vertical alignment is not supported. 
 + 
 +===== No Formatting ===== 
 + 
 +If you need to display text exactly like it is typed (without any formatting),​ enclose the area either with ''​%%<​nowiki>​%%'' ​tags or even simplerwith double percent signs ''<​nowiki>​%%</​nowiki>''​.
  
 <​nowiki>​ <​nowiki>​
-Questo è del testo contenente indirizzi come questo: http://​www.splitbrain.org ​**formattazione**, ma non viene elaborato.+This is some text which contains addresses like this: http://​www.splitbrain.org ​and **formatting**, but nothing is done with it.
 </​nowiki>​ </​nowiki>​
- +The same is true for %%//__this__ text// with a smiley ;-)%%.
-Lo stesso avviene per %%//__questo__ testo// con uno smiley ;-)%%.+
  
   <​nowiki>​   <​nowiki>​
-  ​Questo è del testo contenente indirizzi come questo: http://​www.splitbrain.org ​**formattazione**, ma non viene elaborato.+  ​This is some text which contains addresses like this: http://​www.splitbrain.org ​and **formatting**, but nothing is done with it.
   </​nowiki>​   </​nowiki>​
-  ​ +  ​The same is true for %%//__this__ text// with a smiley ;-)%%.
-  Lo stesso avviene per %%//__questo__ testo// con uno smiley ;-)%%.+
  
-===== Blocchi Codice ​=====+===== Code Blocks ​=====
  
-Nei vostri documenti potete inserire blocchi di codice indentandoli con almeno due spazi (come è stato fatto per gli esempi precedentio usando i tag ''​%%<​code>​%%'' ​''​%%file%%''​.+You can include code blocks into your documents by either indenting them by at least two spaces ​(like used for the previous examplesor by using the tags ''​%%<​code>​%%'' ​or ''​%%<file>%%''​.
  
-  ​Questo testo è indentato con due spazi.+  ​This is text is indented by two spaces.
  
 <​code>​ <​code>​
-In questo codice sono preservati tutti gli spazicome            ​<-questo+This is preformatted code all spaces are preservedlike              ​<-this
 </​code>​ </​code>​
  
 <​file>​ <​file>​
-Per questo è circa lo stessoma potete usarlo per evidenziare che avete citato un file.+This is pretty much the samebut you could use it to show that you quoted a file.
 </​file>​ </​file>​
  
-I blocchi mostrati sono creati così:+Those blocks were created by this source:
  
-      Questo testo è indentato con due spazi.+    This is text is indented by two spaces.
  
   <​code>​   <​code>​
-  ​In questo codice sono preservati tutti gli spazicome            ​<-questo+  ​This is preformatted code all spaces are preservedlike              ​<-this
   </​code>​   </​code>​
  
   <​file>​   <​file>​
-  ​Per questo è circa lo stessoma potete usarlo per evidenziare che avete citato un file.+  ​This is pretty much the samebut you could use it to show that you quoted a file.
   </​file>​   </​file>​
  
Linea 324: Linea 417:
 </​code>​ </​code>​
  
-The following language strings are currently recognized: //4cs6502acme6502kickass6502tasm68000devpacabapactionscript-french, actionscript,​ actionscript3, ​adaalgol68apacheapplescriptasmaspautoconfautohotkeyautoitavisynthawkbascomavrbashbasic4glbfbibtexblitzbasicbnfboo, c, c_loadrunner,​ c_mac, ​caddclcadlispcfdgcfmchaiscriptcilclojurecmakecobolcoffeescriptcppcpp-qtcsharpcsscuesheet, d, dcsdelphidiffdivdosdot, e, epc, ecmascripteiffelemailerlangeuphoriaf1falconfofortranfreebasicfsharpgambasgenerogenie, gdb, glslgmlgnuplotgogroovy, gettext, ​gwbasichaskellhicesthq9plushtmlhtml5iconidliniinnointercalio, j, java5javajavascriptjquerykixtartklonecklonecpplatexlblispllvmlocobasiclogtalklolcodelotusformulaslotusscriptlscriptlsl2luam68kmagiksfmakemapbasicmatlabmircmodula2modula3, mmix, mpasmmxmlmysqlnewlispnsisoberon2objcobjeckocaml-briefocamloobasoracle8, oracle11, ​oxygeneozpascalpcreperl, perl6, ​perpfphp-briefphppike, pic16, ​pixelbenderpliplsqlpostgresqlpovraypowerbuilderpowershellproftpdprogressprologpropertiesprovidexpurebasicpyconpythonq, qbasic, ​railsrebolregrobotsrpmspecrsplusrubysasscalaschemescilabsdlbasicsmalltalksmartysqlsystemverilogtclteratermtextthinbasictsqltyposcriptuniconuscriptvalavbnetvbverilogvhdlvimvisualfoxprovisualprologwhitespacewinbatch, whois, ​xbasicxmlxorg_confxppyamlz80zxbasic//+The following language strings are currently recognized: //4cs 6502acme 6502kickass 6502tasm 68000devpac abap actionscript3 ​actionscript ada aimms algol68 apache applescript ​apt_sources arm asm asp asymptote ​autoconf autohotkey autoit avisynth awk bascomavr bash basic4gl ​batch bf biblatex ​bibtex blitzbasic bnf boo caddcl cadlisp ​ceylon ​cfdg cfm chaiscript ​chapel ​cil c_loadrunner ​clojure ​c_mac cmake cobol coffeescript ​cpp cpp-qt ​cpp-winapi ​csharp css cuesheet ​c_winapi dart dcl dcpu16 ​dcs delphi diff div dos dot ecmascript eiffel email epc e erlang euphoria ​ezt f1 falcon fo fortran freebasic ​freeswitch ​fsharp gambas ​gdb genero genie gettext ​glsl gml gnuplot go groovy gwbasic haskell ​haxe hicest hq9plus html html4strict ​html5 icon idl ini inno intercal io ispfpanel ​java5 java javascript ​jcl j jquery ​julia kixtart klonec klonecpp ​kotlin ​latex lb ldif lisp llvm locobasic logtalk lolcode lotusformulas lotusscript lscript lsl2 lua m68k magiksf make mapbasic ​mathematica ​matlab ​mercury metapost ​mirc mk-61 mmix modula2 modula3 mpasm mxml mysql nagios netrexx ​newlisp ​nginx nimrod ​nsis oberon2 objc objeck ocaml-brief ocaml octave ​oobas oorexx oracle11 ​oracle8 oxygene oz parasail parigp ​pascal pcre perl6 perl per pf phix php-brief php pic16 pike pixelbender pli plsql postgresql ​postscript ​povray powerbuilder powershell proftpd progress prolog properties providex purebasic pycon pys60 python ​qbasic qml racket ​rails rbs rebol reg rexx robots rpmspec rsplus ruby rust sas sass scala scheme scilab ​scl sdlbasic smalltalk smarty ​spark sparql ​sql standardml stonescript swift systemverilog ​tclegg ​tcl teraterm ​texgraph ​text thinbasic tsql twig typoscript unicon ​upc urbi uscript vala vbnet vb vbscript vedit verilog vhdl vim visualfoxpro visualprolog whitespace ​whois winbatch xbasic xml xojo xorg_conf xpp yaml z80 zxbasic// 
 + 
 +There are additional [[doku>​syntax_highlighting|advanced options]] available for syntax highlighting,​ such as highlighting lines or adding line numbers.
  
 ==== Downloadable Code Blocks ==== ==== Downloadable Code Blocks ====
Linea 369: Linea 464:
 <​code>​ <​code>​
 <php> <php>
-echo 'A logo generated by PHP:';​ +echo 'The PHP version: '; 
-echo '<​img src="'​ . $_SERVER['​PHP_SELF'​] . '?​='​ . php_logo_guid() . '"​ alt="​PHP Logo !" />'+echo phpversion(); 
-echo '​(generated inline HTML)';​+echo ' (generated inline HTML)';​
 </​php>​ </​php>​
 <PHP> <PHP>
 echo '<​table class="​inline"><​tr><​td>​The same, but inside a block level element:</​td>';​ 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 '<​td>'​.phpversion().'</​td>';​
 echo '</​tr></​table>';​ echo '</​tr></​table>';​
 </​PHP>​ </​PHP>​
Linea 381: Linea 476:
  
 <php> <php>
-echo 'A logo generated by PHP:';​ +echo 'The PHP version: '; 
-echo '<​img src="'​ . $_SERVER['​PHP_SELF'​] . '?​='​ . php_logo_guid() . '"​ alt="​PHP Logo !" />'+echo phpversion(); 
-echo '​(inline HTML)';​+echo ' (inline HTML)';​
 </​php>​ </​php>​
 <PHP> <PHP>
 echo '<​table class="​inline"><​tr><​td>​The same, but inside a block level element:</​td>';​ 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 '<​td>'​.phpversion().'</​td>';​
 echo '</​tr></​table>';​ echo '</​tr></​table>';​
 </​PHP>​ </​PHP>​
Linea 402: Linea 497:
 | date       | show item dates | | date       | show item dates |
 | description| show the item description. If [[doku>​config:​htmlok|HTML]] is disabled all tags will be stripped | | description| show the item description. If [[doku>​config:​htmlok|HTML]] is disabled all tags will be stripped |
 +| nosort ​    | do not sort the items in the feed |
 | //n//[dhm] | refresh period, where d=days, h=hours, m=minutes. (e.g. 12h = 12 hours). | | //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. [[wiki:​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 [[wiki:​DokuWiki]] to re-render the page if it is more than //refresh period// since the page was last rendered. The refresh period defaults to 4 hours. Any value below 10 minutes will be treated as 10 minutes. [[wiki:​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 [[wiki:​DokuWiki]] to re-render the page if it is more than //refresh period// since the page was last rendered.
 +
 +By default the feed will be sorted by date, newest items first. You can sort it by oldest first using the ''​reverse''​ parameter, or display the feed as is with ''​nosort''​.
  
 **Example:​** **Example:​**
Linea 426: Linea 524:
  
 ~~INFO:​syntaxplugins~~ ~~INFO:​syntaxplugins~~
 +
wiki/syntax.txt · Ultima modifica: 27/07/2018 17:40 (modifica esterna)