Aiuto:Sintassi
| Linee guida su come contribuire al Wiki |
|
Sommario |
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.
Per forzare la visualizzazione dell'indice nel caso:
- vi siano meno di tre sezioni
- si voglia farlo comparire in un punto specificato della pagina
si può utilizzare la parola magica __TOC__
Formattazione
Dividere in sezioni
- Titolo livello 1: racchiudere tra = (non utilizzare all'interno delle pagine in quanto questa formattazione è dedicata al titolo della guida)
- Titolo livello 2: racchiudere tra ==
- Titolo livello 3: racchiudere tra ===
- Titolo livello 4: racchiudere tra ====
- Titolo livello 5: racchiudere tra =====
- Titolo livello 6: racchiudere tra ======
Formattazione testo
- Grassetto: racchiudere tra tre apici ''': esempio
- Corsivo: racchiudere tra due apici '': esempio
- Grassetto-Corsivo: racchiudere tra cinque apici ''''': esempio
- Sottolineato: racchiudere tra <u> </u>: esempio
- Barrato: racchiudere tra <s> </s>:
esempio - Monospace: racchiudere tra <code> </code>:
esempio - Apice: racchiudere tra <sup> </sup>: esempioesempio
- Pedice: racchiudere tra <sub> </sub>: esempioesempio
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. Per ottenere l'effetto di interrompere la riga senza interrompere il paragrafo, utilizzare il tag <br/> alla fine della riga.
Esempio:
Questa riga non sarà divisa dalla successiva riga
produrrà:
Questa riga non sarà divisadalla successiva riga
La sintassi corretta è in questo caso:
Questa riga sarà divisa<br/> dalla riga successiva
- 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 ":"
: questo paragrafo è rientrato
diventa:
- questo paragrafo è rientrato
Altro modo per indentare un paragrafo è includerlo all'interno dei tag <blockquote>...</blockquote>.
Ad esempio:
<blockquote> Questo è un esempio<br/> che mostra in che modo<br/> indentare il testo.<br/> </blockquote>
diventerà:
Questo è un esempio
che mostra in che modo
indentare il testo.
|
Note
|
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 <pre> </pre>
Esempio:
<pre>prova di testo</pre>
diventa:
prova di testo
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.
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 <pre> </pre>. Ad esempio, per inserire del testo in grassetto, scrivere (notare lo spazio iniziale):
Questo è un riquadro che contiene testo in '''grassetto'''
Diventa:
Questo è un riquadro che contiene testo in grassetto
O anche:
Questo è un riquadro che contiene testo colorato in <span style="color:red">rosso</span>
diventa:
Questo è un riquadro che contiene testo colorato in rosso
Elenchi
Puntati
- Per avere un elenco puntato è sufficiente iniziare la riga con *
- Per creare sotto-elenchi puntati (come questo) basta cominciare la riga con **
Numerati
- Per avere un elenco numerato è sufficiente iniziare la riga con #
- Per creare sotto-elenchi numerati (come questo) basta cominciare la riga con ##
Descrizioni
Per fare una descrizione guardate questo esempio:
; Titolo: questa è la descrizione del termine
diventa:
- Titolo
- questa è la descrizione del termine
Annidati
È possibile annidare elenchi puntati e numerati:
# Elenco numerato #* Sotto-elenco puntato #*# Sotto-sotto-elenco numerato
diventa:
- Elenco numerato
- Sotto-elenco puntato
- Sotto-sotto-elenco numerato
- Sotto-elenco puntato
Template
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.).
Per avere una lista completa dei template disponibili, vedere la guida Usare i Template
Testo da segnalare
Questo template serve per segnalare parti della guida problematiche o poco chiare. Non segnalare problemi derivanti dall'applicazione della guida o riguardanti argomenti ad essa correlati. Per questo scopo c'è il forum.
Il risultato dell'applicazione del template sarà:
Questa parte della guida presenta un problema discussione
Riquadro con Titolo
Per inserire note, avvertimenti o altro, è possibile utilizzare un riquadro con titolo, questo testo:
{{Box|Titolo|Testo di prova del Riquadro con titolo}}
darà il seguente risultato:
|
|
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:
{{Warningbox|Testo dell'avvertimento}}
che darà il seguente risultato:
|
ATTENZIONE Testo dell'avvertimento |
Riquadro Suggerimento
Per inserire un trucco o un barbatrucco a scelta dal cilindro.
{{Suggerimento|Un trucco per migliorare le prestazioni potrebbe essere....}}
con il quale si ottiene:
|
Suggerimento Un trucco per migliorare le prestazioni potrebbe essere.... |
Creazione Link
I link si differenziano in link interni al wiki e link esterni.
Link Esterni
Per i link esterni basta scrivere l'URL compreso http://. Scrivendo:
http://meta.wikimedia.org/wiki/Help:Link
si ottiene:
http://meta.wikimedia.org/wiki/Help:Link
oppure per avere un link visualizzato con un titolo generico (non URL):
[http://meta.wikimedia.org/wiki/Help:Link WikiMedia Links]
viene visualizzato così:
|
|
ATTENZIONE Non utilizzare questa sintassi per i link interni al Wiki. Se una pagina viene spostata o cancellata, si crea un broken link di cui è difficile accorgersi. |
Link Interni al Wiki
Scrivendo:
[[Usare Fotocamere Digitali]] [[Usare Fotocamere Digitali | Altro titolo, stesso link]]
si ottiene:
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:
[[#Formattazione]] [[#Formattazione|Passa a Formattazione]]
e otterremo:
Link a indirizzi email
Per inserire il link ad un indirizzo email è sufficiente utilizzare la sintassi:
[mailto:esempio@esempio.org] [mailto:esempio@esempio.org Nome del Contatto]
che visualizzerà:
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":
[[:Categoria:Internet]] [[:Categoria:Internet | Lista delle guide contenute nella categoria "Internet"]]
che avrà come effetto:
Categoria:Internet
Lista delle guide contenute nella categoria "Internet"
Immagini
È possibile effettuare l'upload di immagini tramite la pagina apposita raggiungibile anche tramite il link presente nella toolbox a sinistra. Per sapere come inserire una immagine nel testo, è consigliabile la lettura della Guida ufficiale di Wikipedia che spiega minuziosamente come gestire le immagini in una pagina del wiki.
Categorie
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
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.
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 (esempio). Una sotto-categoria può appartenere a più categorie contemporaneamente.
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 questa pagina.
Categorie per la gestione
Questo è invece l'elenco delle categorie di gestione del wiki:
Come inserire una guida in una categoria?
Niente di più semplice. Basta aggiungere in fondo alla guida stessa il testo [[Categoria:nome categoria]], 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.
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.
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.
- La categoria immessa ha un nome errato; in questo caso guardare la pagina delle 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.
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".
Caratteri speciali HTML
È possibile inserire nel wiki qualsiasi carattere speciale HTML come ad esempio il punto della moltiplicazione (es. 2 · 3). Questi simboli si ottengono, come nell'HTML, inserendo un codice del tipo &codice; nel testo. Dove codice è una parola che rappresenta il particolare simbolo da inserire.
Per una lista completa dei simboli e dei rispettivi codici vedere: