Aiuto:Prima di iniziare: differenze tra le versioni

{{Stub}}{{Help}}

Ci sono delle semplici convenzioni da rispettare in modo che il contenuto del Wiki cresca in maniera omogenea e quindi più facile da leggere, per tutti.

 

Inserite, all'inizio di ogni guida, il template [[Template:Versioni compatibili|Versioni compatibili]], che permette di capire immediatamente a quali versioni di Debian fa riferimento la guida in oggetto. Per le istruzioni specifiche su come inserire questo template si veda la pagina [[Usare_i_Template#Template_Versioni_compatibili|Usare i Template]].

Ciascuna guida deve far parte di [[Lista Categorie|una o più categorie]] per essere indicizzata e permetterne una più facile ricerca e individuazione. Ricordarsi pertanto di inserire, in fondo alla guida, il tag ''<nowiki>[[Categoria: nome_della_categoria]]</nowiki>'' per ciascuna categoria di cui la guida andrà a far parte.

# Tutte le volte che riportate l'output di un comando, un pezzo di un file di configurazione, o in genere dei dati ASCII, racchiudeteli in un riquadro (racchiudendo tra <nowiki><pre></nowiki> e <nowiki></pre></nowiki>).

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

:racchiudeteli tra i tag <nowiki><code></nowiki> e <nowiki></code></nowiki>.

# 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 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/>

* '''Guida completa''': la guida è ragionevolmente completa e può essere usata per conoscere nuovi argomenti. Le guide di questo tipo non hanno nessun segno particolare. Le guide complete sono state terminate dall'autore iniziale e cercano una sorta di testing da parte della comunità.  

Se leggi una guida e verifichi la sua correttezza, utilizza per favore il template [[Template:Autori | Autori]] in modo da tenere traccia della maturità della guida.  

[[Speciale:PagineProtette|Alcune pagine]] del wiki sono protette, cioè un normale utente non può modificarle anche se registrato. Le pagine protette sono pagine di presentazione del progetto, pagine di licenza o pagine tecniche del Wiki. In nessun caso un articolo di documentazione riguardate Debian GNU/Linux verrà resa protetta. Se trovate una pagina di documentazione protetta, per favore, segnalatelo agli amministratori.

Prima di salvare una guida, è consigliato controllare la presenza di eventuali errori grammaticali o ortografici. Questo può essere fatto, ad esempio, sfruttando anche il controllo ortografico presente all'interno di molti editor o del browser che si sta utilizzando.<br/>

#<u>Uso delle maiuscole</u> <blockquote>Mentre in inglese è convenzione porre tutte le lettere iniziali delle parole componenti un titolo in maiuscolo, in italiano ciò è considerato errore, in quanto solo la prima parola usa l'iniziale maiuscola.</blockquote>

#<u>Accenti</u><blockquote>È da considerarsi errore l'uso di una vocale seguita da un apostrofo «'» o da un apice inverso «`» per simboleggiare una vocale accentata. Se la codifica lo consente, vanno sempre impiegati i simboli appositi, sia per le minuscole che per le maiuscole.<br/>Nell'ambiente X11 usato sui sistemi UNIX, le maiuscole accentate sono ottenibili usando il tasto BlocMaiusc insieme agli stessi tasti usati per le minuscole.<br/>Le vocali "a", "i" e "u" possiedono solo una possibile pronuncia e quindi vanno sempre poste con l'accento grave ("à", "ì", "ù"). La vocale "o", invece, può essere sia aperta che chiusa ma, poiché non esistono parole tronche che terminano per "o" chiusa, l'accento alla fine della parola è sempre grave ("ò"). In generale, è convenzione comune in editoria utilizzare esclusivamente l'accento grave sulle vocali "a", "i", "o" e "u".<br/>Per la vocale "e" la situazione è più complicata: normalmente va usato l'accento grave ("è") ma in alcuni casi va usato quello acuto ("é"): "perché", "affinché", "poiché" (in generale tutti i vocaboli che terminano in "ché"), "né", "sé".</blockquote>

#<u>Acronimi</u><blockquote>Gli acronimi e gli acrostici vanno scritti in maiuscolo (GNU, USB, BIOS, DVD, KDE, etc.) in quanto sono parole costituite da iniziali di altre parole o frasi.<br/>Prestare attenzione soprattutto quando li si utilizzano all'interno dei titoli di una guida.</blockquote>