Documentazione/Syntax: differenze tra le versioni
(Link alle sezioni interne di un documento) |
m (Annullate le modifiche di Spina (discussione), riportata alla versione precedente di Zoros) |
(Nessuna differenza)
|
Versione delle 12:37, 18 set 2011
Indice
Paragrafi e intestazioni
Il "contenitore" usato in questo wiki è Mediawiki, lo stesso di Wikipedia. Uno degli elementi portanti di questo sistema, nato proprio per documentare, è l'uso dei paragrafi o header (intestazioni). Dalle intestazioni, Mediawiki ricava automaticamente l'indice. Per creare un buon articolo è fondamentale partire da un buon indice, quindi l'indice è la prima cosa da abbozzare. Un esempio concreto di sorgente dovrebbe chiarire il tutto:
Sorgente | Risultato |
---|---|
= Il computer =
== La scheda madre ==
=== CPU ===
=== RAM ===
=== Hard disk ===
== Alimentatore ==
== Case ==
|
|
Elenchi puntati e numerati
Creare elenchi puntati e numerati è molto semplice. Il risultato grafico (forma dei bullet, ecc.) dipende dalla skin usata. Esempio diretto:
Sorgente | Risultato |
---|---|
*Root
**Level 1
***Level 2
#Root
##Level 1
###Level 2
:Root
::Level 1
:::Level 2
|
|
Inserire dei link
L'inserimento di link nel testo dell'articolo avviene semplicemente inserendo nomi e percorsi tra parentesi quadre. Esempio diretto:
Sorgente | Risultato | |
---|---|---|
Link interni | [[Documentazione|Ritorna a pagina principale]]
|
Ritorna a pagina principale |
Link esterni | [http://www.slacky.eu Slacky Community]
|
Slacky Community |
Controllare comunque le estensioni permesse e le raccomandazioni in Carica un file
Costruire tabelle
Per costruire delle tabelle si possono usare i tag HTML, ma è meglio usare la sintassi Mediawiki. Un semplice esempio:
Sorgente | Risultato | ||||||
---|---|---|---|---|---|---|---|
{| class="wikitable" ** Inizio tabella e stili **
! Header1 ** Intestazioni **
! Header2
! Header3
|- ** questo crea una nuova riga **
| Cell 1 ** Contenuti **
| Cell 2
| Cell 3
|}
|
|
Nota: ** tra asterischi i commenti, da rimuovere **
Inserire immagini
Le immagini possono essere caricate con l'apposito link Carica un file, ma generalmente si procede in un modo più diretto, stile wiki: si inserisce il wiki-tag nella posizione voluta del testo, si salva la pagina, quindi si carica il file cliccando sul riquadro ancora vuoto. In questo modo il file che avete sul PC viene rinominato al caricamento. E' buona cosa specificare un nome lungo e significativo, possibilmente legato all'articolo.
Sorgente | Risultato |
---|---|
[[Image:Esempio sintassi immagini.jpg|right|thumb|300px|Didascalia]]
|
File:Esempio sintassi immagini.jpg Didascalia |
La sintassi proposta è quella più adatta al nostro wiki, in particolare le immagini allineate a destra rendono migliore l'impaginazione. Per approfondimenti si rimanda alla pagina di aiuto:images di Mediawiki.
Nota: l'esempio si riferisce di proposito ad una immagine ancora da caricare
Attenzione, non inserire immagini di cui non si hanno i diritti di pubblicazione
|
E' bene assicurarsi che le immagini che carichiamo siano esenti da vincoli di pubblicazione su questo wiki. Un buon metodo per evitare problemi è di scattare in proprio una foto dell'oggetto che vogliamo raffigurare anche se ciò non ci mette totalmente al riparo da sorprese (es: foto di un quadro = foto di opera d'arte derivata). Un posto in cui cercare immagini già controllate sotto il profilo dei diritti di pubblicazione è Wikimedia Commons.
Caricare dei file
Per i file da allegare all'articolo vale quanto già scritto per le immagini: conviene prima inserire il tag che specifica il file da caricare, quindi, salvato l'articolo, caricarlo:
Sorgente | Risultato |
---|---|
[[File:Nome lungo e significativo.estensione]]
|
File:Nome lungo e significativo.estensione (cliccando sul link sopra si carica il file) |
Controllare comunque le estensioni permesse e le raccomandazioni in Carica un file
Usare un Template
I Template (modelli di pagina) sono un ottimo strumento per creare delle strutture, anche complesse, con stili personalizzati e riutilizzabili in più articoli. Vediamo un esempio di utilizzo:
Sorgente | Risultato | ||
---|---|---|---|
{{Hint
|Esempio
|Questo è un esempio di utilizzo di un Template
}}
|
|
I modelli presenti in questo wiki sono raccolti qui: Modelli disponibili
Assegnare una categoria
E' molto importante assegnare una categoria all'articolo in modo che possa essere ritrovato con facilità. La sintassi è la seguente:
[[Category:Install e Upgrade]]
Le categorie da usare sono, di norma, quelle riportate in Pagina principale.
Nota: fare attenzione al maiuscolo/minuscolo, Mediawiki potrebbe essere "case sensitive". Il wiki-tag Category andrebbe collocato a fine pagina.
Firmare l'articolo
Nel caso si volesse firmare l'articolo con il proprio nickname cliccabile, data e ora, basta aggiungere 4 tilde consecutive:
~~~~