6 999
contributi
Aiuto:Linee guida su come contribuire al Wiki: differenze tra le versioni
Aiuto:Linee guida su come contribuire al Wiki (visualizza wikitesto)
Versione delle 20:40, 8 nov 2012
, 8 nov 2012nessun oggetto della modifica
S3v (discussione | contributi) |
S3v (discussione | contributi) mNessun oggetto della modifica |
||
| Riga 12: | Riga 12: | ||
# Se riportate un comando usate come primo carattere <code>$</code> se il comando deve essere lanciato da utente normale e <code>#</code> se il comando deve essere lanciato da root. Lasciate anche uno spazio dopo questo carattere, in modo che il comando non risulti attaccato al <code>$</code> o <code>#</code> e quindi poco leggibile. | # Se riportate un comando usate come primo carattere <code>$</code> se il comando deve essere lanciato da utente normale e <code>#</code> se il comando deve essere lanciato da root. Lasciate anche uno spazio dopo questo carattere, in modo che il comando non risulti attaccato al <code>$</code> o <code>#</code> e quindi poco leggibile. | ||
# Quando dovete inserire all'interno del corpo del testo i seguenti elementi: | # Quando dovete inserire all'interno del corpo del testo i seguenti elementi: | ||
* percorsi di file o cartelle; | #* percorsi di file o cartelle; | ||
* nomi di file; | #* nomi di file; | ||
* 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 <nowiki><code></nowiki> e <nowiki></code></nowiki>. | racchiudeteli tra i tag <nowiki><code></nowiki> e <nowiki></code></nowiki>. | ||
=== Convenzioni sullo stile === | === Convenzioni sullo stile === | ||
# Dividete in maniera logica la guida in sezioni, sottosezioni (e, se necessario sotto-sottosezioni). In questo modo si sfrutterà meglio la potenza di MediaWiki che creerà automaticamente un indice iniziale che renderà molto più facile la navigazione nella vostra guida. | # Dividete in maniera logica la guida in sezioni, sottosezioni (e, se necessario sotto-sottosezioni). In questo modo si sfrutterà meglio la potenza di MediaWiki che creerà automaticamente un indice iniziale che renderà molto più facile la navigazione nella vostra guida. | ||
# Usate, quando necessario, i vari [[Help:Editing|elementi di formattazione]] (descrizioni, riquadro di warning, esempio ecc.): la guida risulterà più leggibile. | |||
# Cercate di rendere leggibile e pulito il codice della pagina, evitando ad esempio di lasciare tante righe vuote consecutive. | |||
=== Interconnessione dei contenuti === | === Interconnessione dei contenuti === | ||
Cercate il più possibile di inserire link ad altre pagine del Wiki, in modo da aumentare le interconnessioni, rendere più facile la ricerca delle informazioni ed evitare inutili ripetizioni in più di una guida..<br/> | Cercate il più possibile di inserire link ad altre pagine del Wiki, in modo da aumentare le interconnessioni, rendere più facile la ricerca delle informazioni ed evitare inutili ripetizioni in più di una guida..<br/> | ||
Non è necessario che le pagine verso cui si creano i link debbano esistere (in questo caso il link resterà di colore rosso); la loro creazione può essere successiva da parte dello stesso autore o di altri. In entrambi i casi la presenza di link ad altri contenuti del Wiki renderà la guida stessa più completa e leggibile. | Non è necessario che le pagine verso cui si creano i link debbano esistere (in questo caso il link resterà di colore rosso); la loro creazione può essere successiva da parte dello stesso autore o di altri. In entrambi i casi la presenza di link ad altri contenuti del Wiki renderà la guida stessa più completa e leggibile. | ||