Guide@Debianizzati.Org

Aiuto:Sintassi: differenze tra le versioni

Aiuto Discussione

Aiuto:Sintassi (visualizza wikitesto)

Versione delle 16:25, 14 ott 2021

14 731 byte aggiunti ,  14 ott 2021
m
mini-errore in syntaxhighlight table
(nuova pagina)
 
m (mini-errore in syntaxhighlight table)
 
(60 versioni intermedie di 3 utenti non mostrate)
Riga 1: Riga 1:
{{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==
È 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"
! width="15%" |Tipo formattazione
!Descrizione
!Sintassi
! width="40%" |Risultato
|-
|Titolo 1
|Racchiudere tra = <br />(non utilizzare all'interno delle pagine in quanto è la formattazione del titolo della guida).
|<pre>= Titolo 1 = </pre>
|
[[Image:Titolo1.png|link=]]
|-
|Titolo 2
|Racchiudere tra ==
|<pre>== Titolo 2 = </pre>
|
[[Image:Titolo2.png|link=]]
|-
|Titolo 3
|Racchiudere tra ===
|<pre>=== Titolo 3 === </pre>
|
[[Image:Titolo3.png|link=]]
|-
|Titolo 4
|Racchiudere tra ====
|<pre>==== Titolo 4 ==== </pre>
|
[[Image:Titolo4.png|link=]]
|-
|Titolo 5
|Racchiudere tra =====
|<pre>===== Titolo 5 ===== </pre>
|
[[Image:Titolo5.png|link=]]
|-
|Titolo 6
|Racchiudere tra ======
|<pre>====== Titolo 6 ====== </pre>
|
[[Image:Titolo6.png|link=]]
|-
|}
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 di testo==
{| class="wikitable"
! width="12%" |Tipo di formattazione
!Descrizione
!Sintassi
! width="30%" |Risultato
|-
|Grassetto
|Racchiudere il testo tra tre apici
|<pre>'''Questo testo è scritto in grassetto'''</pre>
|'''Questo testo è scritto in grassetto'''
|-
|Corsivo
|Racchiudere il testo tra due apici
|<pre>''Questo testo è scritto in corsivo''</pre>
|''Questo testo è scritto in corsivo''
|-
|Grassetto-Corsivo
|Racchiudere il testo tra cinque apici
|<pre>'''''Questo testo è scritto in grassetto-corsivo'''''</pre>
|'''''Questo testo è scritto in grassetto-corsivo'''''
|-
|Sottolineato
|Racchiudere il testo tra i tag '''<nowiki><u> </u></nowiki>'''
|<pre><u>Questo testo è sottolineato</u></pre>
|<u>Questo testo è sottolineato</u>
|-
|Barrato
|Racchiudere il testo tra i tag '''<nowiki><s> </s></nowiki>'''
|<pre><s>Questo testo è barrato</s></pre>
|<s>Questo testo è barrato</s>
|-
|Monospace
|Racchiudere il testo tra i tag '''<nowiki><code> </code></nowiki>'''
|<pre><code>Questo testo è di tipo monospace</code></pre>
|<code>Questo testo è di tipo monospace</code>
|-
|Apice
|Racchiudere il testo tra i tag '''<nowiki><sup> </sup></nowiki>'''
|<pre>Questo testo ha un <sup>apice</sup></pre>
|Questo testo ha un <sup>apice</sup>
|-
|Pedice
|Racchiudere il testo tra i tag '''<nowiki><sub> </sub></nowiki>'''
|<pre>Questo testo ha un <sub>pedice</sub></pre>
|Questo testo ha un <sub>pedice</sub>
|-
|}
==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"
!Esempio
!Risultato
|-
|<pre>Queste due righe.
Non saranno separate</pre>
|Queste due righe.Non saranno separate
|-
|<pre>Questo due righe.<br/>
Saranno separate.</pre>
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>
|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
|-
|<pre>Questo paragrafo sta per essere interrotto dal paragrafo successivo.<br/>
L'interruzione avverrà con l'inserimento di una riga vuota.


===Dividere in sezioni===
Da qui inizia il secondo paragrafo.</pre>
 
|Questo paragrafo sta per essere interrotto dal paragrafo successivo.<br />
* '''Titolo livello 1''': racchiudere tra <nowiki>=</nowiki> (non utilizzare all'interno delle pagine in quanto questa formattazione è dedicata al titolo della guida)
L'interruzione avverrà con l'inserimento di una riga vuota.<br /><br />Da qui inizia il secondo paragrafo.
* '''Titolo livello 2''': racchiudere tra <nowiki>==</nowiki>
|}
* '''Titolo livello 3''': racchiudere tra <nowiki>===</nowiki>
=====Indentazione =====
* '''Titolo livello 4''': racchiudere tra <nowiki>====</nowiki>
Per indentare un paragrafo, farlo precedere da uno o più caratteri di due punti "''':'''"
* '''Titolo livello 5''': racchiudere tra <nowiki>=====</nowiki>
{| class="wikitable"
* '''Titolo livello 6''': racchiudere tra <nowiki>======</nowiki>
!Esempio
 
!Risultato
===Formattazione testo===
|-
 
|<pre>:questo paragrafo è rientrato
* Grassetto: racchiudere tra tre apici <nowiki>'''</nowiki>: '''esempio'''
::questo paragrafo è rientrato (2)<br/>Seconda riga
* Corsivo: racchiudere tra due apici <nowiki>''</nowiki>: ''esempio''
:::questo paragrafo è rientrato (3)</pre>
* Grassetto-Corsivo: racchiudere tra cinque apici <nowiki>'''''</nowiki>: '''''esempio'''''
|
* Sottolineato: racchiudere tra <nowiki><u> </u></nowiki>: <u>esempio</u>
:questo paragrafo è rientrato
* Barrato: racchiudere tra <nowiki><s> </s></nowiki>: <s>esempio</s>
::questo paragrafo è rientrato (2)<br />Seconda riga
* Monospace: racchiudere tra <nowiki><code> </code></nowiki>: <code>esempio</code>
:::questo paragrafo è rientrato (3)
* Apice: racchiudere tra <nowiki><sup> </sup></nowiki>: esempio<sup>esempio</sup>
|}
* Pedice: racchiudere tra <nowiki><sub> </sub></nowiki>: esempio<sub>esempio</sub>
===== Blockquote=====
 
Altro modo per indentare un paragrafo è includerlo all'interno dei tag '''<nowiki><blockquote></nowiki> <nowiki></blockquote></nowiki>'''
===Gestione Paragrafi===
{| class="wikitable"
*'''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. Per ottenere l'effetto di interrompere la riga senza interrompere il paragrafo, utilizzare il tag '''<nowiki><br/></nowiki>''' alla fine della riga.<br/>
!Esempio
Esempio:
!Risultato
<pre>
|-
Questa riga non sarà divisa
|<pre><blockquote>
dalla successiva riga
</pre>
produrrà:
<pre>Questa riga non sarà divisadalla successiva riga</pre>
La sintassi corretta è in questo caso:
<pre>Questa riga sarà divisa<br/>
dalla riga successiva
</pre>
* '''Paragrafi''': Andare semplicemente a capo non influenza il paragrafo. Il paragrafo è interrotto da una linea vuota. Inserendo due linee vuote viene interrotto il paragrafo ed aggiunta una linea vuota aggiuntiva, e così via.
* '''Indentazione''': Per indentare un paragrafo farlo precedere dai due punti ":"
<pre>
: questo paragrafo è rientrato
</pre>
diventa:
 
: questo paragrafo è rientrato
 
Altro modo per indentare un paragrafo è includerlo all'interno dei tag '''<nowiki><blockquote></nowiki>'''...'''<nowiki></blockquote></nowiki>'''.<br/>
Ad esempio:
<pre>
<blockquote>
Questo è un esempio<br/>
Questo è un esempio<br/>
che mostra in che modo<br/>
che mostra in che modo<br/>
indentare il testo.<br/>
indentare il testo<br/>
</blockquote>
con il tag "blockquote"
</blockquote></pre>
|<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 />
Questi esempi chiariscono meglio i due metodi (notare ancora lo spazio iniziale nel secondo e terzo esempio):
{| class="wikitable"
!Esempio
!Risultato
|-
|<pre><nowiki><pre></nowiki>'''nonostante il triplo apice, il testo non sarà visualizzato in grassetto'''&lt;/pre></pre>
|<pre>'''nonostante il triplo apice, il testo non sarà visualizzato in grassetto'''</pre>
|-
|<pre> Con lo spazio iniziale, il triplo apice consente un testo in '''grassetto'''</pre>
|
Con lo spazio iniziale, il triplo apice consente un testo in '''grassetto'''
|-
|<pre> ... oppure un testo colorato in <span style="color:red">rosso</span></pre>
|
... 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>
</pre>
diventerà:
|
<blockquote>
*Primo elemento della lista
Questo è un esempio<br/>
*Secondo elemento della lista con tag 'pre'<pre>Linea di codice</pre>
che mostra in che modo<br/>
*Terzo elemento della lista con tag 'pre' e codice multiriga<pre>prima linea di codice&#10;seconda linea di codice</pre>
indentare il testo.<br/>
|-
</blockquote>
|}
 
A tal proposito, leggere anche il [[#Caratteri speciali HTML|paragrafo relativo ai codici HTML]].
{{Box|Note|  
==Evidenziazione della sintassi con GeSHi==
* usare il tag <nowiki><nowiki></nowiki></nowiki> per inibire l'interpretazione dei precedenti caratteri e visualizzarli come testo puro.
Particolarmente utile per evidenziare la sintassi di codice dei linguaggi di programmazione.
* con <nowiki><!-- Questo è un commento --></nowiki> è possibile inserire un commento che verrà visualizzato solo nella finestra di editing della pagina.}}
 
===Formattazione di codice===
Particolarmente utile per mettere in evidenza linee di codice, contenuto di file, comandi e il loro output.
Per crearlo è sufficiente racchiudere il testo tra i tag <nowiki><pre> </pre></nowiki>
 
Esempio:
 
<nowiki><pre>prova di testo</pre></nowiki>


diventa:
Per utilizzarlo è sufficiente racchiudere il codice da evidenziare all'interno di
<pre>prova di testo</pre>
<pre><syntaxhighlight lang="codelang" line='line'></syntaxhighlight></pre> dove al posto di codelang è stato inserito il nome del linguaggio di programmazione.
 
===Attributi===
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 comando mette a disposizione differenti attributi
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>. Ad esempio, per inserire del testo in grassetto, scrivere (notare lo spazio iniziale):
{| class="wikitable"
<pre> Questo è un riquadro che contiene testo in '''grassetto'''</pre>  
|+
Diventa:
!Attributo
Questo è un riquadro che contiene testo in '''grassetto'''
!Funzione
O anche:
!Esempio
<pre> Questo è un riquadro che contiene testo colorato in <span style="color:red">rosso</span></pre>
!Risultato
diventa:
|-
Questo è un riquadro che contiene testo colorato in <span style="color:red">rosso</span>
|<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==
===Puntati===
===Elenco puntato===
* Per avere un elenco puntato è sufficiente iniziare la riga con *
Permette di ottenere elenchi o sotto-elenchi di voci.<br />Ciascuna voce è preceduta da uno o più "*"
** Per creare sotto-elenchi puntati (come questo) basta cominciare la riga con **
{| class="wikitable"
 
!Esempio
===Numerati===
!Risultato
# Per avere un elenco numerato è sufficiente iniziare la riga con #
|-
## Per creare sotto-elenchi numerati (come questo) basta cominciare la riga con ##
|<pre>*uno
 
*due
===Descrizioni===
**tre
Per fare una descrizione guardate questo esempio:
*quattro<br/>cinque
<pre>
**sei
; Titolo: questa è la descrizione del termine
***sette</pre>
</pre>
|
diventa:
*uno
; Titolo: questa è la descrizione del termine
* due
 
**tre
===Annidati===
*quattro<br />cinque
 
**sei
È possibile annidare elenchi puntati e numerati:
***sette
<pre>
|}
# Elenco numerato
===Elenco numerato===
#* Sotto-elenco puntato
Permette di ottenere elenchi o sotto-elenchi di voci.<br />Ciascuna voce è preceduta da uno o più "#"
#*# Sotto-sotto-elenco numerato
{| class="wikitable"
</pre>
!Esempio
 
!Risultato
diventa:
|-
 
|<pre>#uno
#due
##tre
#quattro<br/>cinque
##sei
###sette</pre>
|
#uno
#due
##tre
#quattro<br />cinque
##sei
###sette
|}
===Descrizione===
Permette l'inserimento di una descrizione per una determinata voce.
{| class="wikitable"
!Esempio
!Risultato
|-
|<pre>;Titolo: Qui può essere inserita una descrizione.<br/>Seconda riga.</pre>
|
;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
|-
|<pre>
# Elenco numerato
# Elenco numerato
#* Sotto-elenco puntato
#* Sotto-elenco puntato
#*# Sotto-sotto-elenco numerato
#*# Sotto-sotto-elenco numerato</pre>
 
|
==Template==
#Elenco numerato
Per aiutare nella formattazione della pagina sono disponibili diversi template. Questi possono essere liberamente utilizzati per mettere in evidenza messaggi di avvertimento, note e suggerimenti, oppure per contrassegnare la guida secondo il suo stato (bozza, debianized, da cancellare, etc.).<br/>
#*Sotto-elenco puntato
Per avere una lista completa dei template disponibili, vedere la guida [[Usare i Template]]
#*#Sotto-sotto-elenco numerato
 
|-
=== Testo da segnalare ===
|}
[[Template:Discussione | Questo template]] serve per segnalare parti della guida problematiche o poco chiare. '''Non segnalare problemi <u>derivanti</u> dall'applicazione della guida o riguardanti argomenti ad essa correlati'''. Per questo scopo c'è il [http://forum.debianizzati.org forum].<br/>
==Link==
Il risultato dell'applicazione del template sarà:
===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).
<span style="background-color:#ffeaea">''Questa parte della guida presenta un problema''</span><sup>[[{{TALKPAGENAME}} | discussione]]</sup>
 
 
=== Riquadro con Titolo ===
Per inserire note, avvertimenti o altro, è possibile utilizzare un riquadro con titolo, questo testo:
 
<pre>{{Box|Titolo|Testo di prova del Riquadro con titolo}}</pre>
 
darà il seguente risultato:
 
{{Box|Titolo|Testo di prova del Riquadro con titolo}}
 
=== Riquadro Attenzione ===
Per inserire del testo in risalto, ad esempio se ci sono comandi pericolosi da eseguire si può inserire un avvertimento in questo modo:
 
<pre>{{Warningbox|Testo dell'avvertimento}}</pre>
 
che darà il seguente risultato:
 
{{Warningbox|Testo dell'avvertimento}}
 
===Riquadro Suggerimento===


Per inserire un trucco o un barbatrucco a scelta dal cilindro.
''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.''
{| 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.


<pre>{{Suggerimento|Un trucco per migliorare le prestazioni potrebbe essere....}}</pre>
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).
===Link a sezioni delle guide===
È possibile inserire un link ad una specifica [[#Dividere in sezioni|sezione]] di una pagina anteponendo al suo titolo un carattere "'''#'''".<br />
Se il nome della guida non viene specificato, il link sarà riferito ad una sezione della pagina corrente.
{| class="wikitable"
!Esempio
!Risultato
|-
|<pre>[[#Formattazione di codice|Formattazione di codice]]</pre>
|[[#Formattazione di codice|Formattazione di codice]]<br />
|-
|<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.


con il quale si ottiene:
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==
{{Suggerimento| Un trucco per migliorare le prestazioni potrebbe essere....}}
===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.
==Creazione Link==
{| class="wikitable"
I link si differenziano in link interni al wiki e link esterni.
!Esempio
 
!Risultato
===Link Esterni===
|-
Per i link esterni basta scrivere l'URL compreso <nowiki>http://</nowiki>.
|<pre>I tag &lt;nowiki><code></nowiki> &lt;nowiki></code></nowiki> non verranno interpretati.</pre>
Scrivendo:
|I tag <nowiki><code></nowiki> <nowiki></code></nowiki> non verranno interpretati.
<pre>
|-
http://meta.wikimedia.org/wiki/Help:Link
||<pre>'''&lt;nowiki>http://127.0.0.1</nowiki>'''</pre>
</pre>
|'''<nowiki>http://127.0.0.1</nowiki>'''
 
|}
si ottiene:
===Commenti ===
 
È possibile inserire un commento che verrà visualizzato solo nella finestra di editing della pagina.
http://meta.wikimedia.org/wiki/Help:Link
{| class="wikitable"
 
!Esempio
oppure per avere un link visualizzato con un titolo generico (non URL):
!Risultato
 
|-
<pre>
|<pre><!-- Questo è un commento --></pre>
[http://meta.wikimedia.org/wiki/Help:Link WikiMedia Links]
|(Il testo sarà visibile solo all'interno della pagina di editing.)
</pre>
|}
 
===Linea===
viene visualizzato così:
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"
[http://meta.wikimedia.org/wiki/Help:Link WikiMedia Links]
! width="30%" |Esempio
 
!Risultato
{{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.}}
|-
 
|<pre>Sta per essere inserite una riga
===Link Interni al Wiki===
----</pre>
 
|Sta per essere inserite una riga
Scrivendo:
----
|}
==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>
[[Usare Fotocamere Digitali]]
{| class="wikitable"
 
!Colonna 1
[[Usare Fotocamere Digitali | Altro titolo, stesso link]]
!Colonna 2
</pre>
!Colonna 3
 
|-
si ottiene:
|cella 1 || cella 2 || style="background:lightblue" | cella 3
 
|-
[[Usare Fotocamere Digitali]]
|cella 4 || style="color:red" | cella 5 || cella 6
 
|}
[[Usare Fotocamere Digitali | Altro titolo, stesso link]]
 
'''Nota''': Per creare una nuova pagina basta fare un link con un nuovo titolo, poi cliccando sul link è possibile editare la nuova pagina.
 
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]]
 
[[#Formattazione|Passa a Formattazione]]
</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.


e otterremo:
Nei successivi esempi verrà utilizzata la ben conosciuta [[Debian Swirl|Swirl]]. L'immagine è già caricata sul Wiki.
 
{| class="wikitable"
[[#Formattazione]]
!Azione
 
!Esempio
[[#Formattazione|Passa a Formattazione]]
! width="100px" |Risultato
 
|-
===Link a indirizzi email===
|Inserimento con dimensioni originali||<pre>[[Image:Swirl-50.png]]</pre>oppure:<pre>[[File:Swirl-50.png]]</pre>||[[File:Swirl-50.png]]
 
|-
Per inserire il link ad un indirizzo email è sufficiente utilizzare la sintassi:
|Cambiare le dimensioni specificando i pixel||<pre>[[Image:Swirl-50.png|30px]]</pre>||[[File:Swirl-50.png|30px]]
<pre>[mailto:esempio@esempio.org]
|-
 
|Centrare l'immagine||<pre>[[Image:Swirl-50.png|center]]</pre>||[[File:Swirl-50.png|center]]
[mailto:esempio@esempio.org Nome del Contatto]</pre>
|-
 
|Inibire il link alla pagina dell'immagine||<pre>[[Image:Swirl-50.png|link=]]</pre>||[[Image:Swirl-50.png|link=]]
che visualizzerà:
|-
 
|Link ad una pagina interna al Wiki||<pre>[[Image:Swirl-50.png|link=Pagina principale]]</pre>||[[Image:Swirl-50.png|link=Pagina principale]]
[mailto:esempio@esempio.org]
|-
 
|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]]
[mailto:esempio@esempio.org Nome del Contatto]
|-
 
|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]]
=== Link a categorie ===
|-
È 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":
|Thumbnail||<pre>[[Image:Swirl-50.png|thumb]]</pre>||[[Image:Swirl-50.png|thumb]]
<pre>[[:Categoria:Internet]]
|-
[[:Categoria:Internet | Lista delle guide contenute nella categoria "Internet"]]</pre>
|Thumbnail centrato||<pre>[[Image:Swirl-50.png|thumb|center]]</pre>||[[Image:Swirl-50.png|thumb|center]]
che avrà come effetto:<br/>
|-
[[:Categoria:Internet]]<br/>
|Thumbnail con didascalia||<pre>[[Image:Swirl-50.png|thumb|Swirl di Debian]]</pre>||[[Image:Swirl-50.png|thumb|Swirl di Debian]]
[[:Categoria:Internet | Lista delle guide contenute nella categoria "Internet"]]
|-
 
|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]]
==Immagini==
|-
È possibile effettuare l'upload di immagini tramite la pagina [[Speciale:Upload | apposita ]] raggiungibile anche tramite il link presente nella toolbox a sinistra.
|Frame||<pre>[[Image:Swirl-50.png|frame]]</pre>||[[Image:Swirl-50.png|frame]]
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.
|-
 
|Frame con didascalia||<pre>[[Image:Swirl-50.png|frame|Swirl di Debian]]</pre>||[[Image:Swirl-50.png|frame|Swirl di Debian]]
== Categorie ==
|-
 
|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]]
Ci son due tipi di categorie: quelle che indicano '''l'argomento della guida''' e quelle ''di gestione'' che indicano una sorta di '''stato dell'articolo''' (debianized, stub, obsoleto...). Nel seguito sono illustrate entrambe.
|-
 
|}
=== Categorie di argomenti ===
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.
Le categorie che indicano l'argomento della guida sono come dei tag affissi alla guida che permettono di catalogarla. Ogni guida può appartenere a più categorie contemporaneamente a seconda dell'argomento trattato.
{{Warningbox|Per evitare problemi di errato indirizzamento, il carattere "{{=}}" (uguale) all'interno degli URL va sostituito con la corrispondente codifica "'''%3D'''"}}
 
==Caratteri speciali HTML==
Una categoria può appartenere essa stessa ad un'altra categoria: in questo caso viene chiamata '''sotto-categoria'''. Una sotto-categoria è una normalissima categoria, con la sola differenza che viene elencata nella pagina delle categorie a cui appartiene ([[:Categoria:Apt|esempio]]). Una sotto-categoria può appartenere a più categorie contemporaneamente.
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.
L'elenco completo delle ''categorie di argomenti'' presenti nel wiki e delle loro relazioni gerarchiche (notare che ''alcune categorie sono elencate più volte perché sono sotto-categorie di più d'una categoria'') è consultabile in [[Lista Categorie|questa pagina]].
{|
 
|
=== Categorie per la gestione ===
{| class="wikitable"
Questo è invece l'elenco delle categorie ''di gestione'' del wiki:
!Carattere
* [[:Categoria:Debianized|Debianized]]
!Codice
* [[:Categoria:Glossario|Glossario]]
|-
* [[:Categoria:Old|Old]]
|'''&'''||<span style="color:red">&amp;amp;<span>
* [[:Categoria:Stub|Stub]]
|-
* [[:Categoria:Da_Cancellare|Da Cancellare]]
|'''(spazio)'''||<span style="color:red">&amp;nbsp;<span>
* [[:Categoria:Da_Adottare|Da Adottare]]
|-
 
|'''<'''||<span style="color:red">&amp;lt;<span>
=== Come inserire una guida in una categoria? ===
|}
 
||
Niente di più semplice. Basta aggiungere in fondo alla guida stessa il testo <code><nowiki>[[Categoria:nome categoria]]</nowiki></code>, dove appunto ''nome categoria'' è il nome della categoria nella quale si vuole inserire la guida. È possibile anche aggiungere più di una categoria per ciascuna guida se si ritiene che questa vada a coprire argomenti diversi.<br/>
{| class="wikitable"
Ci si può accertare del corretto inserimento della guida nella giusta categoria (o nelle giuste categorie) guardando in fondo alla pagina della guida stessa nel riquadro apposito.
!Carattere
 
!Codice
Se la categoria appare scritta in rosso oppure non appare nessuna categoria, si è verificato uno dei seguenti problemi:
|-
# Non è stato inserito correttamente il tag per la categoria; in questo caso accertarsi della corretta ortografia (ad esempio controllare le doppie parentesi quadre, il carattere "due punti" etc.) e modificare nuovamente la guida.
|'''>'''||<span style="color:red">&amp;gt;<span>
# La categoria immessa ha un nome errato; in questo caso guardare la pagina delle [[Lista Categorie|categorie]] per controllare il nome corretto e ricordandosi che le maiuscole sono importanti.
|-
# La categoria non esiste. Caso limite ma per nulla improbabile: contattare lo staff del wiki sul forum oppure inserire una descrizione del problema nella pagina di discussione relativa alla guida.
|'''='''||<span style="color:red">&amp;#61;<span>
 
|-
Un aspetto molto importante di cui tenere conto è quello di '''non inserire''' una guida contemporaneamente sia in una categoria-madre che in una categoria-figlia. Ad esempio non si deve inserire una guida sia nella categoria "Internet" che nella categoria "Browser".
|'''['''||<span style="color:red">&amp;#91;<span>
 
|}
== Caratteri speciali HTML ==
||
 
{| class="wikitable"
È 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.
!Carattere
 
!Codice
Per una lista completa dei simboli e dei rispettivi codici vedere:
|-
 
|''']'''||<span style="color:red">&amp;#93;<span>
*  [http://en.wikipedia.org/wiki/List_of_XML_and_HTML_character_entity_references List of XML and HTML character entity references]
|-
 
|'''&#124;'''||<span style="color:red">&amp;#124;<span>
==Documentazione Esterna==
|-
* [http://meta.wikimedia.org/wiki/Help:Editing WikiMedia Help on Editing]
|'''{'''||<span style="color:red">&amp;#123;<span>
* [http://meta.wikimedia.org/wiki/Help:Help WikiMedia Documentazione]
|}
* [http://meta.wikimedia.org/wiki/Help:Table WikiMedia Tabelle]
||
{| 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/31541...44525"