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 [30/04/2019 13:58] – Traduzione lorenzowiki:syntax [02/03/2024 13:32] (versione attuale) – modifica esterna 127.0.0.1
Linea 1: Linea 1:
-====== Sintassi di formattazione ====== +====== Formatting Syntax ======
-[[DokuWiki]] supporta del semplice linguaggio di formattazione, che cerca di rendere i file dei dati più leggibili possibile. Questa pagina contiene tutta la sintassi che si può usare quando si modificano le pagine. Basta dare semplicemente un'occhiata al codice sorgente di questa pagina premendo il bottone //Modifica questa pagina// //(Edit this page)// in alto o in fondo alla pagina. Se volete fare qualche prova, usate la pagina [[playground:playground|playground]]. La formattazione più semplice è facilmente accessibile anche attraverso i [[doku>it:toolbar|pulsanti veloci]]. +
-===== Basi per la Formattazione del testo =====+
  
-DokuWiki supporta testi in **grassetto**//corsivo//__sottolineato__ ed ''equispaziato''Naturalmente tutti questi si possono **__//''combinare''//__**.+[[doku>DokuWiki]] supports some simple markup languagewhich tries to make the datafiles to be as readable as possible. This page contains all possible syntax you may use when editing the pages. Simply have a look at the source of this page by pressing "Edit this page". If you want to try somethingjust use the [[playground:playground|playground]] pageThe simpler markup is easily accessible via [[doku>toolbar|quickbuttons]], too.
  
-  DokuWiki supporta testi in **grassetto**, //corsivo//, __sottolineato__ ed ''equispaziato''+===== Basic Text Formatting =====
-  Naturalmente tutti questi si possono **__//''combinare''//__**.+
  
-Si possono usare anche <sub>pedici</sub> e <sup>apici</sup>.+DokuWiki supports **bold**, //italic//, __underlined__ and ''monospaced'' texts. Of course you can **__//''combine''//__** all these.
  
-  Si possono usare anche <sub>pedici</sub> e <sup>apici</sup>.+  DokuWiki supports **bold**, //italic//, __underlined__ and ''monospaced'' texts. 
 +  Of course you can **__//''combine''//__** all these.
  
-Inoltre si può contrassegnare qualcosa come <del>cancellato</del>.+You can use <sub>subscript</suband <sup>superscript</sup>, too.
  
-  Inoltre si può contrassegnare qualcosa come <del>cancellato</del>.+  You can use <sub>subscript</suband <sup>superscript</sup>, too.
  
-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.+You can mark something as <del>deleted</del> as well.
  
-Questo è del testo con qualche interruzione di linea\\ Notare che le +  You can mark something as <del>deleted</del> as well.
-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 +**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.
-  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 capo forzati dovrebbero essere usati solo quando realmente necessari. +This is some text with some linebreaks\\ Note that the 
-===== Collegamenti =====+two backslashes are only recognized at the end of line\\ 
 +or followed by\\ a whitespace \\this happens without it.
  
-DokuWiki supporta molteplici modi per la creazione di collegamenti. +  This is some text with some linebreaks\\ Note that the 
-==== Esterni ====+  two backslashes are only recognized at the end of a line\\ 
 +  or followed by\\ a whitespace \\this happens without it.
  
-I collegamenti esterni sono riconosciuti automagicamente: http://www.google.com o semplicemente www.google.com - Si possono impostare anche i testi dei collegamenti: [[http://www.google.com|Questo collegamento punta a Google]]. Gli indirizzi di posta elettronica come questo: <[email protected]> sono pure riconosciuti.+You should use forced newlines only if really needed.
  
