Guide@Debianizzati.Org

Aiuto:Sintassi: differenze tra le versioni

Aiuto Discussione

Aiuto:Sintassi (visualizza wikitesto)

Versione delle 16:25, 14 ott 2021

17 502 byte aggiunti ,  14 ott 2021
m
mini-errore in syntaxhighlight table
(+ tabella elenchi)
m (mini-errore in syntaxhighlight table)
 
(44 versioni intermedie di 3 utenti non mostrate)
Riga 1: Riga 1:
{{Stub}}{{Help}}
{{Help}}
== Indice ==
== Indice ==
L'indice per ciascuna pagina viene creato automaticamente se sono presenti almeno tre sezioni. Di default compare in alto a sinistra e prima del testo inserito.<br/>
L'indice per ciascuna pagina viene creato automaticamente se sono presenti almeno quattro sezioni. Di default compare subito prima della prima [[#Dividere in sezioni|sezione]] inserita.<br/>
Per forzare la visualizzazione dell'indice nel caso:
Per forzare la visualizzazione dell'indice nel caso:
# vi siano meno di tre sezioni
# vi siano meno di quattro sezioni
# si voglia farlo comparire in un punto specificato della pagina
# si voglia farlo comparire in un punto specificato della pagina
si può utilizzare la [http://www.mediawiki.org/wiki/Help:Magic_words parola magica] <nowiki>__TOC__</nowiki>
si può utilizzare la parola magica <sup>[[#Documentazione esterna|[1]]]</sup> '''<nowiki>__TOC__</nowiki>'''<br />
 
Se invece si vuole inibire la visualizzazione dell'indice, si può ricorrere alla parola magica '''<nowiki>__NOTOC__</nowiki>'''
 
==Formattazione==
 
===Dividere in sezioni===


È possibile nascondere o mostrare l'indice attraverso i link "mostra" e "nascondi" presenti al suo interno. Questa scelta viene ricordata per gli indici presenti nelle altre pagine visualizzate.
==Dividere in sezioni==
{| class="wikitable"
{| class="wikitable"
! width=15%|Tipo formattazione
! width="15%" |Tipo formattazione
! Descrizione
!Descrizione
! Sintassi
!Sintassi
! width=40%|Risultato
! width="40%" |Risultato
|-
|-
|Titolo 1
|Titolo 1
|Racchiudere tra = <br/>(non utilizzare all'interno delle pagine in quanto è la formattazione del titolo della guida).
|Racchiudere tra = <br />(non utilizzare all'interno delle pagine in quanto è la formattazione del titolo della guida).
|<pre>= Titolo 1 = </pre>
|<pre>= Titolo 1 = </pre>
|
|
Riga 55: Riga 53:
|-
|-
|}
|}
 
Evitare, se possibile, i titoli 4,5,6; al loro posto utilizzare gli [[Aiuto:Sintassi#Elenchi|elenchi]]. Vedere anche le [[Aiuto:Prima_di_iniziare#Convenzioni sullo stile| convenzioni sullo stile]].
===Formattazione testo===
==Formattazione di testo==
 
{| class="wikitable"
{| class="wikitable"
! width=15%|Tipo formattazione
! width="12%" |Tipo di formattazione
! Descrizione
!Descrizione
! Sintassi
!Sintassi
! width=40%|Risultato
! width="30%" |Risultato
|-
|-
|Grassetto
|Grassetto
Riga 80: Riga 77:
|-
|-
|Sottolineato
|Sottolineato
|Racchiudere il testo tra i tag <nowiki><u> </u></nowiki>
|Racchiudere il testo tra i tag '''<nowiki><u> </u></nowiki>'''
|<pre><u>Questo testo è sottolineato</u></pre>
|<pre><u>Questo testo è sottolineato</u></pre>
|<u>Questo testo è sottolineato</u>
|<u>Questo testo è sottolineato</u>
|-
|-
|Barrato
|Barrato
|Racchiudere il testo tra i tag <nowiki><s> </s></nowiki>
|Racchiudere il testo tra i tag '''<nowiki><s> </s></nowiki>'''
|<pre><s>Questo testo è barrato</s></pre>
|<pre><s>Questo testo è barrato</s></pre>
|<s>Questo testo è barrato</s>
|<s>Questo testo è barrato</s>
|-
|-
|Monospace
|Monospace
|Racchiudere il testo tra i tag <nowiki><code> </code></nowiki>
|Racchiudere il testo tra i tag '''<nowiki><code> </code></nowiki>'''
|<pre><code>Questo testo è di tipo monospace</code></pre>
|<pre><code>Questo testo è di tipo monospace</code></pre>
|<code>Questo testo è di tipo monospace</code>
|<code>Questo testo è di tipo monospace</code>
|-
|-
|Apice
|Apice
|Racchiudere il testo tra i tag <nowiki><sup> </sup></nowiki>
|Racchiudere il testo tra i tag '''<nowiki><sup> </sup></nowiki>'''
|<pre>Questo testo ha un <sup>apice</sup></pre>
|<pre>Questo testo ha un <sup>apice</sup></pre>
|Questo testo ha un <sup>apice</sup>
|Questo testo ha un <sup>apice</sup>
|-
|-
|Pedice
|Pedice
|Racchiudere il testo tra i tag <nowiki><sub> </sub></nowiki>
|Racchiudere il testo tra i tag '''<nowiki><sub> </sub></nowiki>'''
|<pre>Questo testo ha un <sub>pedice</sub></pre>
|<pre>Questo testo ha un <sub>pedice</sub></pre>
|Questo testo ha un <sub>pedice</sub>
|Questo testo ha un <sub>pedice</sub>
|-
|-
|}
|}
 
==Gestione paragrafi ==
===Gestione Paragrafi===
===== Interruzione di riga=====
 
Premendo il tasto [Invio] alla fine di una riga, si otterrà l'effetto di andare a capo solo all'interno dell'editor del Wiki mentre le righe non verranno realmente divise al momento del salvataggio.<br />
Per ottenere l'effetto di interrompere la riga senza interrompere il paragrafo, utilizzare il tag '''<nowiki><br/></nowiki>''' (break) alla fine della riga.
{| class="wikitable"
{| class="wikitable"
! width=10%|Tipo formattazione
!Esempio
! Descrizione
!Risultato
! Sintassi
! width=40%|Risultato
|-
|-
| rowspan="2" | Interruzione di riga
|rowspan="2" |Premendo il tasto [Invio] alla fine di una riga, si otterrà l'effetto di andare a capo solo all'interno dell'editor del Wiki mentre le righe non verranno realmente divise al momento del salvataggio.<br/>
Per ottenere l'effetto di interrompere la riga senza interrompere il paragrafo, utilizzare il tag '''<nowiki><br/></nowiki>''' alla fine della riga.
|<pre>Queste due righe.
|<pre>Queste due righe.
Non saranno separate</pre>
Non saranno separate</pre>
Riga 123: Riga 116:
|<pre>Questo due righe.<br/>
|<pre>Questo due righe.<br/>
Saranno separate.</pre>
Saranno separate.</pre>
Oppure (necessario all'interno di elenchi):<br/>
Oppure (necessario all'interno di [[#Elenchi|elenchi]], [[#Indentazione|blocchi indentati]] o<br />parametri di [[Aiuto:I template|template]]):<br />
<pre>Questo due righe.<br/>Saranno separate.</pre>
<pre>Questo due righe.<br/>Saranno separate.</pre>
|Queste due righe.<br/>Saranno separate.
|Queste due righe.<br />Saranno separate.
|-
|}
=====Interruzione di paragrafo=====
Un paragrafo viene interrotto con l'inserimento di una riga vuota. Se possibile, non separare i paragrafi con più righe vuote.
{| class="wikitable"
!Esempio
!Risultato
|-
|-
| Interruzione di paragrafo
| Un paragrafo viene interrotto con l'inserimento di una riga vuota. Se possibile, non separare i paragrafi con più righe vuote.
|<pre>Questo paragrafo sta per essere interrotto dal paragrafo successivo.<br/>
|<pre>Questo paragrafo sta per essere interrotto dal paragrafo successivo.<br/>
L'interruzione avverrà con l'inserimento di una riga vuota.
L'interruzione avverrà con l'inserimento di una riga vuota.


Da qui inizia il secondo paragrafo.</pre>
Da qui inizia il secondo paragrafo.</pre>
|Questo paragrafo sta per essere interrotto dal paragrafo successivo.<br/>
|Questo paragrafo sta per essere interrotto dal paragrafo successivo.<br />
L'interruzione avverrà con l'inserimento di una riga vuota.<br/><br/>Da qui inizia il secondo paragrafo.
L'interruzione avverrà con l'inserimento di una riga vuota.<br /><br />Da qui inizia il secondo paragrafo.
|}
=====Indentazione =====
Per indentare un paragrafo, farlo precedere da uno o più caratteri di due punti "''':'''"
{| class="wikitable"
!Esempio
!Risultato
|-
|-
|Indentazione
|Per indentare un paragrafo, farlo precedere da uno o più caratteri di due punti ":"
|<pre>:questo paragrafo è rientrato
|<pre>:questo paragrafo è rientrato
::questo paragrafo è rientrato (2)
::questo paragrafo è rientrato (2)<br/>Seconda riga
:::questo paragrafo è rientrato (3)</pre>
:::questo paragrafo è rientrato (3)</pre>
|
|
:questo paragrafo è rientrato
:questo paragrafo è rientrato
::questo paragrafo è rientrato (2)
::questo paragrafo è rientrato (2)<br />Seconda riga
:::questo paragrafo è rientrato (3)
:::questo paragrafo è rientrato (3)
|}
===== Blockquote=====
Altro modo per indentare un paragrafo è includerlo all'interno dei tag '''<nowiki><blockquote></nowiki> <nowiki></blockquote></nowiki>'''
{| class="wikitable"
!Esempio
!Risultato
|-
|-
|Blockquote
|Altro modo per indentare un paragrafo è includerlo all'interno dei tag <nowiki><blockquote></nowiki> <nowiki></blockquote></nowiki>
|<pre><blockquote>
|<pre><blockquote>
Questo è un esempio<br/>
Questo è un esempio<br/>
Riga 154: Riga 160:
con il tag "blockquote"
con il tag "blockquote"
</blockquote></pre>
</blockquote></pre>
|<blockquote> Questo è un esempio<br/>che mostra in che modo<br/>indentare il testo<br/>con il tag "blockquote"
|<blockquote> Questo è un esempio<br />che mostra in che modo<br />indentare il testo<br />con il tag "blockquote"
|}
== Formattazione di codice==
Particolarmente utile per mettere in evidenza linee di codice, contenuto di file, comandi e il loro output.<br />
Per crearlo è possibile ricorrere a due metodi:
* racchiudere il testo tra i tag '''<nowiki><pre> </pre></nowiki>'''
* fare in modo che la riga inizi con uno spazio
Questi due metodi producono lo stesso risultato (si noti lo spazio iniziale nel secondo esempio):
{| class="wikitable"
!Esempio
!Risultato
|-
|-
|<pre><nowiki><pre></nowiki>prova di testo&lt;/pre></pre>|| rowspan="2" |<pre>prova di testo</pre>
|-
|<pre> prova di testo</pre>
|}
|}
 
Il primo metodo, ossia l'utilizzo dei tag '''<nowiki><pre> </pre></nowiki>''', è preferibile in quanto consente una sua facile individuazione all'interno del codice della pagina. Lo svantaggio è quello di non permettere formattazioni del testo contenuto al loro interno.<br />
 
Quindi, nel caso in cui si debba utilizzare testo con una particolare formattazione (corsivo, grassetto, testo colorato), è necessario far ricorso al secondo metodo.<br />
{{Box|Note|
Questi esempi chiariscono meglio i due metodi (notare ancora lo spazio iniziale nel secondo e terzo esempio):
* usare il tag <nowiki><nowiki></nowiki></nowiki> per inibire l'interpretazione dei precedenti caratteri e visualizzarli come testo puro.
* con <nowiki><!-- Questo è un commento --></nowiki> è possibile inserire un commento che verrà visualizzato solo nella finestra di editing della pagina.}}
 
===Formattazione di codice===
{| class="wikitable"
{| class="wikitable"
! width=10%|Tipo formattazione
!Esempio
! Descrizione
!Risultato
! Sintassi
! width=40%|Risultato
|-
|-
|rowspan="3"| Codice
|<pre><nowiki><pre></nowiki>'''nonostante il triplo apice, il testo non sarà visualizzato in grassetto'''&lt;/pre></pre>
|rowspan="3"| Particolarmente utile per mettere in evidenza linee di codice, contenuto di file, comandi e il loro output.<br/>
|<pre>'''nonostante il triplo apice, il testo non sarà visualizzato in grassetto'''</pre>
Per crearlo è sufficiente racchiudere il testo tra i tag <nowiki><pre> </pre></nowiki><br/><br/>L'uso di questo tag è raccomandato rispetto all'uso del testo rientrato che, pur producendo lo stesso effetto, è di difficile individuazione durante la lettura del codice di pagina.<br/>
Il testo rientrato per formattare linee di codice può rivelarsi utile nel caso si voglia avere un riquadro con all'interno stili di formattazione diversi; questo non è possibile con i normali tag <nowiki><pre> </pre></nowiki>.<br/>
Notare lo spazio iniziale nel secondo e terzo esempio.
|<pre><nowiki><pre></nowiki>prova di testo&lt;/pre></pre>
|<pre>prova di testo</pre>
|-
|-
|<pre> Riquadro con testo colorato in <span style="color:red">rosso</span></pre>
|<pre> Con lo spazio iniziale, il triplo apice consente un testo in '''grassetto'''</pre>
|
|
Riquadro con testo colorato in <span style="color:red">rosso</span>
Con lo spazio iniziale, il triplo apice consente un testo in '''grassetto'''
|-
|-
| <pre> Questo è un riquadro che contiene testo in '''grassetto'''</pre>
|<pre> ... oppure un testo colorato in <span style="color:red">rosso</span></pre>
|
|
Questo è un riquadro che contiene testo in '''grassetto'''
... oppure un testo colorato in <span style="color:red">rosso</span>
|-
|-
|}
Nel caso si vogliano inserire diverse linee di codice con il tag 'pre' in un [[#Elenchi|elenco]], si deve utilizzare necessariamente un carattere di interruzione di linea (line feed) scrivendo come sempre ogni singolo elemento su un'unica riga:
{| class="wikitable"
!Esempio
!Risultato
|-
|
<pre>
* Primo elemento della lista
* Secondo elemento della lista con tag 'pre'<nowiki><pre></nowiki>Linea di codice&lt;/pre>
* Terzo elemento della lista con tag 'pre' e codice multiriga<nowiki><pre></nowiki>prima linea di codice&amp;#10;seconda linea di codice&lt;/pre>
</pre>
|
*Primo elemento della lista
*Secondo elemento della lista con tag 'pre'<pre>Linea di codice</pre>
*Terzo elemento della lista con tag 'pre' e codice multiriga<pre>prima linea di codice&#10;seconda linea di codice</pre>
|-
|}
A tal proposito, leggere anche il [[#Caratteri speciali HTML|paragrafo relativo ai codici HTML]].
==Evidenziazione della sintassi con GeSHi==
Particolarmente utile per evidenziare la sintassi di codice dei linguaggi di programmazione.
Per utilizzarlo è sufficiente racchiudere il codice da evidenziare all'interno di
<pre><syntaxhighlight lang="codelang" line='line'></syntaxhighlight></pre> dove al posto di codelang è stato inserito il nome del linguaggio di programmazione.
===Attributi===
Il comando mette a disposizione differenti attributi
{| class="wikitable"
|+
!Attributo
!Funzione
!Esempio
!Risultato
|-
|<code>lang="<var>name</var>"</code>
|Questo attributo definisce quale analizzatore lessicale deve essere utilizzato. Questo attributo cambia come l'estensione evidenzierà il codice sorgente.
Per un elenco completo dei linguaggi supportati vedere [https://pygments.org/languages/ la pagina ufficiale] di pygments.
|<pre><syntaxhighlight lang="python">
def quick_sort(arr):
   less = []
   pivot_list = []
   more = []
   if len(arr) <= 1:
       return arr
</syntaxhighlight></pre>
|<syntaxhighlight lang="python">
def quick_sort(arr):
    less = []
    pivot_list = []
    more = []
    if len(arr) <= 1:
        return arr
</syntaxhighlight>
|-
|<code>line</code>
|Questo attributo attiva la numerazione di linea.
|<pre><syntaxhighlight lang="python" line>
def quick_sort(arr):
   less = []
   pivot_list = []
   more = []
   if len(arr) <= 1:
       return arr
</syntaxhighlight></pre>
|<syntaxhighlight lang="python" line="1">
def quick_sort(arr):
    less = []
    pivot_list = []
    more = []
    if len(arr) <= 1:
        return arr
</syntaxhighlight>
|-
|<code>inline</code>
|Questo attributo indica che il codice sorgente deve essere inserito in linea con il paragrafo (e non in un blocco a parte).
|<pre><syntaxhighlight lang="python" inline>
lambda x: x * 2
</syntaxhighlight></pre>
|<syntaxhighlight lang="python" inline="">
lambda x: x * 2
</syntaxhighlight>
|-
|<code>start</code>
|Questo attributo, da utilizzare in combinazione con l'attributo <code>line</code>, definisce quale deve essere il primo numero dal quale contare le linee di codice, per esempio <code>line start="55"</code> farà sì che le linee inizino a contare dalla riga 55.
|<pre><syntaxhighlight lang="python" line start="55">
def quick_sort(arr):
   less = []
   pivot_list = []
   more = []
   if len(arr) <= 1:
       return arr
</syntaxhighlight></pre>
|<syntaxhighlight lang="python" line="1" start="55">
def quick_sort(arr):
    less = []
    pivot_list = []
    more = []
    if len(arr) <= 1:
        return arr
</syntaxhighlight>
|-
|<code>highlight</code>
|Questo attributo specifica una o più linee che devono essere marcate, evidenziandole con un differente colo di sfondo. Si possono anche specificare più linee separate da virgole (se linee separate) <code>highlight="1,4,8"</code> o da un trattino <code>highlight="5-7"</code> se è necessario evidenziare un certo range di linee.
|<pre><syntaxhighlight lang="python" line start=3 highlight="1,5-7">
def quick_sort(arr):
   less = []
   pivot_list = []
   more = []
   if len(arr) <= 1:
       return arr
</syntaxhighlight></pre>
|<syntaxhighlight lang="python" line="1" start="3" highlight="1,5-7">
def quick_sort(arr):
    less = []
    pivot_list = []
    more = []
    if len(arr) <= 1:
        return arr
</syntaxhighlight>
|-
|<code>style</code>
|Questo attributo permette di specificare un particolare stile al blocco, per esempio <code>style="border:3px dashed blue"</code> per avere il blocco riquadrato da un bordo distante 3 pixel tratteggiato di blu.
|<pre><syntaxhighlight lang="python" style="border:3px dashed blue">
def quick_sort(arr):
   less = []
   pivot_list = []
   more = []
   if len(arr) <= 1:
       return arr
</syntaxhighlight></pre>
|<syntaxhighlight lang="python" line="1" style="border:3px dashed blue">
def quick_sort(arr):
    less = []
    pivot_list = []
    more = []
    if len(arr) <= 1:
        return arr
</syntaxhighlight>
|}
|}


==Elenchi==
==Elenchi==
===Elenco puntato===
Permette di ottenere elenchi o sotto-elenchi di voci.<br />Ciascuna voce è preceduta da uno o più "*"
{| class="wikitable"
{| class="wikitable"
! width=10%|Tipo di elenco
!Esempio
! Descrizione
!Risultato
! Sintassi
! width=40%|Risultato
|-
|-
|Puntato
|Permette di ottenere elenchi o sotto-elenchi di voci.<br/>Ciascuna voce è preceduta da uno o più &bull;
|<pre>*uno
|<pre>*uno
*due
*due
Riga 205: Riga 348:
|
|
*uno
*uno
*due
* due
**tre
**tre
*quattro<br/>cinque
*quattro<br />cinque
**sei
**sei
***sette
***sette
|}
===Elenco numerato===
Permette di ottenere elenchi o sotto-elenchi di voci.<br />Ciascuna voce è preceduta da uno o più "#"
{| class="wikitable"
!Esempio
!Risultato
|-
|-
|Numerato
|Permette di ottenere elenchi o sotto-elenchi di voci.<br/>Ciascuna voce è preceduta da numeri.
|<pre>#uno
|<pre>#uno
#due
#due
Riga 219: Riga 366:
##sei
##sei
###sette</pre>
###sette</pre>
|
|  
#uno
#uno
#due
#due
##tre
##tre
#quattro<br/>cinque
#quattro<br />cinque
##sei
##sei
###sette
###sette
|}
===Descrizione===
Permette l'inserimento di una descrizione per una determinata voce.
{| class="wikitable"
!Esempio
!Risultato
|-
|-
|Descrizione
|<pre>;Titolo: Qui può essere inserita una descrizione.<br/>Seconda riga.</pre>
|Permette l'inserimento di una descrizione per una determinata voce.
|<pre>;Titolo: Qui può essere inserita una descrizione.<br/>Seconda riga della descrizione.</pre>
|
|
;Titolo: Qui può essere inserita una descrizione.<br/>Seconda riga della descrizione.
;Titolo:Qui può essere inserita una descrizione.<br />Seconda riga.
|}
===Elenco annidato===
È possibile annidare elenchi puntati e numerati combinando le diverse sintassi.
{| class="wikitable"
!Esempio
!Risultato
|-
|-
|Annidato
|È possibile annidare elenchi puntati e numerati combinando le diverse sintassi.
|<pre>
|<pre>
# Elenco numerato
# Elenco numerato
Riga 240: Riga 395:
#*# Sotto-sotto-elenco numerato</pre>
#*# Sotto-sotto-elenco numerato</pre>
|
|
# Elenco numerato
#Elenco numerato
#* Sotto-elenco puntato
#*Sotto-elenco puntato
#*# Sotto-sotto-elenco numerato
#*#Sotto-sotto-elenco numerato
|-
|-
|}
|}
==Link==
===Link interno al Wiki===
Per inserire un link ad una pagina interna al Wiki, basta inserirne il nome esatto (attenzione alle maiuscole/minuscole) all'interno delle doppie parentesi quadre '''<nowiki>[[ ]]</nowiki>''' . I link verso pagine non esistenti saranno colorati di rosso e saranno tutti visibili nelle [[Speciale:PagineRichieste|guide richieste]] per permettere anche ad altri la loro ricerca e creazione.<br />
È possibile anche avere un link visualizzato con un titolo generico (non URL).


== Link ==
''Non inserite i link interni con la sintassi riservata ai link esterni al Wiki, altrimenti, nel caso di pagina spostata o cancellata, si verrebbe a creare un link rotto di cui è difficile accorgersi.''
I link si differenziano in link interni al wiki e link esterni.  
{| class="wikitable"
!Esempio
!Risultato
|-
| colspan="2" |<span style="color:green">''Sintassi corretta''</span>
|-
|<pre>[[Pagina principale]]</pre>||[[Pagina principale]]
|-
|<pre>[[Pagina principale | Mainpage del Wiki]]</pre>||[[Pagina principale | Mainpage del Wiki]]
|-
|<pre>[[Pagina non esistente]]</pre>||[[Pagina non esistente]]
|-
| colspan="2" |<span style="color:red">''Sintassi errata''</span>
|-
|<pre>http://guide.debianizzati.org/index.php/Pagina_principale</pre>||http://guide.debianizzati.org/Pagina_principale
|-
|<pre>[http://guide.debianizzati.org/index.php/Pagina_principale Pagina principale]</pre>|| |[http://guide.debianizzati.org/index.php/Pagina_principale Pagina principale]
|-
|<pre>[http://guide.debianizzati.org/index.php/Pagina_principale Mainpage del Wiki]</pre>|| |[http://guide.debianizzati.org/index.php/Pagina_principale Mainpage del Wiki]
|}
===Link esterno al Wiki===
Per i link esterni basta scrivere l'URL completo di protocollo. Sono considerati URL validi quelli che utilizzano uno dei seguenti protocolli: <nowiki>http://, https://, ftp://, irc://, gopher://, telnet://, nntp://, worldwind://, mailto:, news:, svn://</nowiki><br />
L'URL può essere racchiuso tra parentesi quadre nel caso si voglia un titolo generico.
{| class="wikitable"
!Esempio
!Risultato
|-
|<pre>http://meta.wikimedia.org/wiki/Help:Link</pre>
|http://meta.wikimedia.org/wiki/Help:Link<br />
|-
|<pre>[http://meta.wikimedia.org/wiki/Help:Link WikiMedia Links]</pre>
|[http://meta.wikimedia.org/wiki/Help:Link WikiMedia Links]
|}
I link esterni, sebbene non esplicitamente sconsigliati, sono uno strumento da utilizzare con cautela e attenzione poiché le pagine a cui si riferiscono non sono modificabili.<br />
Valutate attentamente che il link sia solo una fonte informativa supplementare per la pagina che si sta scrivendo e, soprattutto, non inserite link che puntino a parti essenziali per la comprensione della guida stessa. Questo consentirà in futuro sia di aggiornare più agevolmente la pagina sia di fornire all'utente una lettura logicamente completa e sequenziale.


=== Link Esterni ===
Se si ha la necessità di inserire un link, considerare l'eventualità di far ricorso, se possibile, ai link permanenti (permalink) e di inserire in fondo alla guida una sezione apposita (chiamata "Link esterni", "Collegamenti esterni" o con il nome che più vi piace) che contenga i link esterni. Questo permetterà una loro più facile manutenzione soprattutto se la pagina linkata dovesse diventare irraggiungibile (broken link).
Per i link esterni basta scrivere l'URL compreso <nowiki>http://</nowiki>.
===Link a sezioni delle guide===
Scrivendo:
È possibile inserire un link ad una specifica [[#Dividere in sezioni|sezione]] di una pagina anteponendo al suo titolo un carattere "'''#'''".<br />
<pre>
Se il nome della guida non viene specificato, il link sarà riferito ad una sezione della pagina corrente.
http://meta.wikimedia.org/wiki/Help:Link
{| class="wikitable"
</pre>
!Esempio
 
!Risultato
si ottiene:
|-
 
|<pre>[[#Formattazione di codice|Formattazione di codice]]</pre>
http://meta.wikimedia.org/wiki/Help:Link
|[[#Formattazione di codice|Formattazione di codice]]<br />
 
|-
oppure per avere un link visualizzato con un titolo generico (non URL):
|<pre>[[Installare Debian#Metodi di installazione|Metodi di installazione di Debian]]</pre>
|[[Installare Debian#Metodi di installazione|Metodi di installazione di Debian]]
|}
Prestare particolare attenzione a inserire link che puntano a sezioni di altre pagine; se queste sezioni vengono cancellate o rinominate, il link aprirà non più la sezione ma l'intera pagina.<br />
===Link a email===
Permettono di inserire link a indirizzi email.<br />La sintassi è simile a quella dei link esterni, tranne per il fatto che viene utilizzata la parola "'''mailto:'''" seguita dall'indirizzo email.
{| class="wikitable"
!Esempio
!Risultato
|-
|<pre>[mailto:esempio@esempio.org]</pre>
|[mailto:esempio@esempio.org]
|-
|<pre>[mailto:esempio@esempio.org Nome del Contatto]</pre>
|[mailto:esempio@esempio.org Nome del Contatto]
|}
===Link a categorie===
È possibile inserire un link ad una [[Aiuto:Categorie|categoria]] presente sul Wiki in un modo molto simile a quello utilizzato per i link interni. L'unica differenza è che, al posto del nome della guida, va inserito "''':Categoria:'''" seguito dal nome della categoria che si vuol linkare.
{| class="wikitable"
!Esempio
!Risultato
|-
|<pre>[[:Categoria:Internet]]</pre>
|[[:Categoria:Internet]]<br />
|-
|<pre>[[:Categoria:Internet | Lista delle guide contenute nella categoria "Internet"]]</pre>
|[[:Categoria:Internet | Lista delle guide contenute nella categoria "Internet"]]
|}
==Riferimenti==
Il tag <code> <nowiki><ref></ref></nowiki> </code> permette di inserire riferimenti come note a piè di pagina ed è molto utile per inserire le fonti.


L'altro tag molto importante è <code> <nowiki><references /></nowiki> </code> per inserire le citazioni in un punto specifico della pagina e non alla fine.
==Altri tag==
===Nowiki===
Racchiudere tra i tag '''<nowiki>&lt;nowiki&gt;</nowiki>''' e '''<nowiki/>&lt;/nowiki&gt;''' per inibire l'interpretazione del testo da parte del motore del Wiki e visualizzarli come testo puro.
{| class="wikitable"
!Esempio
!Risultato
|-
|<pre>I tag &lt;nowiki><code></nowiki> &lt;nowiki></code></nowiki> non verranno interpretati.</pre>
|I tag <nowiki><code></nowiki> <nowiki></code></nowiki> non verranno interpretati.
|-
||<pre>'''&lt;nowiki>http://127.0.0.1</nowiki>'''</pre>
|'''<nowiki>http://127.0.0.1</nowiki>'''
|}
===Commenti ===
È possibile inserire un commento che verrà visualizzato solo nella finestra di editing della pagina.
{| class="wikitable"
!Esempio
!Risultato
|-
|<pre><!-- Questo è un commento --></pre>
|(Il testo sarà visibile solo all'interno della pagina di editing.)
|}
===Linea===
L'inserimento di una linea, uguale a quella sottesa al nome delle [[#Dividere in sezioni|sezioni]], si ottiene attraverso quattro trattini "'''<nowiki>----</nowiki>'''"
{| class="wikitable"
! width="30%" |Esempio
!Risultato
|-
|<pre>Sta per essere inserite una riga
----</pre>
|Sta per essere inserite una riga
----
|}
==Tabelle==
Le tabelle sono un elemento di formattazione molto potente e flessibile con cui è possibile sia accorpare i contenuti in elenchi graficamente coerenti, sia riunificare elementi diversi in un'unica struttura facilmente manipolabile.<br />
Questo Wiki fa ampio ricorso alle tabelle all'interno delle pagine e dei [[Aiuto:I template|template]].
; Inserimento:l'inserimento di una tabella avviene con l'utilizzo del tag "'''<nowiki>{|</nowiki>'''" per marcare l'inzio della tabella e del tag "'''<nowiki>|}</nowiki>'''" per la sua fine
;Titoli:i titoli per ciascuna colonna possono essere inserti facendoli precedere da "'''!'''" . Il testo del titolo sarà visualizzato in grassetto.
;Celle:le celle della tabella sono separate da "'''||'''". In caso di formattazione specifica solo per la cella, questa va separata dal contenuto attraverso un '''|'''
;Righe:ciascuna riga inizia con '''|''' ed è separata dall'altra attraverso "'''|-'''"
Qui di seguito vi è un semplice esempio con cui viene creata una tabella con tre titoli, due righe e sei celle; due celle hanno una formattazione separata:
<pre>
<pre>
[http://meta.wikimedia.org/wiki/Help:Link WikiMedia Links]
{| class="wikitable"
!Colonna 1
!Colonna 2
!Colonna 3
|-
|cella 1 || cella 2 || style="background:lightblue" | cella 3
|-
|cella 4 || style="color:red" | cella 5 || cella 6
|}
</pre>
</pre>
il cui risultato sarà:
{| class="wikitable"
!Colonna 1
!Colonna 2
!Colonna 3
|-
|cella 1||cella 2|| style="background:lightblue" |cella 3
|-
|cella 4|| style="color:red" |cella 5||cella 6
|}
L'inserimento di tabelle è specificato meglio e con dovizia di particolari nelle pagine apposite di MediaWiki<sup>[[#Documentazione esterna|[4]]]</sup> e Wikimedia<sup>[[#Documentazione esterna|[5]]]</sup>.
==Immagini ==
Questo Wiki consente di inserire delle immagini in modo che possano diventare il giusto complemento a quanto esposto all'interno di una guida; il loro caricamento è permesso solo agli utenti registrati.<br />
Per visualizzare un'immagine all'interno di una pagina sono necessari due passi.
===Caricamento===
Prima di poter inserire un'immagine all'interno di una pagina sarà necessario caricarla sul Wiki. Questo può essere fatto dalla [[Speciale:Upload | pagina apposita]] raggiungibile dal link "'''Carica un file'''"" nel menù "Strumenti"; in questa pagina saranno visibili alcune voci:
;Nome del file di origine:qui è possibile scegliere il file che conterrà l'immagine da caricare. È specificato anche quale estensione è permessa per le immagini: questo Wiki accetta immagini nel formato ''png, gif, jpg'' e ''jpeg'' .
;Nome del file di destinazione:è il nome dell'immagine sul Wiki e non necessariamente deve coincidere con il nome del file caricato.
;Dettagli del file:scrivere qui tutte le informazioni che si ritengono utili per l'immagine che si sta caricando. In questo box è necessario inserire anche le eventuali informazioni sulla [[Aiuto:Licenze|licenza]] che accompagna l'immagine (se non presente nella voce successiva) e il link alla pagina da cui si è presa l'immagine e/o nome dell'autore originale se differente dall'utente che carica l'immagine.
;Licenza:scegliere il tipo di [[Aiuto:Licenze|licenza]] con cui è stata rilasciata l'immagine. Di default la scelta sarà "CC-BY-NC-SA 2.0"; nel caso la licenza non sia disponibile tra quelle selezionabili, specificarla nel box "Dettagli del file".
===Inserimento===
Dopo che l'immagine è stata caricata sul Wiki, sarà possibile inserirla all'interno delle pagine.<br />
Cliccando sull'immagine, di default, si accederà alla pagina relativa nel [[Aiuto:Varie#I namespace|namespace]] "File". Ovviamente il [[#Link|link]] può essere sia inibito che cambiato in modo che il click sull'immagine porti a qualunque pagina interna o esterna al Wiki.


viene visualizzato così:
Nei successivi esempi verrà utilizzata la ben conosciuta [[Debian Swirl|Swirl]]. L'immagine è già caricata sul Wiki.
 
{| class="wikitable"
[http://meta.wikimedia.org/wiki/Help:Link WikiMedia Links]
!Azione
 
!Esempio
{{Warningbox|Non utilizzare questa sintassi per i [[Aiuto:Editing#link interni al Wiki | link interni al Wiki]]. Se una pagina viene spostata o cancellata, si crea un broken link di cui è difficile accorgersi.}}
! width="100px" |Risultato
 
|-
=== Link Interni al Wiki ===
|Inserimento con dimensioni originali||<pre>[[Image:Swirl-50.png]]</pre>oppure:<pre>[[File:Swirl-50.png]]</pre>||[[File:Swirl-50.png]]
 
|-
Scrivendo:
|Cambiare le dimensioni specificando i pixel||<pre>[[Image:Swirl-50.png|30px]]</pre>||[[File:Swirl-50.png|30px]]
<pre>
|-
[[Usare Fotocamere Digitali]]
|Centrare l'immagine||<pre>[[Image:Swirl-50.png|center]]</pre>||[[File:Swirl-50.png|center]]
 
|-
[[Usare Fotocamere Digitali | Altro titolo, stesso link]]
|Inibire il link alla pagina dell'immagine||<pre>[[Image:Swirl-50.png|link=]]</pre>||[[Image:Swirl-50.png|link=]]
</pre>
|-
 
|Link ad una pagina interna al Wiki||<pre>[[Image:Swirl-50.png|link=Pagina principale]]</pre>||[[Image:Swirl-50.png|link=Pagina principale]]
si ottiene:
|-
 
|Link ad una pagina esterna al Wiki||<pre>[[Image:Swirl-50.png|link=http://forum.debianizzati.org]]</pre>||[[Image:Swirl-50.png|link=http://forum.debianizzati.org]]
[[Usare Fotocamere Digitali]]
|-
 
|Immagine scalata, centrata e con link a pagina interna||<pre>[[Image:Swirl-50.png|link=Pagina principale|30px|center]]</pre>||[[Image:Swirl-50.png|link=Pagina principale|30px|center]]
[[Usare Fotocamere Digitali | Altro titolo, stesso link]]
|-
 
|Thumbnail||<pre>[[Image:Swirl-50.png|thumb]]</pre>||[[Image:Swirl-50.png|thumb]]
'''Nota''': Per creare una nuova pagina basta fare un link con un nuovo titolo, poi cliccando sul link è possibile editare la nuova pagina.
|-
 
|Thumbnail centrato||<pre>[[Image:Swirl-50.png|thumb|center]]</pre>||[[Image:Swirl-50.png|thumb|center]]
Se vogliamo linkare un punto specifico della stessa pagina a cui stiamo lavorando, ad esempio per saltare da un capitolo o un paragrafo all'altro, possiamo scrivere:
|-
<pre>[[#Formattazione]]
|Thumbnail con didascalia||<pre>[[Image:Swirl-50.png|thumb|Swirl di Debian]]</pre>||[[Image:Swirl-50.png|thumb|Swirl di Debian]]
 
|-
[[#Formattazione|Passa a Formattazione]]
|Thumbnail ridimensionato e con didascalia||<pre>[[Image:Swirl-50.png|40px|thumb|Swirl di Debian]]</pre>||[[Image:Swirl-50.png|40px|thumb|Swirl di Debian]]
</pre>
|-
 
|Frame||<pre>[[Image:Swirl-50.png|frame]]</pre>||[[Image:Swirl-50.png|frame]]
e otterremo:
|-
 
|Frame con didascalia||<pre>[[Image:Swirl-50.png|frame|Swirl di Debian]]</pre>||[[Image:Swirl-50.png|frame|Swirl di Debian]]
[[#Formattazione]]
|-
 
|Frame centrato e con didascalia||<pre>[[Image:Swirl-50.png|frame|center|Swirl di Debian]]</pre>||[[Image:Swirl-50.png|frame|center|Swirl di Debian]]
[[#Formattazione|Passa a Formattazione]]
|-
 
|}
=== Link a indirizzi email ===
Per ulteriori (e più complete) informazioni, è consigliabile la lettura della guida ufficiale di Wikipedia<sup>[[#Documentazione esterna|[2]]]</sup> che spiega minuziosamente come gestire le immagini in una pagina del Wiki.
 
{{Warningbox|Per evitare problemi di errato indirizzamento, il carattere "{{=}}" (uguale) all'interno degli URL va sostituito con la corrispondente codifica "'''%3D'''"}}
Per inserire il link ad un indirizzo email è sufficiente utilizzare la sintassi:
==Caratteri speciali HTML==
<pre>[mailto:esempio@esempio.org]
A causa dell'interpretazione da parte del Wiki, ci si potrebbe trovare nell'impossibilità di inserire un determinato carattere.<br />
 
In questo caso si può far ricorso, come nell'HTML, all'inserimento di un codice del tipo '''<code>&''codice'';</code>''' nel testo. Dove ''codice'' è una parola o un numero che rappresenta il particolare simbolo da inserire.
[mailto:esempio@esempio.org Nome del Contatto]</pre>
{|
 
|
che visualizzerà:
{| class="wikitable"
 
!Carattere
[mailto:esempio@esempio.org]
!Codice
 
|-
[mailto:esempio@esempio.org Nome del Contatto]
|'''&'''||<span style="color:red">&amp;amp;<span>
 
|-
=== Link a categorie ===
|'''(spazio)'''||<span style="color:red">&amp;nbsp;<span>
È possibile inserire un link ad una categoria presente sul Wiki in maniera molto semplice. Se, ad esempio, si vuol creare un link che punti alla categoria "Internet":
|-
<pre>[[:Categoria:Internet]]
|'''<'''||<span style="color:red">&amp;lt;<span>
[[:Categoria:Internet | Lista delle guide contenute nella categoria "Internet"]]</pre>
|}
che avrà come effetto:<br/>
||
[[:Categoria:Internet]]<br/>
{| class="wikitable"
[[:Categoria:Internet | Lista delle guide contenute nella categoria "Internet"]]
!Carattere
 
!Codice
==Immagini==
|-
È possibile effettuare l'upload di immagini tramite la pagina [[Speciale:Upload | apposita ]] raggiungibile anche tramite il link presente nella toolbox a sinistra.
|'''>'''||<span style="color:red">&amp;gt;<span>
Per sapere come inserire una immagine nel testo, è consigliabile la lettura della [http://it.wikipedia.org/wiki/Aiuto:Markup_immagini Guida ufficiale di Wikipedia] che spiega minuziosamente come gestire le immagini in una pagina del wiki.
|-
 
|'''='''||<span style="color:red">&amp;#61;<span>
== Caratteri speciali HTML ==
|-
 
|'''['''||<span style="color:red">&amp;#91;<span>
È possibile inserire nel wiki qualsiasi carattere speciale HTML come ad esempio il punto della moltiplicazione (es. 2 &middot; 3). Questi simboli si ottengono, come nell'HTML, inserendo un codice del tipo <code>&''codice'';</code> nel testo. Dove ''codice'' è una parola che rappresenta il particolare simbolo da inserire.
|}
 
||
Per una lista completa dei simboli e dei rispettivi codici vedere:
{| class="wikitable"
 
!Carattere
*  [http://en.wikipedia.org/wiki/List_of_XML_and_HTML_character_entity_references List of XML and HTML character entity references]
!Codice
 
|-
==Documentazione Esterna==
|''']'''||<span style="color:red">&amp;#93;<span>
* [http://meta.wikimedia.org/wiki/Help:Editing WikiMedia Help on Editing]
|-
* [http://meta.wikimedia.org/wiki/Help:Help WikiMedia Documentazione]
|'''&#124;'''||<span style="color:red">&amp;#124;<span>
* [http://meta.wikimedia.org/wiki/Help:Table WikiMedia Tabelle]
|-
|'''{'''||<span style="color:red">&amp;#123;<span>
|}
||
{| class="wikitable"
!Carattere
!Codice
|-
|'''}'''||<span style="color:red">&amp;#125;<span>
|-
|'''(line feed)'''||<span style="color:red">&amp;#10;<span>
|-
|'''*'''||<span style="color:red">&amp;#42;<span>
|}
||
{| class="wikitable"
!Carattere
!Codice
|-
|'''#'''||<span style="color:red">&amp;#35;<span>
|-
|&nbsp;||
|-
|&nbsp;||
|}
|}
Per una lista completa dei simboli e dei rispettivi codici consultare questa pagina<sup>[[#Documentazione esterna|[3]]]</sup>.
==Documentazione esterna==
====Link di questa pagina====
[1] [http://www.mediawiki.org/wiki/Help:Magic_words Le parole magiche]<br />
[2] [http://it.wikipedia.org/wiki/Aiuto:Markup_immagini Guida all'inserimento di immagini]<br />
[3] [https://en.wikipedia.org/wiki/List_of_XML_and_HTML_character_entity_references Caratteri speciali HTML]<br />
[4] [http://www.mediawiki.org/wiki/Help:Tables Guida all'inserimento delle tabelle]<br />
[5] [http://meta.wikimedia.org/wiki/Help:Table WikiMedia - Tabelle]
====Altri link utili====
[http://meta.wikimedia.org/wiki/Help:Editing WikiMedia Help on Editing]<br />
[http://meta.wikimedia.org/wiki/Help:Help WikiMedia Documentazione]<br />
Estratto da "https://guide.debianizzati.org/index.php/Speciale:DiffMobile/31840...44525"