534
contributi
S3v (discussione | contributi) mNessun oggetto della modifica |
m (mini-errore in syntaxhighlight table) |
||
(57 versioni intermedie di 3 utenti non mostrate) | |||
Riga 1: | Riga 1: | ||
{{Help}} | {{Help}} | ||
== Indice == | == Indice == | ||
L'indice per ciascuna pagina viene creato automaticamente se sono presenti almeno | 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 | # 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 [ | 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>''' | |||
È 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 28: | Riga 26: | ||
|<pre>== Titolo 2 = </pre> | |<pre>== Titolo 2 = </pre> | ||
| | | | ||
= | [[Image:Titolo2.png|link=]] | ||
|- | |- | ||
|Titolo 3 | |Titolo 3 | ||
Riga 34: | Riga 32: | ||
|<pre>=== Titolo 3 === </pre> | |<pre>=== Titolo 3 === </pre> | ||
| | | | ||
= | [[Image:Titolo3.png|link=]] | ||
|- | |- | ||
|Titolo 4 | |Titolo 4 | ||
Riga 40: | Riga 38: | ||
|<pre>==== Titolo 4 ==== </pre> | |<pre>==== Titolo 4 ==== </pre> | ||
| | | | ||
= | [[Image:Titolo4.png|link=]] | ||
|- | |- | ||
|Titolo 5 | |Titolo 5 | ||
Riga 46: | Riga 44: | ||
|<pre>===== Titolo 5 ===== </pre> | |<pre>===== Titolo 5 ===== </pre> | ||
| | | | ||
= | [[Image:Titolo5.png|link=]] | ||
|- | |- | ||
|Titolo 6 | |Titolo 6 | ||
Riga 52: | Riga 50: | ||
|<pre>====== Titolo 6 ====== </pre> | |<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" | {| class="wikitable" | ||
! width= | ! width="12%" |Tipo di formattazione | ||
! Descrizione | !Descrizione | ||
! Sintassi | !Sintassi | ||
! width= | ! 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 == | |||
===== 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. | |||
Da qui inizia il secondo paragrafo.</pre> | |||
|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. | |||
|} | |||
=====Indentazione ===== | |||
Per indentare un paragrafo, farlo precedere da uno o più caratteri di due punti "''':'''" | |||
{| class="wikitable" | |||
!Esempio | |||
!Risultato | |||
|- | |||
|<pre>:questo paragrafo è rientrato | |||
::questo paragrafo è rientrato (2)<br/>Seconda riga | |||
:::questo paragrafo è rientrato (3)</pre> | |||
| | |||
:questo paragrafo è rientrato | |||
<pre> | ::questo paragrafo è rientrato (2)<br />Seconda riga | ||
: questo paragrafo è rientrato | :::questo paragrafo è rientrato (3) | ||
</pre> | |} | ||
===== Blockquote===== | |||
Altro modo per indentare un paragrafo è includerlo all'interno dei tag '''<nowiki><blockquote></nowiki> <nowiki></blockquote></nowiki>''' | |||
: questo paragrafo è rientrato | {| class="wikitable" | ||
!Esempio | |||
Altro modo per indentare un paragrafo è includerlo all'interno dei tag '''<nowiki><blockquote></nowiki> | !Risultato | ||
|- | |||
<pre> | |<pre><blockquote> | ||
<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/> | ||
</ | 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</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'''</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</pre> | |||
* Terzo elemento della lista con tag 'pre' e codice multiriga<nowiki><pre></nowiki>prima linea di codice&#10;seconda linea di codice</pre> | |||
</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 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. | |||
<pre> | 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 | |||
<pre> | </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" | ||
!Esempio | |||
=== | !Risultato | ||
# | |- | ||
## | |<pre>*uno | ||
*due | |||
=== | **tre | ||
*quattro<br/>cinque | |||
<pre> | **sei | ||
; Titolo: | ***sette</pre> | ||
</pre> | | | ||
*uno | |||
; Titolo: | * due | ||
**tre | |||
=== | *quattro<br />cinque | ||
**sei | |||
È possibile annidare elenchi puntati e numerati | ***sette | ||
<pre> | |} | ||
===Elenco numerato=== | |||
Permette di ottenere elenchi o sotto-elenchi di voci.<br />Ciascuna voce è preceduta da uno o più "#" | |||
{| class="wikitable" | |||
!Esempio | |||
!Risultato | |||
|- | |||
|<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> | ||
</ | | | ||
#Elenco numerato | |||
#*Sotto-elenco puntato | |||
#*#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). | |||
''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. | |||
# | 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. | |||
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><nowiki></nowiki>''' e '''<nowiki/></nowiki>''' per inibire l'interpretazione del testo da parte del motore del Wiki e visualizzarli come testo puro. | |||
=== | {| class="wikitable" | ||
!Esempio | |||
!Risultato | |||
|- | |||
|<pre>I tag <nowiki><code></nowiki> <nowiki></code></nowiki> non verranno interpretati.</pre> | |||
< | |I tag <nowiki><code></nowiki> <nowiki></code></nowiki> non verranno interpretati. | ||
|- | |||
||<pre>'''<nowiki>http://127.0.0.1</nowiki>'''</pre> | |||
=== | |'''<nowiki>http://127.0.0.1</nowiki>''' | ||
|} | |||
===Commenti === | |||
<pre> | È 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 | |||
---- | |||
|} | |||
<pre> | ==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> | ||
{| 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. | |||
Nei successivi esempi verrà utilizzata la ben conosciuta [[Debian Swirl|Swirl]]. L'immagine è già caricata sul Wiki. | |||
{| class="wikitable" | |||
!Azione | |||
!Esempio | |||
! width="100px" |Risultato | |||
|- | |||
<pre> | |Inserimento con dimensioni originali||<pre>[[Image:Swirl-50.png]]</pre>oppure:<pre>[[File:Swirl-50.png]]</pre>||[[File:Swirl-50.png]] | ||
[ | |- | ||
</pre> | |Cambiare le dimensioni specificando i pixel||<pre>[[Image:Swirl-50.png|30px]]</pre>||[[File:Swirl-50.png|30px]] | ||
|- | |||
|Centrare l'immagine||<pre>[[Image:Swirl-50.png|center]]</pre>||[[File:Swirl-50.png|center]] | |||
|- | |||
[ | |Inibire il link alla pagina dell'immagine||<pre>[[Image:Swirl-50.png|link=]]</pre>||[[Image:Swirl-50.png|link=]] | ||
|- | |||
|Link ad una pagina interna al Wiki||<pre>[[Image:Swirl-50.png|link=Pagina principale]]</pre>||[[Image:Swirl-50.png|link=Pagina principale]] | |||
|- | |||
|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]] | |||
|- | |||
|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]] | |||
<pre> | |- | ||
[[ | |Thumbnail||<pre>[[Image:Swirl-50.png|thumb]]</pre>||[[Image:Swirl-50.png|thumb]] | ||
|- | |||
[[ | |Thumbnail centrato||<pre>[[Image:Swirl-50.png|thumb|center]]</pre>||[[Image:Swirl-50.png|thumb|center]] | ||
</pre> | |- | ||
|Thumbnail con didascalia||<pre>[[Image:Swirl-50.png|thumb|Swirl di Debian]]</pre>||[[Image:Swirl-50.png|thumb|Swirl di Debian]] | |||
|- | |||
|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]] | |||
[[ | |- | ||
|Frame||<pre>[[Image:Swirl-50.png|frame]]</pre>||[[Image:Swirl-50.png|frame]] | |||
[[ | |- | ||
|Frame con didascalia||<pre>[[Image:Swirl-50.png|frame|Swirl di Debian]]</pre>||[[Image:Swirl-50.png|frame|Swirl di Debian]] | |||
|- | |||
|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]] | |||
|- | |||
<pre>[[ | |} | ||
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'''"}} | ||
</pre> | ==Caratteri speciali HTML== | ||
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. | |||
{| | |||
[[ | | | ||
{| class="wikitable" | |||
[[ | !Carattere | ||
!Codice | |||
|- | |||
|'''&'''||<span style="color:red">&amp;<span> | |||
|- | |||
<pre>[ | |'''(spazio)'''||<span style="color:red">&nbsp;<span> | ||
|- | |||
[ | |'''<'''||<span style="color:red">&lt;<span> | ||
|} | |||
|| | |||
{| class="wikitable" | |||
[ | !Carattere | ||
!Codice | |||
[ | |- | ||
|'''>'''||<span style="color:red">&gt;<span> | |||
|- | |||
|'''='''||<span style="color:red">&#61;<span> | |||
<pre>[[: | |- | ||
[[: | |'''['''||<span style="color:red">&#91;<span> | ||
|} | |||
[[: | || | ||
[[: | {| class="wikitable" | ||
!Carattere | |||
!Codice | |||
|- | |||
Per | |''']'''||<span style="color:red">&#93;<span> | ||
|- | |||
== | |'''|'''||<span style="color:red">&#124;<span> | ||
|- | |||
|'''{'''||<span style="color:red">&#123;<span> | |||
|} | |||
= | || | ||
{| class="wikitable" | |||
!Carattere | |||
!Codice | |||
|- | |||
|'''}'''||<span style="color:red">&#125;<span> | |||
|- | |||
= | |'''(line feed)'''||<span style="color:red">&#10;<span> | ||
|- | |||
|'''*'''||<span style="color:red">&#42;<span> | |||
|} | |||
|| | |||
{| class="wikitable" | |||
!Carattere | |||
!Codice | |||
|- | |||
|'''#'''||<span style="color:red">&#35;<span> | |||
|- | |||
| || | |||
|- | |||
| || | |||
|} | |||
|} | |||
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==== | |||
Per una lista completa dei simboli e dei rispettivi codici | [http://meta.wikimedia.org/wiki/Help:Editing WikiMedia Help on Editing]<br /> | ||
[http://meta.wikimedia.org/wiki/Help:Help WikiMedia Documentazione]<br /> | |||