Aiuto:Convenzioni di nomenclatura
| Come scrivere un libro
Organizzare le pagine: Convenzioni di nomenclatura · Moduli e sottopagine · Categorie · Markup Pagina principale del libro: Libri correlati · Bibliografia · Altri progetti · Collegamenti esterni · Categorizzazione tematica · Classificazione Dewey · Categorizzazione alfabetica Migliorare la qualità: Fasi di sviluppo · Copertina · Indice di navigazione · Indicizzazione · Versione stampabile · Bollettino · Esercizi Altre convenzioni: Manuale di stile · Convenzioni linguistiche · Testi commentati (modello per romanzi) · Realizzare un libro con le voci di Wikipedia · Inserire trame e formule chimiche · Tradurre un libro |
Questa pagina tratta delle convenzioni di nomenclatura, cioè come organizzare la struttura di un libro in sottopagine.
È molto importante seguire queste norme per assicurare un certo ordine all'interno di Wikibooks.
Linee guida per il nome dei libri
[modifica | modifica sorgente]
- I nomi dei libri non devono avere le iniziali maiuscole, al contrario dei libri inglesi. Per esempio: [[Chimica generale]] è preferibile a [[Chimica Generale]].
- Non abbreviare il titolo del libro quando si creano le sottopagine. Questo non permette il corretto funzionamento del sistema di sottopagine di Wikiboooks. Per esempio, nel libro Inglese c'è una sottopagina [[Inglese/Il Simple Past]], ma sarebbe sbagliato crearne una così: [[Ing/Il Simple past]].
- Sii breve e descrittivo: [[C]] è preferibile a [[Linguaggio C]], a [[Programmare in C]], oppure a [[Programmare nel linguaggio C]]. Non usare però nomi troppo generici o vaghi per i libri: ognuno deve avere un nome univoco che ne renda facile l'identificazione.
Linee guida per il nome dei moduli
[modifica | modifica sorgente]Per organizzare il libro in più capitoli (moduli) è sufficiente creare delle sottopagine della pagina del libro, seguendo le opportune convenzioni.
Sottopaginazione
[modifica | modifica sorgente]Questa convenzione è obbligatoria per i nuovi libri.
I moduli vanno sottopaginati usando il segno di slash (/) e con un solo livello di sottopaginazione.
Il vantaggio nell'usare questa sintassi è che il software MediaWiki fornisce il link alle pagine di livello superiore, agevolando la navigazione.
[[Forme di vita]][[Forme di vita/Umano]][[Forme di vita/Cane]][[Forme di vita/Gatto]][[Forme di vita/Farfalla]][[Forme di vita/Mela]][[Forme di vita/Arancia]][[Forme di vita/Pomodoro]]
etc...
Ottenere una gerarchia
[modifica | modifica sorgente]Ma con un solo livello di sottopaginazione non posso creare una vera gerarchia! Come faccio?
Puoi ottenere una gerarchia usando elenchi nidificati nella pagina principale del libro, ma non nidificando le pagine. In questo modo si è liberi di riorganizzare le pagine come si meglio crede, dato che la gerarchia è solo apparente.
Ad esempio:
- Contenuti
- Forme di vita
- Animali
- Mammiferi
[[Forme di vita/Umano]][[Forme di vita/Gatto]][[Forme di vita/Gatto]]
- Insetti
[[Forme di vita/Farfalla]]
- Mammiferi
- Frutta
[[Forme di vita/Mela]][[Forme di vita/Arancia]][[Forme di vita/Pomodoro]]
- Animali
Dare il nome ai moduli
[modifica | modifica sorgente]Ricorda che il titolo del libro e dei suoi moduli apparirà e dovrà essere digitato nella barra dell'URL di un browser: scegli dei nomi brevi.
Idealmente, il nome di un modulo dovrebbe essere formato da una parola sola, ma non sempre ciò è possibile. In ogni caso, cerca di essere il più sintetico possibile, senza però che questo vada a discapito della chiarezza.
Per convenzione, i nomi dei moduli iniziano sempre con una lettera maiuscola.
Ad esempio,
[[Forme di vita]][[Forme di vita/Umano]][[Forme di vita/Cane]][[Forme di vita/Gatto]][[Forme di vita/Farfalla]][[Forme di vita/Mela]][[Forme di vita/Arancia]][[Forme di vita/Pomodoro]]
è meglio di:
[[Forme di vita]][[Forme di vita/l'umano]][[Forme di vita/il cane]][[Forme di vita/il gatto]][[Forme di vita/la farfalla]][[Forme di vita/la mela]][[Forme di vita/l'arancia]][[Forme di vita/il pomodoro]]
Esempi
[modifica | modifica sorgente] Nomi per template di navigazione e categorie
[modifica | modifica sorgente]Per un libro chiamato Book, il template di navigazione si chiamerà Template:Book e la categoria che raccoglie tutte le sue pagine si chiamerà Categoria:Book. Per esempio, Categoria:C e Template:C sono dedicati al libro C.
Questo metodo ha il vantaggio di poter sapere subito quali sono i nomi del template e della categoria associati ad un determinato libro.
Altre strutture
[modifica | modifica sorgente]
Queste strutture non vanno usate nei nuovi libri.
Struttura gerarchica
[modifica | modifica sorgente]Questa struttura è deprecata. Non usarla nei nuovi libri.
Questa struttura è usata in alcuni libri di Wikibooks, che sono stati creati prima di questa politica. In realtà ancora oggi viene consentita la creazione di questo tipi di libri, sopratutto nel caso di libri donati o "importati" da fonti esterne che hanno già un'organizzazione pensata correttamente.
Ecco un esempio di questa struttura:
[[Forme di vita]][[Forme di vita/Animali]][[Forme di vita/Animali/Mammiferi]][[Forme di vita/Animali/Mammiferi/Umano]][[Forme di vita/Animali/Mammiferi/Cane]][[Forme di vita/Animali/Mammiferi/Gatto]]
[[Forme di vita/Animali/Insetti]][[Forme di vita/Animali/Insetti/Farfalla]]
[[Forme di vita/Frutti]][[Forme di vita/Frutti/Mela]][[Forme di vita/Frutti/Arancia]][[Forme di vita/Frutti/Pomodoro]]
Perché la convenzione flat è preferibile a quella gerarchica
[modifica | modifica sorgente]Perché è difficoltoso aggiungere nuove ramificazioni: alcune pagine probabilmente andranno spostate.
Ad esempio, se avessi voluto aggiungere una ramificazione Piante all'esempio precedente, avrei dovuto spostare [[Forme di vita/Frutti]] in [[Forme di vita/Piante/Frutti]] e così anche per tutte le sue sottopagine.
Questa struttura può rivelarsi utile per libri con tante pagine per mantenere ordine, ma in ogni caso non ti spingere oltre il terzo livello di sottopaginazione.
Esempi
[modifica | modifica sorgente]Vecchi titoli
[modifica | modifica sorgente]Queste strutture sono deprecate. Non usarle nei nuovi libri.
Se trovi libri organizzati in questo modo, sposta le pagine in modo da seguire la convenzione con lo slash. A volte i libri presenti su altri Wikibooks seguono queste nomenclature; se li traduci, abbi cura di convertirne i titoli:
- La convenzione con i due punti
[[Libro:Capitolo]] - La convenzione del trattino:
[[Libro - Capitolo]] - La convenzione della disambigua:
[[Capitolo (Libro)]], chiamata così per le pagine di disambigua di Wikipedia - La convenzione dei due punti "tipografici" con spazio:
[[Libro: Capitolo]] [[Libro / Capitolo]]- La convenzione "nessun separatore":
[[Libro Capitolo]] - La convenzione "Wikipedia":
[[Capitolo]], dove non si nomina il nome del libro; tali pagine vanno contrassegnate con il {{Da collocare}} - La convenzione "scaffale":
[[Scaffale:Libro]], come [[Programmazione:C]], [[Programmazione:Java]], [[Programmazione:Pascal]] etc...
Alcuni trucchi
[modifica | modifica sorgente]Per effettuare i collegamenti alle sottopagine semplicemente usando la sintassi:
[[/Nome modulo/]]
Ad esempio, se si inserisce [[/Introduzione/]] nella pagina [[Pascal]], si otterrà un link alla pagina Pascal/Introduzione come se fosse stato scritto: [[Pascal/Introduzione|Introduzione]], con questo risultato: Introduzione.