Aiuto:Convenzioni di nomenclatura

Da Esopedia, l'Enciclopedia dell'[[Ordine Martinista Antico e Tradizionale|O.M.A.T.]] per gli Iniziati.

Template:Abbreviazione

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.

Questa è la politica corretta ed accettata dalla comunità, che va applicata. Linee guida per il nome dei libri

  1. I nomi dei libri non devono avere le iniziali maiuscole, al contrario dei libri inglesi. Per esempio: [[Chimica generale]] è preferibile a [[Chimica Generale]].
  2. 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]].
  3. 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.

Questa è la politica corretta ed accettata dalla comunità, che va applicata. Linee guida per il nome dei moduli

Per organizzare il libro in più capitoli (moduli) è sufficiente creare delle sottopagine della pagina del libro, seguendo le opportune convenzioni.

Sottopaginazione

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

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]]
    • Frutta
      • [[Forme di vita/Mela]]
      • [[Forme di vita/Arancia]]
      • [[Forme di vita/Pomodoro]]

Dare il nome ai moduli

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

Questa è la politica corretta ed accettata dalla comunità, che va applicata. Nomi per template di navigazione e categorie

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.

Questa politica è obsoleta e deprecata. Non applicarla. Altre strutture

Queste strutture non vanno usate nei nuovi libri.

Struttura gerarchica

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

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

Vecchi titoli

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 Esopedia
  • La convenzione dei due punti "tipografici" con spazio: [[Libro: Capitolo]]
  • [[Libro / Capitolo]]
  • La convenzione "nessun separatore": [[Libro Capitolo]]
  • La convenzione "Esopedia": [[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

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.

Pagine correlate