Aiuto:Prima di iniziare: differenze tra le versioni
S3v (discussione | contributi) (+ consigli grammaticali) |
S3v (discussione | contributi) Nessun oggetto della modifica |
||
| Riga 1: | Riga 1: | ||
{{Stub | {{Stub}} | ||
Prima di iniziare a scrivere o modificare una guida, è opportuno conoscere poche e semplici convenzioni in modo che il contenuto del Wiki cresca in maniera omogenea e quindi più facile da leggere, per tutti.<br/> | |||
Queste convenzioni riguardano la struttura delle pagine e dell'intero Wiki: se avete dubbi o domande potete utilizzare la pagina di [[Aiuto:Discussioni | discussione]] relativa a ciascuna guida oppure aprire una discussione sul [http://forum.debianizzati.org forum] nella sezione ""Guide@Debianizzati.Org". | |||
{{Help}} | |||
=== Versioni compatibili === | === Versioni compatibili === | ||
Il [[Aiuto:I template|template]] "Versioni compatibili" va inserito all'inizio di ciascuna pagina affinché si capisca immediatamente a quali versioni di Debian fa riferimento la guida in oggetto. Consultare [[Template:Versioni compatibili|questa pagina]] per ottenere istruzioni specifiche sul suo utilizzo. | |||
=== Categorie === | === Categorie === | ||
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. | 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 [[Aiuto:Categorie| categoria]] di cui la guida andrà a far parte. | ||
=== Convenzioni sulla sintassi === | === Convenzioni sulla sintassi === | ||
# 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>). | # 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 [[Aiuto:Sintassi#Formattazione di codice|<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. | # 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 [[Aiuto:Sintassi#Formattazione di testo|<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 [[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 | # Usate, quando necessario, i vari 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. | # 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 [[Aiuto:Sintassi#Link|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. | ||
| Riga 32: | Riga 32: | ||
* '''Stub''': una guida è in questo stato se è ancora incompleta. Queste guide sono caratterizzate dal [[Template:Stub|seguente box]] iniziale. | * '''Stub''': una guida è in questo stato se è ancora incompleta. Queste guide sono caratterizzate dal [[Template:Stub|seguente box]] iniziale. | ||
* '''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à. | * '''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à. | ||
* '''Guida Debianized''': è il terzo e ultimo livello raggiungibile da una guida sul Wiki. Una guida di questo tipo ha raggiunto la sua piena maturità essendo stata verificata e corretta anche da più di una persona nella community. Nell'indice le guide '''Debianized''' sono facilmente individuabili da una swirl: [[Image:swirl.png|link=]]. Tutte le guide sul Wiki possono diventare [[Debianized]] una volta ricevuto un sufficiente feedback dalla comunità. | * '''Guida Debianized''': è il terzo e ultimo livello raggiungibile da una guida sul Wiki. Una guida di questo tipo ha raggiunto la sua piena maturità essendo stata verificata e corretta anche da più di una persona nella community. Nell'indice le guide '''Debianized''' sono facilmente individuabili da una swirl: [[Image:swirl.png|link=]]. Tutte le guide sul Wiki possono diventare [[Debianized]] una volta ricevuto un sufficiente feedback dalla 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. | 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. | ||
Con questi piccoli accorgimenti che richiedono un piccolo aiuto da parte della community, speriamo di poter '''tracciare''' e '''mantenere''' lo "stato di salute" delle guide, sperando che un numero sempre maggiore di esse diventi [[Debianized]] ;-). | Con questi piccoli accorgimenti che richiedono un piccolo aiuto da parte della community, speriamo di poter '''tracciare''' e '''mantenere''' lo "stato di salute" delle guide, sperando che un numero sempre maggiore di esse diventi [[Debianized]] ;-). | ||
== Pagine protette == | == Pagine protette == | ||
[[Speciale:PagineProtette|Alcune pagine]] del | [[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 riguardante Debian GNU/Linux verrà resa protetta. Se trovate una pagina di documentazione protetta, per favore, segnalatelo agli amministratori. | ||
== Consigli grammaticali == | == Consigli grammaticali == | ||
Prima di salvare una guida, è consigliato controllare la presenza di eventuali errori grammaticali o | Prima di salvare una guida, è consigliato controllare la presenza di eventuali errori grammaticali o sintattici. 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/> | ||
Di seguito vengono riportati gli errori grammaticali più comuni che possono essere commessi quando si scrive una guida. | Di seguito vengono riportati gli errori grammaticali più comuni che possono essere commessi quando si scrive una guida. | ||
# <u>Uso della punteggiatura</u> <blockquote>Tutti i segni di interpunzione (virgola, punto, punto e virgola, punto esclamativo, ecc.) seguono direttamente la parola che li precede, senza spazi, e vanno separati dalla parola successiva con uno spazio. Non fanno eccezione i punti alla fine di un periodo. Es. <code>"L'italiano, il francese e lo spagnolo sono lingue neo-latine."</code><br/>[...]<br/>Le parentesi di apertura hanno uno spazio che le precede mentre la parola successiva è attaccata ad esse. Il contrario è normalmente vero per le parentesi di chiusura, mentre non va messo alcuno spazio tra queste ed eventuali segni di punteggiatura. Es. <code>"Esempio (dell'uso) di parentesi."</code> In particolare, la punteggiatura del testo circostante non va inserita all'interno delle parentesi ma va posta dopo la parentesi di chiusura. Es. <code>"Altro esempio (dell'uso di parentesi)." </code></blockquote> | # <u>Uso della punteggiatura</u> <blockquote>Tutti i segni di interpunzione (virgola, punto, punto e virgola, punto esclamativo, ecc.) seguono direttamente la parola che li precede, senza spazi, e vanno separati dalla parola successiva con uno spazio. Non fanno eccezione i punti alla fine di un periodo. Es. <code>"L'italiano, il francese e lo spagnolo sono lingue neo-latine."</code><br/>[...]<br/>Le parentesi di apertura hanno uno spazio che le precede mentre la parola successiva è attaccata ad esse. Il contrario è normalmente vero per le parentesi di chiusura, mentre non va messo alcuno spazio tra queste ed eventuali segni di punteggiatura. Es. <code>"Esempio (dell'uso) di parentesi."</code> In particolare, la punteggiatura del testo circostante non va inserita all'interno delle parentesi ma va posta dopo la parentesi di chiusura. Es. <code>"Altro esempio (dell'uso di parentesi)." </code></blockquote> | ||
#<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>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.<br/>Ricorrere, inoltre, alla lettera maiuscola iniziale per le parole facenti parte della terminologia tecnica che si riferiscono a programmi, sistemi operativi o kernel (Debian, Linux, Samba, Wheezy, etc.) </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>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 ("é"): " | ||
#<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> | 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, PC, 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> | |||
Leggere anche [http://tp.linux.it/buona_traduzione.html Regole per la buona traduzione], a cura di E.Aina | Leggere anche [http://tp.linux.it/buona_traduzione.html Regole per la buona traduzione], a cura di E.Aina | ||
Versione delle 09:45, 14 ago 2013
|
Attenzione: questo articolo è ancora incompleto e in fase di scrittura da parte del suo autore.
Sentitevi liberi di contribuire, proponendo modifiche alla guida tramite l'apposita pagina di discussione, in modo da non interferire con il lavoro portato avanti sulla voce. Per altre informazioni si rimanda al template. |
Prima di iniziare a scrivere o modificare una guida, è opportuno conoscere poche e semplici convenzioni in modo che il contenuto del Wiki cresca in maniera omogenea e quindi più facile da leggere, per tutti.
Queste convenzioni riguardano la struttura delle pagine e dell'intero Wiki: se avete dubbi o domande potete utilizzare la pagina di discussione relativa a ciascuna guida oppure aprire una discussione sul forum nella sezione ""Guide@Debianizzati.Org".
| Linee guida su come contribuire al Wiki |
|
Sommario |
Versioni compatibili
Il template "Versioni compatibili" va inserito all'inizio di ciascuna pagina affinché si capisca immediatamente a quali versioni di Debian fa riferimento la guida in oggetto. Consultare questa pagina per ottenere istruzioni specifiche sul suo utilizzo.
Categorie
Ciascuna guida deve far parte di 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 [[Categoria: nome_della_categoria]] per ciascuna categoria di cui la guida andrà a far parte.
Convenzioni sulla sintassi
- 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 <pre> e </pre>).
- Se riportate un comando usate come primo carattere
$se il comando deve essere lanciato da utente normale e#se il comando deve essere lanciato da root. Lasciate anche uno spazio dopo questo carattere, in modo che il comando non risulti attaccato al$o#e quindi poco leggibile. - Quando dovete inserire all'interno del corpo del testo i seguenti elementi:
- percorsi di file o cartelle;
- nomi di file;
- comandi, opzioni di comandi, singole stringhe e/o direttive dei file di configurazione;
- racchiudeteli tra i tag <code> e </code>.
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.
- Usate, quando necessario, i vari 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
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..
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.
Evoluzione delle guide
Le guide su seguono un percorso (idealmente) simile a quello seguito dai pacchetti Debian nelle tre distribuzioni. Si distinguono infatti tre fasi per una guida:
- Stub: una guida è in questo stato se è ancora incompleta. Queste guide sono caratterizzate dal seguente box iniziale.
- 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à.
- Guida Debianized: è il terzo e ultimo livello raggiungibile da una guida sul Wiki. Una guida di questo tipo ha raggiunto la sua piena maturità essendo stata verificata e corretta anche da più di una persona nella community. Nell'indice le guide Debianized sono facilmente individuabili da una swirl:
. Tutte le guide sul Wiki possono diventare Debianized una volta ricevuto un sufficiente feedback dalla comunità.
Se leggi una guida e verifichi la sua correttezza, utilizza per favore il template Autori in modo da tenere traccia della maturità della guida.
Con questi piccoli accorgimenti che richiedono un piccolo aiuto da parte della community, speriamo di poter tracciare e mantenere lo "stato di salute" delle guide, sperando che un numero sempre maggiore di esse diventi Debianized ;-).
Pagine protette
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 riguardante Debian GNU/Linux verrà resa protetta. Se trovate una pagina di documentazione protetta, per favore, segnalatelo agli amministratori.
Consigli grammaticali
Prima di salvare una guida, è consigliato controllare la presenza di eventuali errori grammaticali o sintattici. Questo può essere fatto, ad esempio, sfruttando anche il controllo ortografico presente all'interno di molti editor o del browser che si sta utilizzando.
Di seguito vengono riportati gli errori grammaticali più comuni che possono essere commessi quando si scrive una guida.
- Uso della punteggiatura
Tutti i segni di interpunzione (virgola, punto, punto e virgola, punto esclamativo, ecc.) seguono direttamente la parola che li precede, senza spazi, e vanno separati dalla parola successiva con uno spazio. Non fanno eccezione i punti alla fine di un periodo. Es.
"L'italiano, il francese e lo spagnolo sono lingue neo-latine."
[...]
Le parentesi di apertura hanno uno spazio che le precede mentre la parola successiva è attaccata ad esse. Il contrario è normalmente vero per le parentesi di chiusura, mentre non va messo alcuno spazio tra queste ed eventuali segni di punteggiatura. Es."Esempio (dell'uso) di parentesi."In particolare, la punteggiatura del testo circostante non va inserita all'interno delle parentesi ma va posta dopo la parentesi di chiusura. Es."Altro esempio (dell'uso di parentesi)." - Uso delle maiuscole
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.
Ricorrere, inoltre, alla lettera maiuscola iniziale per le parole facenti parte della terminologia tecnica che si riferiscono a programmi, sistemi operativi o kernel (Debian, Linux, Samba, Wheezy, etc.) - Accenti
È 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.
Nell'ambiente X11 usato sui sistemi UNIX, le maiuscole accentate sono ottenibili usando il tasto BlocMaiusc insieme agli stessi tasti usati per le minuscole.
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".
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é".
- Acronimi
Gli acronimi e gli acrostici vanno scritti in maiuscolo (GNU, USB, BIOS, PC, DVD, KDE, etc.) in quanto sono parole costituite da iniziali di altre parole o frasi.
Prestare attenzione soprattutto quando li si utilizzano all'interno dei titoli di una guida.
Leggere anche Regole per la buona traduzione, a cura di E.Aina