-  DokuWiki supporta molteplici modi per la creazione di collegamenti. I collegamenti esterni sono riconosciuti +===== Links =====
-  automagicamente: http://www.google.com o semplicemente www.google.com - Si possono impostare +
-  anche i testi dei collegamenti: [[http://www.google.com|Questo collegamento punta a Google]]. Gli indirizzi +
-  di posta elettronica come questo: <[email protected]> sono pure riconosciuti. +
-==== Interni ====+
  
-I collegamenti interni sono creati usando le parentesi quadre. Si può immettere un [[it:pagename|nome pagina]] o, in alternativa, un [[it:pagename|testo del collegamento]] aggiuntivo.+DokuWiki supports multiple ways of creating links.
  
-  I collegamenti interni sono creati usando le parentesi quadre. Si può immettere un [[it:pagename|nome pagina]] +==== External ====
-  o, in alternativa, un [[it:pagename|testo del collegamento]] aggiuntivo. +
  
-[[it:pagename|I nomi delle pagine wiki]] sono convertiti automaticamente in minuscoloi caratteri speciali non sono consentiti.+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: <[email protected]> are recognizedtoo.
  
-Si può specificare la [[it:namespaces|categoria]] usando i due punti (:) nel nome della pagina.+  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<[email protected]> are recognized, too.
  
-  Si può specificare la [[it:namespaces|categoria]] usando i due punti (:) nel nome della pagina.+==== Internal ====
  
-Per i dettagli si veda [[it:namespaces|categorie]].+Internal links are created by using square brackets. You can either just give a [[pagename]] or use an additional [[pagename|link text]].
  
-È pure possibile realizzare collegamenti a una specifica sezioneÈ sufficiente aggiungere il nome della sezione prima del carattere //diesis// (#), come è noto dall'HTML. Questo collegamento punta a [[syntax#interni|questa Sezione]].+  Internal links are created by using square bracketsYou can either just give 
 +  a [[pagename]] or use an additional [[pagename|link text]].
  
-  Questo collegamento punta a [[syntax#interni|questa Sezione]].+[[doku>pagename|Wiki pagenames]] are converted to lowercase automatically, special characters are not allowed.
  
-Note:+You can use [[some:namespaces]] by using a colon in the pagename.
  
-  * I collegamenti a [[it:syntax|pagine esistenti]] sono visualizzati con uno stile differente da quelle [[inesistenti]]. +  You can use [[some:namespaces]] by using a colon in the pagename.
-  * DokuWiki non usa la sintassi [[wp>CamelCase]] per creare collegamenti in modo predefinito, ma questo comportamento può essere abilitato nel file [[doku>config]]. Suggerimento: se DokuWiki è un collegamento, allora esso è abilitato. +
-  * Quando l'intestazione di una sezione è modificata, anche il suo segnalibro (//bookmark//) cambia. Pertanto non bisogna fare troppo affidamento sui collegamenti alle sezioni.+
  
-==== Interwiki ====+For details about namespaces see [[doku>namespaces]].
  
-Dokuwiki supporta i collegamenti [[doku>it:interwiki|Interwiki]]Si tratta di collegamenti rapidi ad altri WikiPer esempio, questo collegamento punta alla pagina di Wikipedia riguardante i Wiki: [[wp>Wiki]].+Linking to a specific section is possible, tooJust add the section name behind a hash character as known from HTMLThis links to [[syntax#internal|this Section]].
  
-  Dokuwiki supporta i collegamenti [[doku>it:interwiki|Interwiki]]. Si tratta di collegamenti rapidi ad altri Wiki. +  This links to [[syntax#internal|this Section]].
-  Per esempio, questo collegamento punta alla pagina di Wikipedia riguardante i Wiki: [[wp>Wiki]].+
  
 +Notes:
  
-==== Partizioni Windows ====+  * 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.
  
-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 [[wp>Intranet]] aziendale.+==== Interwiki ====
  
-  Le partizioni Windows come [[\\server\share|questa]] sono pure riconosciute.+DokuWiki supports [[doku>Interwiki]] links. These are quick links to other Wikis. For example this is a link to Wikipedia's page about Wikis: [[wp>Wiki]].
  
-Note:+  DokuWiki supports [[doku>Interwiki]] links. These are quick links to other Wikis. 
 +  For example this is a link to Wikipedia's page about Wikis[[wp>Wiki]].
  
-  * Per ragioni di sicurezza la navigazione diretta di partizioni Windows funziona solo in Microsoft Internet Explorer, in modo predefinito (e soltanto nella "zona locale"). +==== Windows Shares ====
-  * Per Mozilla e Firefox questa può essere abilitata mediante l'opzione di configurazione [[http://www.mozilla.org/quality/networking/docs/netprefs.html#file|security.checkloaduri]] ma non è raccomandata. +
-  * Vedere [[bug>151]] per maggiori informazioni. +
-==== Collegamenti a immagini ====+
  
-Si può anche usare un'immagine per creare un collegamento a un'altra pagina, interna o esterna, combinando la sintassi per i collegamenti e per le [[#Immagini e altri file|immagini]] (vedi sotto) come questa:+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]].
  
-  [[http://www.php.net|{{wiki:dokuwiki-128.png}}]]+  Windows Shares like [[\\server\share|this]] are recognized, too.
  
-[[http://www.php.net|{{wiki:dokuwiki-128.png}}]]+Notes:
  
-Notarela formattazione dell'immagine è l'unica sintassi di formattazione accettata nei nomi dei collegamenti.+  * 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>
  
-L'intera sintassi delle [[#Immagini e altri file|immagini]] e dei [[#collegamenti]] è supportata (incluso il ridimensionamento, immagini interne ed esterne e i collegamenti di tipo URL e interwiki).+==== Image Links ====
  
------+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:
  
 +  [[http://php.net|{{wiki:dokuwiki-128.png}}]]
  
-===== Note a piè di pagina =====+[[http://php.net|{{wiki:dokuwiki-128.png}}]]
  
-Si possono aggiungere note a piè di pagina ((Questa è una nota a piè di pagina)) usando parentesi doppie.+Please note: The image formatting is the only formatting syntax accepted in link names.
  
-  Si possono aggiungere note a piè di pagina ((Questa è una nota a piè di pagina)usando parentesi doppie. +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).
-===== Suddivisione in sezioni =====+
  
-Si possono usare fino a cinque differenti livelli di intestazione per strutturare il contenuto. Se si hanno più di tre intestazioni, un indice dei contenuti è generato automaticamente - ciò può essere disabilitato includendo la stringa ''<nowiki>~~NOTOC~~</nowiki>'' nel documento.+===== Footnotes =====
  
 +You can add footnotes ((This is a footnote)) by using double parentheses.
  
-==== Livello di intestazione 3 ==== +  You can add footnotes ((This is a footnote)) by using double parentheses.
-=== Livello di intestazione 4 === +
-== Livello di intestazione 5 ==+
  
-  ==== Livello di intestazione 3 ==== +===== Sectioning ===== 
-  === Livello di intestazione 4 === + 
-  == Livello di intestazione 5 ==+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. 
 + 
 +==== Headline Level 3 ==== 
 +=== Headline Level 4 === 
 +== Headline Level 5 == 
 + 
 +  ==== Headline Level 3 ==== 
 +  === Headline Level 4 === 
 +  == Headline Level 5 == 
 + 
 +By using four or more dashes, you can make a horizontal line:
  
-Usando quattro o più trattini, si può fare una linea orizzontale: 
 ---- ----
-===== Immagini e altri file ===== 
  
-Si possono includere [[doku>immagini]] esterne e interne mediante parentesi graffe. In alternativa, se ne possono specificare le dimensioni.+===== Media Files =====
  
-Dimensione reale:                        {{wiki:dokuwiki-128.png}}+You can include external and internal [[doku>images|images, videos and audio files]] with curly brackets. Optionally you can specify the size of them.
  
-Ridimensionata a una larghezza data           {{wiki:dokuwiki-128.png?50}}+Real size                       {{wiki:dokuwiki-128.png}}
  
-Ridimensionata a larghezza e altezza date((quando il rapporto tra la larghezza e l'altezza dati non corrispondono con quelli dell'immagine, verrà ritagliata al nuovo rapporto prima di essere ridimensionata)): {{wiki:dokuwiki-128.png?200x50}}+Resize to given width           {{wiki:dokuwiki-128.png?50}}
  
-Immagine esterna ridimensionata          {{http://de3.php.net/images/php.gif?200x50}}+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}}
  
-  Dimensione reale                       {{wiki:dokuwiki-128.png}} +Resized external image          {{https://www.php.net/images/php.gif?200x50}}
-  Ridimensionata a una larghezza data:            {{wiki:dokuwiki-128.png?50}} +
-  Ridimensionata a larghezza e altezza date: {{wiki:dokuwiki-128.png?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:           {{https://www.php.net/images/php.gif?200x50}}
  
-Usando spazi bianchi a sinistra o a destra si può scegliere l'allineamento.+ 
 +By using left or right whitespaces you can choose the alignment.
  
 {{ wiki:dokuwiki-128.png}} {{ wiki:dokuwiki-128.png}}
Linea 142: Linea 152:
  
 {{ wiki:dokuwiki-128.png }} {{ wiki:dokuwiki-128.png }}
- 
  
   {{ wiki:dokuwiki-128.png}}   {{ wiki:dokuwiki-128.png}}
Linea 148: Linea 157:
   {{ wiki:dokuwiki-128.png }}   {{ wiki:dokuwiki-128.png }}
  
-Naturalmentesi può aggiungere anche un titolo (visualizzato come suggerimento dalla maggior parte dei programmi di navigazione).+Of courseyou 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 si specifica il nome di un file (esterno o interno) che non è un'immagine (''gif, jpeg, png''), allora esso sarà visualizzato come collegamento.+For linking an image to another page see [[#Image Links]] above.
  
-Per collegare un'immagine a un'altra pagina, vedere [[#Collegamenti a immagini]] sopra.+==== Supported Media Formats ====
  
 +DokuWiki can embed the following media formats directly.
  
-===== Liste =====+| Image | ''gif'', ''jpg'', ''png'' 
 +| Video | ''webm'', ''ogv'', ''mp4''
 +| Audio | ''ogg'', ''mp3'', ''wav'' 
 +| Flash | ''swf''                    |
  
-Dokuwiki supporta liste ordinate e non-ordinate. Per creare un elemento di una listaindentare il testo con due spazi e usare un asterisco (''*'') per le liste non ordinate oppure un trattino (''-'') per quelle ordinate.+If you specify a filename that is not a supported media formatthen it will be displayed as a link instead.
  
-  * Questa è una lista +By adding ''?linkonly'' you provide a link to the media without displaying it inline
-  * Il secondo elemento +
-    * Si possono avere livelli differenti +
-  * Un altro elemento+
  
-  - La stessa lista ma ordinata +  {{wiki:dokuwiki-128.png?linkonly}} 
-  - Un altro elemento + 
-    - Usare semplicemente l'indentazione per ottenere livelli più profondi +{{wiki:dokuwiki-128.png?linkonly}} This is just a link to the image. 
-  - È tutto+ 
 +==== 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>
-  * Questa è una lista +  * This is a list 
-  * Il secondo elemento +  * The second item 
-    * Si possono avere livelli differenti +    * You may have different levels 
-  * Un altro elemento+  * Another item
  
-  - La stessa lista ma ordinata +  - The same list but ordered 
-  - Un altro elemento +  - Another item 
-    - Usare semplicemente l'indentazione per ottenere livelli più profondi +    - Just use indention for deeper levels 
-  - È tutto+  - That's it
 </code> </code>
-===== Conversioni di testo ===== 
  
-DokuWiki può convertire alcuni caratteri predefiniti o stringhe in immagini altro testo o HTML.+Also take a look at the [[doku>faq:lists|FAQ on list items]]. 
 + 
 +===== Text Conversions ===== 
 + 
 +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.
  
-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. +==== Text to Image Conversions ====
-==== Conversioni di testo in immagini ====+
  
-DokuWiki converte le [[wp>emoticon]] comunemente usate nei rispettivi equivalenti graficiQueste [[doku>smileys|faccine]] e altre immagini possono essere configurate ed esteseEcco una panoramica delle faccine incluse in DokuWiki.+DokuWiki converts commonly used [[wp>emoticon]]s to their graphical equivalentsThose [[doku>Smileys]] and other images can be configured and extendedHere is an overview of Smileys included in DokuWiki:
  
   * 8-) %%  8-)  %%   * 8-) %%  8-)  %%
Linea 208: Linea 247:
   * ;-) %%  ;-)  %%   * ;-) %%  ;-)  %%
   * ^_^ %%  ^_^  %%   * ^_^ %%  ^_^  %%
 +  * m(  %%  m(   %%
   * :?: %%  :?:  %%   * :?: %%  :?:  %%
   * :!: %%  :!:  %%   * :!: %%  :!:  %%
Linea 213: Linea 253:
   * FIXME %%  FIXME %%   * FIXME %%  FIXME %%
   * DELETEME %% DELETEME %%   * DELETEME %% DELETEME %%
-==== Conversioni di testo in HTML ==== 
  
-[[DokuWiki]] può convertire semplici caratteri di testo nelle rispettive entità tipograficamente corrette. Ecco un esempio dei caratteri riconosciuti.+==== Text to HTML Conversions ====
  
--> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)  +Typography: [[DokuWiki]] can convert simple text characters to their typographically correct entities. Here is an example of recognized characters. 
 + 
 +-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
 "He thought 'It's a man's world'..." "He thought 'It's a man's world'..."
  
 <code> <code>
--> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)  +-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
 "He thought 'It's a man's world'..." "He thought 'It's a man's world'..."
 </code> </code>
  
-La stesso può essere fatto per produrre ogni tipo di codice HTML, e necessario soltanto aggiungerlo nel [[doku>entities|pattern file]]+The same can be done to produce any kind of HTML, it just needs to be added to the [[doku>entities|pattern file]].
  
-Esistono tre eccezioni che non provengono dal pattern file: moltiplicazione di entità (640×480) 'singoledoppie virgolette"Possono essere disattivate tramite un'[[doku>config:typography|opzione di configurazione]] +There are three exceptions which do not come from that pattern file: multiplication entity (640x480)'singleand "double quotes"They can be turned off through a [[doku>config:typography|config option]].
-===== Citazioni =====+
  
-Talvolta si vuole contrasegnare del testo per mostrare che esso è una risposta o un commento. Si può usare la sintassi seguente:+===== Quoting =====
  
-  Penso che dovremmo farlo +Some times you want to mark some text to show it's a reply or comment. You can use the following syntax:
-   +
-  > No, non dovremmo   +
-   +
-  >> Be', dico che dovremmo   +
-   +
-  > Davvero?   +
-   +
-  >> Sì!   +
-   +
-  >>> Allora facciamolo!  +
  
-Penso che dovremmo farlo+<code> 
 +I think we should do it
  
-> No, non dovremmo  +> No we shouldn't
  
->> Be'dico che dovremmo  +>> WellI say we should
  
-Davvero +Really?
  
->>  +>> Yes!
  
->>> Allora facciamolo  +>>> Then lets do it
-===== Tabelle =====+</code>
  
-DokuWiki supporta una semplice sintasi per la creazione di tabelle.+I think we should do it
  
-^ Intestazione 1 ^ Intestazione 2  ^ Intestazione 3      ^ +> No we shouldn't
-| 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.+>> Well, I say we should
  
-  ^ Intestazione 1 ^ Intestazione 2  ^ Intestazione 3      ^ +> Really?
-  | 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!+>> Yes!
  
-È pure possibile realizzare intestazioni verticali di tabella.+>>> Then lets do it!
  
-|                 ^ Intestazione 1              ^ Intestazione 2     ^ +===== Tables =====
-^ 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:+DokuWiki supports a simple syntax to create tables.
  
-  |                 Intestazione              Intestazione     ^ +Heading      Heading       Heading          ^ 
-  Intestazione  Riga 1 Col 2                Riga 1 Col 3       +| Row 1 Col 1    Row 1 Col 2     Row 1 Col 3        
-  ^ Intestazione 4  niente fusione questa volta                    +Row 2 Col 1    | some colspan (note the double pipe) || 
-  ^ Intestazione 5  Riga 2 Col 2                Riga 2 Col 3       |+Row 3 Col 1    Row 3 Col     | Row 3 Col 3        |
  
-Si possono avere celle unite verticalmente aggiungendo '':::'' dentro le celle sotto quella cui devono connettersi.+Table rows have to start and end with a ''|'' for normal rows or ''^'' for headers.
  
-^Intestazione   Intestazione                      Intestazione         +  Heading      Heading       Heading          
-Riga 1 Col 1    | questa cella è unita verticalmente | Row 1 Col 3        | +  Row 1 Col 1    | Row 1 Col 2     | Row 1 Col 3        | 
-Riga 2 Col 1    | :::                                Row 2 Col 3        +  Row 2 Col 1    | some colspan (note the double pipe) || 
-Riga 3 Col 1    | :::                                | Row 2 Col 3        |+  Row 3 Col 1    | Row 3 Col     | Row 3 Col 3        |
  
-A parte la sintassi di unione quelle celle non devono contenere niente altro.+To connect cells horizontally, just make the next cell completely empty as shown aboveBe sure to have always the same amount of cell separators!
  
-  ^ Intestazione 1 ^ Intestazione 2                     ^ Intestazione 3     ^ +Vertical tableheaders are possible, too.
-  | 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        |+
  
 +|              ^ 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        |
  
-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 destradue spazi destra per allineare a sinistra e almeno due spazi ad entrambi i lati per il testo centrato.+As you can seeit's the cell separator before cell which decides about the formatting:
  
-        Tabella con allineamento         ^^^ +  |              Heading 1            Heading 2          ^ 
-|        destra   centro    |sinistra      +  Heading 3    | Row 1 Col 2          Row 1 Col 3        | 
-|sinistra      |        destra|    centro    | +  ^ Heading 4    no colspan this time |                    
-| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |+  ^ Heading 5    Row 2 Col 2          Row 2 Col 3        |
  
-Ecco come appare nel sorgente:+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:
  
-  ^         Tabella con allineamento         ^^^ +  ^           Table with alignment           ^^^ 
-  |        destra|    centro    |sinistra      +  |         right|    center    |left          
-  |sinistra             destra|    centro    |+  |left                  right|    center    |
   | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |   | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
  
-Notal'allineamento verticale non è supportato. +NoteVertical alignment is not supported.
-===== Nessuna formattazione =====+
  
-Se avete bisogno di visualizzare il testo esattamente come è scritto (senza alcuna formattazione), racchiudete l'area sia con il marcatore ''%%<nowiki>%%'' o più semplicementecon i segni di doppia percentuale ''<nowiki>%%</nowiki>''.+===== 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 che contiene indirizzi come questo http://www.splitbrain.org **formattazione**, ma niente è fatto con esso.+This is some text which contains addresses like this: http://www.splitbrain.org and **formatting**, but nothing is done with it.
 </nowiki> </nowiki>
-Lo stesso è vero per %%//__questo__ testo// con una faccina ;-)%%.+The same is true for %%//__this__ text// with a smiley ;-)%%.
  
   <nowiki>   <nowiki>
-  Questo è del testo che contiene indirizzi come questo: http://www.splitbrain.org **formattazione**, ma niente è fatto con esso.+  This is some text which contains addresses like this: http://www.splitbrain.org and **formatting**, but nothing is done with it.
   </nowiki>   </nowiki>
-  Lo stesso è vero per %%//__questo__testo// con una faccine ;-)%%. +  The same is true for %%//__this__ text// with a smiley ;-)%%.
-===== Blocchi di codice =====+
  
-È possibile includere blocchi di codice nei documenti sia indentandoli con almeno due spazi (come negli esempi precedenti), sia usando i marcatori ''code'' o ''file''.+===== Code Blocks =====
  
-  Questo testo è intentato con due spazi. +You can include code blocks into your documents by either indenting them by at least two spaces (like used for the previous examples) or by using the tags ''%%<code>%%'' or ''%%<file>%%''.
-  +
  
-<code>Questo è codice preformattato e tutti gli spazi sono preservati: come              <-questo +  This is text is indented by two spaces.
-  </code>+
  
-<file>Questo è praticamente la stessa cosa, ma si potrebbe usare per mostrare che è stato citato un file. +<code
-  </file>+This is preformatted code all spaces are preserved: like              <-this 
 +</code>
  
 +<file>
 +This is pretty much the same, but you could use it to show that you quoted a file.
 +</file>
  
-Questi blocchi sono stati creati da questi sorgenti:+Those blocks were created by this source:
  
-  Questo testo è indentato con due spazi.+    This is text is indented by two spaces.
  
   <code>   <code>
-  Questo è codice preformato ogni spazio è preservatocome              <-questo+  This is preformatted code all spaces are preservedlike              <-this
   </code>   </code>
  
   <file>   <file>
-  Questo è praticamente la stessa cosama si potrebbe usare per mostrare che è stato citato un file.+  This is pretty much the samebut you could use it to show that you quoted a file.
   </file>   </file>
-==== Evidenziazione di sintassi ==== 
  
-[[wiki:DokuWiki]] può sottolineare il codice sorgenteche lo rende più facile da leggereUsa la [[http://qbnz.com/highlighter/|GeSHi]] Generic Syntax Highlighter -- così ogni linguaggio supportato da GeSHi è consentitoLa sintassi è la stessa di quelle dei blocchi di codice o file nella precedente sezionema questa volta il nome del linguaggio usato è inserito all'interno del marcatoreAd esempio ''<nowiki><code java></nowiki>'' ''<nowiki><file java></nowiki>''.+==== Syntax Highlighting ==== 
 + 
 +[[wiki:DokuWiki]] can highlight sourcecodewhich makes it easier to readIt uses the [[http://qbnz.com/highlighter/|GeSHi]] Generic Syntax Highlighter -- so any language supported by GeSHi is supportedThe syntax uses the same code and file blocks described in the previous sectionbut this time the name of the language syntax to be highlighted is included inside the tag, e.g. ''<nowiki><code java></nowiki>'' or ''<nowiki><file java></nowiki>''.
  
 <code java> <code java>
 /** /**
- La classe HelloWorldApp implementa un'applicazione che + The HelloWorldApp class implements an application that 
- mostra semplicemente "Hello World!" come risultato.+ simply displays "Hello World!" to the standard output.
  */  */
 class HelloWorldApp { class HelloWorldApp {
     public static void main(String[] args) {     public static void main(String[] args) {
-        System.out.println("Hello World!"); //Visualizza la stringa.+        System.out.println("Hello World!"); //Display the string.
     }     }
 } }
 </code> </code>
  
-Le seguenti stringhe di linguaggio sono correntemente riconosciuti: //4csabapactionscript-french, actionscript, actionscript3, adaapacheapplescriptasmaspautoconfautohotkeyautoitavisynthawkbashbasic4glbfbibtexblitzbasicbnfboo, c, c_mac, caddclcadlispcfdgcfmchaiscriptcilclojurecmakecobolcppcpp-qtcsharpcsscuesheet, d, dcsdelphidiffdivdosdotecmascripteiffelemailerlangfofortranfreebasicfsharpgambasgenerogenie, gdb, glslgmlgnuplotgroovy, gettext, gwbasichaskellhicesthq9plushtmliconidliniinnointercalio, j, java5javajavascriptjquerykixtartklonecklonecpplatexlisplocobasiclogtalklolcodelotusformulaslotusscriptlscriptlsl2luam68kmagiksfmakemapbasicmatlabmircmodula2modula3, mmix, mpasmmxmlmysqlnewlispnsisoberon2objcocaml-briefocamloobasoracle8, oracle11, oxygeneozpascalpcreperl, perl6, perpfphp-briefphppike, pic16, pixelbenderplsqlpostgresqlpovraypowerbuilderpowershellprogressprologpropertiesprovidexpurebasicpythonq, qbasic, railsrebolregrobotsrpmspecrsplusrubysasscalaschemescilabsdlbasicsmalltalksmartysqlsystemverilogtclteratermtextthinbasictsqltyposcriptuniconvalavbnetvbverilogvhdlvimvisualfoxprovisualprologwhitespacewinbatch, whois, xbasicxmlxorg_confxppz80// +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 c 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 roff rpmspec rsplus ruby rust sas sass scala scheme scilab scl sdlbasic smalltalk smarty spark sparql sql sshconfig 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 wolfram xbasic xml xojo xorg_conf xpp yaml z80 zxbasic// 
-==== Blocchi di codice scaricabili ====+ 
 +There are additional [[doku>syntax_highlighting|advanced options]] available for syntax highlighting, such as highlighting lines or adding line numbers. 
 + 
 +==== Downloadable Code Blocks ====
  
-Quando si usa la sintassi ''%%<code>%%'' ''%%<file>%%'' come soprasi potrebbe volere rendere il codice mostrato disponibile per anche per il prelevamentoSi può fare specificando un nome di file dopo il codice del linguaggio come questo:+When you use the ''%%<code>%%'' or ''%%<file>%%'' syntax as aboveyou might want to make the shown code available for download as wellYou can do this by specifying a file name after language code like this:
  
 <code> <code>
Linea 387: Linea 436:
 </file> </file>
  
-Se non si vuole un file scaricabile senza nessuna evidenziazionespecificate un trattino (''-''come codice del linguaggio: ''%%<code - myfile.foo>%%''. +If you don't want any highlighting but want a downloadable file, specify a dash (''-''as the language code: ''%%<code - myfile.foo>%%''.
-===== Incorporare codice HTML e PHP =====+
  
-Potete incorporare righe di codice HTML o PHP nei vostri documenti usando i marcatori ''%%<html>%%'' o ''%%<php>%%''(Usate i marcatori maiuscoli se è necessario includere gli elementi in blocchi)+===== RSS/ATOM Feed Aggregation ===== 
 +[[DokuWiki]] can integrate data from external XML feedsFor parsing the XML feeds, [[http://simplepie.org/|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:
  
-Esempio HTML:+^ 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. All HTML 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). |
  
-<code> +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.
-<html> +
-Questo è <span style="color:red;font-size:150%;">HTML in riga</span> +
-</html> +
-<HTML> +
-<p style="border:2px dashed red;">E questo è un blocco HTML</p> +
-</HTML> +
-</code>+
  
-<html> +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''.
-Questo è <span style="color:red;font-size:150%;">HTML in riga</span> +
-</html> +
-<HTML> +
-<p style="border:2px dashed red;">E questo è un blocco HTML</p> +
-</HTML>+
  
-Esempio PHP:+**Example:**
  
-<code> +  {{rss>http://slashdot.org/index.rss 5 author date 1h }}
-<?php +
-echo 'Un logo generato da PHP:'; +
-echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />'; +
-echo '(generated inline HTML)'; +
-?> +
-<?php +
-echo '<table class="inline"><tr><td>Lo stesso, ma all'interno di un elemento di livello blocco:</td>'; +
-echo '<td><img src="' $_SERVER['PHP_SELF''?=' . php_logo_guid() . '" alt="PHP Logo !" /></td>'; +
-echo '</tr></table>'; +
-?> +
-</code>+
  
-<?php +{{rss>http://slashdot.org/index.rss 5 author date 1h }}
-echo 'Un logo generato da PHP:'; +
-echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />'; +
-echo '(inline HTML)'; +
-?> +
-<?php +
-echo '<table class="inline"><tr><td>Lo stesso, ma all'interno di un elemento di livello blocco:</td>'; +
-echo '<td><img src="' $_SERVER['PHP_SELF''?=' . php_logo_guid() . '" alt="PHP Logo !" /></td>'; +
-echo '</tr></table>'; +
-?>+
  
-**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 ===== 
-[[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 ^ +===== Control Macros =====
-| 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 [[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 [[DokuWiki]] di ricaricare nuovamente la pagina se è trascorso un tempo superiore //periodo di aggiornamento// dall'ultima volta che la pagina è stata visualizzata.+Some syntax influences how DokuWiki renders page without creating any output it selfThe following control macros are availble:
  
-**Esempio:**+^ 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 |
  
-  {{rss>http://slashdot.org/index.rss 5 author date 1h }}  +===== Syntax Plugins =====
  
-{{rss>http://slashdot.org/index.rss 5 author date 1h }}   +DokuWiki's syntax can be extended by [[doku>plugins|Plugins]]How the installed plugins are used is described on their appropriate description pagesThe following syntax plugins are available in this particular DokuWiki installation:
-===== Macro di Controllo =====+
  
-Alcune sintassi influenzano come DokuWiki restituisce una pagina senza creare risultati a sé. Le seguenti macro di controllo sono disponibili+~~INFO:syntaxplugins~~
  
-^ 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 %%<php>%% 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>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~~ 
  • wiki/syntax.1556632721.txt.gz
  • Ultima modifica: 15/03/2023 08:38
  • (modifica esterna)