6 999
contributi
Aiuto:Prima di iniziare: differenze tra le versioni
→Convenzioni sulla sintassi
S3v (discussione | contributi) |
S3v (discussione | contributi) |
||
| (7 versioni intermedie di uno stesso utente non sono mostrate) | |||
| Riga 16: | Riga 16: | ||
#* comandi, opzioni di comandi, singole stringhe e/o direttive dei file di configurazione; | #* comandi, opzioni di comandi, singole stringhe e/o direttive dei file di configurazione; | ||
:racchiudeteli tra i tag [[Aiuto:Sintassi#Formattazione di testo|<nowiki><code></nowiki> e <nowiki></code></nowiki>]]. | :racchiudeteli tra i tag [[Aiuto:Sintassi#Formattazione di testo|<nowiki><code></nowiki> e <nowiki></code></nowiki>]]. | ||
=== Convenzioni sullo stile === | === Convenzioni sullo stile === | ||
# Non utilizzare i [[Aiuto:Sintassi#Dividere in sezioni|titoli]] di primo livello ("= .... =") all'interno delle guide. Questi sono adibiti a formattare il titolo dell'intera guida. | |||
# Se possibile, non utilizzare i [[Aiuto:Sintassi#Dividere in sezioni|sotto-titoli]] di terzo livello ("==== .... ====") o più piccoli: indirizzarsi piuttosto sugli [[Aiuto:Sintassi#Elenchi|elenchi]]. Questo è dovuto a motivi di ordine dell'indice oltre al fatto che la loro presenza non produrrebbe alcun vantaggio in termini di leggibilità della guida. | |||
# Dividete in maniera logica la guida in [[Aiuto:Sintassi#Dividere in sezioni|sezioni]], sottosezioni (e, se necessario sotto-sottosezioni). In questo modo si sfrutterà meglio la potenza di MediaWiki che creerà automaticamente un [[Aiuto:Sintassi#Indice|indice]] iniziale che renderà molto più facile la navigazione nella vostra guida. | # Dividete in maniera logica la guida in [[Aiuto:Sintassi#Dividere in sezioni|sezioni]], sottosezioni (e, se necessario sotto-sottosezioni). In questo modo si sfrutterà meglio la potenza di MediaWiki che creerà automaticamente un [[Aiuto:Sintassi#Indice|indice]] iniziale che renderà molto più facile la navigazione nella vostra guida. | ||
# Usate, quando necessario, i vari elementi di formattazione (descrizioni, riquadro di warning, esempio ecc.): la guida risulterà più leggibile. | # Usate, quando necessario, i vari elementi di formattazione (descrizioni, riquadro di warning, esempio ecc.): la guida risulterà più leggibile. | ||