Documentazione/Syntax: differenze tra le versioni

Versione delle 12:37, 18 set 2011

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:

= 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:

*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:

[[Documentazione|Ritorna a pagina principale]]

[http://www.slacky.eu 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:

{| 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.

[[Image:Esempio sintassi immagini.jpg|right|thumb|300px|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

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:

[[File:Nome lungo e significativo.estensione]]

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:

{{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:

~~~~