Aiuto:Come scrivere un libro

Wikibooks, manuali e libri di testo liberi.
(Reindirizzamento da Aiuto:Libro)


Questa pagina raccoglie e riassume tutte le convenzioni per la buona organizzazione e formattazione di un wikilibro. Prima di iniziare a scrivere un libro è calorosamente consigliata la lettura di questa pagina e dei diversi approfondimenti.

In sintesi[modifica]

Questi sono i passi minimi necessari per iniziare un nuovo libro.

Passo Istruzioni
Il libro esiste già? Lo lascerai incompiuto? → Sicuro di voler contribuire?
Scegli il titolo e fatti un'idea degli argomenti da trattare. → Aiuto:Convenzioni di nomenclatura
Crea la pagina principale del libro. Aggiungi un link nel ripiano più adatto, in Wikibooks:Biblioteca. → La pagina principale del libro
Crea la categoria del libro e il template sommario. → Categorizzare il libro

→ Indice verticale

Scrivi una pagina per ogni capitolo, dal titolo: "Nome del libro/Nome del capitolo". Metti il link nel template sommario.

In cima ad ognuna, anche nella pagina principale, aggiungi le righe

{{Nome libro}}

[[Categoria:Nome libro]]
{{avanzamento|50%}}
sostituendo 50% con un valore tra 0% - 25% - 50% - 75% - 100% in base al testo.

Questi passi arricchiscono il libro con caratteristiche aggiuntive.

Passo Istruzioni
Crea una copertina. → La copertina
Altre caratteristiche: versione PDF, prefazione, bollettino, esercizi. → Caratteristiche aggiuntive

Nuvola apps emacs.png Sicuro di voler contribuire?[modifica]

Searchtool.svg Per approfondire, vedi Wikibooks:Perché contribuire ad un libro di testo open source e Aiuto:Libro abbandonato.

Uno dei problemi più gravi di Wikibooks è l'abbandono di un libro da parte degli autori originali, quando il libro è solo uno abbozzo o è ancora incompleto. Pertanto, dopo aver appurato che non esiste già un libro sull'argomento che vuoi scrivere, è il caso di valutare se riuscirai a svilupparne una buona parte, e non abbandonare il lavoro subito dopo avere cominciato.

Se non puoi o non vuoi dedicare a Wikibooks il tempo di portare a buon punto lo sviluppo del libro, puoi

  • contribuire ai libri già iniziati, per i quali è possibile contribuire mantenendo un'unità stilistica e contenutistica: consulta i libri abbandonati, i libri fermi a metà e o libri quasi completati;
  • salvare le pagine singole nel Deposito di Wikibooks. Ogni pagina deve essere completa, pena la cancellazione dal deposito. Quando ci sarà materiale a sufficienza, tu o un altro utente potrete mettere insieme i capitoli per creare un nuovo libro, oppure integrarli in un libro che qualcun altro avrà iniziato nel frattempo.

Gtk-ok.svg Il libro è un vero wikibook?[modifica]

Searchtool.svg Per approfondire, vedi Wikibooks:Cosa mettere su Wikibooks e Wikibooks:Cosa non mettere su Wikibooks.

Per capire se il libro che intendi lasciare alla comunità è adatto a Wikibooks, ecco alcune indicazioni:

  • Su Wikibooks non accettiamo libri di narrativa, ma solo libri di testo o manuali con scopi didattici e divulgativi.
  • Wikibooks è un posto dove i libri vengono sviluppati dalla comunità: ogni libro può essere riscritto, migliorato da altri e i suoi capitoli possono essere riordinati, aggiunti o cancellati. I libri originali i cui autori sono deceduti da più di settant'anni vanno pubblicati su Wikisource.
  • Guarda, per rendertene conto, la lista dei libri disponibili su Wikibooks. Ogni libro deve soddisfare le indicazioni della pagina Cosa mettere su Wikibooks.

Gnome-lockscreen.svg Il libro esiste?[modifica]

Continuare un libro già impostato, è più rapido che ricominciare il libro da capo.

  • Fai una ricerca per vedere se il libro che ti interessa esiste già.
  • Prova a controllare i ripiani per vedere se ne esiste uno simile.

Emblem-fun.svg Seguirai il libro?[modifica]

Ci sono numerosi libri che hanno un'ottima introduzione, ma non hanno seguito perché i loro autori non sono riusciti a proseguire (altri impegni, imprevisti ecc...ecc...). L'ideale è che tu possa contribuire al libro abbastanza da trattare tutti i suoi argomenti o almeno per la sua gran parte.

Crystal Clear app package settings.png Sii coraggioso (be bold)! Si comincia[modifica]

Se le tue risposte alle domande precedenti sono state: sì, sì, no, sì; prosegui nella lettura.

Probabilmente nella stesura di un wikilibro necessiterai della mano di altri wikilibrai, tieni a mente che il tuo lavoro non è propriamente tuo, bensì della comunità, a cui ognuno può contribuire. Tuttavia, se vuoi essere giudicato il maggior contributore di un libro, puoi dedicarti a tre fasi essenziali nella stesura di un libro: propositi del libro, descrizione del contenuto, struttura (o layout). Far sì che un libro abbia queste tre componenti facilita il lavoro degli altri wikibookiani, ed evita inutili diatribe su ciò che dovrebbe o non dovrebbe essere il libro.

Presa coscienza dell'importanza di queste tre fasi, bisogna riflettere un po' prima di pubblicare un libro:

  • Che tipo di libro è? Manuale, consultazione, didattico ecc...
  • Qual è il livello di difficoltà del libro? Semplice, intermedio, difficile ecc...
  • Quali sono i propositi del libro? Da cosa deve cominciare, dove deve terminare, quali sono i contenuti?

Scrivi queste informazioni all'inizio di ogni libro, di modo che, chiunque possa decidere se quello è il libro che vogliono leggere o cui vogliono contribuire.

Volendo, soprattutto nel caso di libri che richiedono un'organizzazione più complessa, è possibile inserire nella pagina di discussione del libro delle informazioni approfondite riguardo le linee guida della stesura del libro (convenzioni, organizzazione, finalità).

Crystal Clear app fonts.png Il titolo[modifica]

Searchtool.svg Per approfondire, vedi Aiuto:Convenzioni di nomenclatura.

Un titolo deve essere allo stesso tempo breve ed esplicativo: deve essere abbastanza chiaro da distinguere il libro da qualunque altro, e non deve essere troppo lungo per comodità di chi lo digiterà nella barra degli URL.

Questo significa che deve essere scritto in italiano, utilizzando correttamente gli spazi dove serve, usando nomi brevi e concisi: se vuoi scrivere un libro sul linguaggio HTML, non chiamarlo Impara l'HTML, Guida all'HTML o L'HTML: scopri le potenzialità del web, ma solo HTML. Questo serve anche perché un utente sia indirizzato direttamente sul libro quando digita "HTML" nella casella di ricerca.

Anche i nomi dei corsi di lingua devono essere brevi e concisi: evita nomi come Corso di russo o Corso di esperanto, preferisci piuttosto Russo o Esperanto.

Come ultima cosa, ricorda che i nomi dei libri devono avere la prima lettera maiuscola e tutte le altre minuscole (a meno che non si tratti di acronimi o nomi propri): vedi per caso la "A" maiuscola in Intelligenza artificiale?

Inkscape.svg La copertina[modifica]

Searchtool.svg Per approfondire, vedi Aiuto:Copertina.

Come ogni libro che si rispetti, anche un libro necessita della sua copertina. Per crearla è sufficiente creare una sottopagina in questo modo: Nome libro/Copertina.

La copertina deve contenere nell'ordine:

  • Titolo
    • Sottotitolo (se necessario)
  • Immagine esplicativa (per un libro sui PC, ad esempio, l'immagine di un computer)
  • Link al sommario del libro
  • Link allo sviluppo del libro

Nella pagina principale del libro, il collegamento alla copertina va prima del sommario. I link nei ripiani devono necessariamente puntare alla copertina se essa è esistente.

Per realizzare copertine efficaci senza troppe difficoltà, vi invitiamo ad utilizzare il {{Copertina}}.

Organizzazione del libro[modifica]

L'immagine mostra la struttura di Wikibooks; il libro e il modulo sono nella punta: il modulo contiene i contenuti veri e propri del libro
Searchtool.svg Per approfondire, vedi Aiuto:Convenzioni di nomenclatura.

Se un libro è abbastanza breve, è possibile utilizzare una sola pagina per tutto il contenuto. Se invece è più esteso, è necessario dividere il testo in sottopagine (i moduli) seguendo le convenzioni di nomenclatura.

La pagina principale del libro[modifica]

Searchtool.svg Per approfondire, vedi Wikibooks:Categorie#Categorizzare_un_libro.

La pagina principale del libro (ad esempio HTML) deve contenere una breve introduzione sull'argomento, indicare le finalità del wikibook, contenere un sommario (preferibilmente sotto forma di indice di navigazione).
In fondo vanno poi inserite le sezioni predefinite, se presenti, in questo ordine:

Nei libri di una sola pagina, invece, il contenuto deve stare tutto nella pagina principale del libro (vedi ad esempio il libro Consultare l'Orario Ferroviario), che deve però contenere comunque un link alla copertina.

La pagina principale deve poi contenere le categorizzazione tematica (ad esempio [[Categoria:Linguaggi di programmazione]]) e la categorizzazione alfabetica tramite l'uso del template {{alfabetico|lettera}}.

Dato che il libro è in costante espansione, si consiglia di apporre il template {{Aggiorna}} nelle sezioni in cui sono descritti gli aspetti variabili del wikibook (esempio).

Gedit.svg Sommario[modifica]

Per scrivere un sommario, è sufficiente creare una lista di capitoli utilizzando il template {{modulo}} preceduto dal segno #, in modo da ottenere automaticamente un elenco numerato. Ai sottocapitoli è necessario far precedere i segni #* in modo da ottenere un quadratino davanti a ogni sottocapitolo:

Come viene visualizzato Come si scrive
  1. Primo capitoloNome libro/Primo capitolo
    • Primo sottocapitolo
    • Secondo sottocapitolo
  2. Secondo capitolo
# {{modulo|Nome libro/Primo capitolo}}
#*Primo sottocapitolo
#*Secondo sottocapitolo
#Secondo capitolo

È preferibile, invece che inserire il sommario direttamente nella pagina del libro, inserire in questa l'indice di navigazione del libro, in modo che anche la prima pagina sia uniforme con le altre.

Moduli[modifica]

Searchtool.svg Per approfondire, vedi Aiuto:Modulo.

Come abbiamo detto, ciascun libro se più lungo di una pagina deve essere sottopaginato in moduli, che costituiscono il testo vero e proprio del wikibook. Ciascun modulo deve essere correttamente categorizzato e deve contenere, se esiste, l'indice di navigazione (il sommario).

Categorizzare il libro[modifica]

Searchtool.svg Per approfondire, vedi Wikibooks:Categorie e Aiuto:Categorie.

Tutti i moduli dello stesso libro, compresa la pagina principale del libro, devono essere categorizzati in una categoria, con il nome uguale al libro, creata appositamente. Ad esempio tutte le pagine del libro HTML sono categorizzate nella Categoria:HTML.

La pagina principale del libro, la sua copertina e il suo template di navigazione devono essere categorizzate in questo modo: [[Categoria:Nome libro| ]]; in questo modo, saranno mostrate all'inizio nell'elenco delle pagine che appartengono alla categoria del libro.

La categoria del libro va poi categorizzata nella Categoria:Categorie dei libri.

La pagina principale del libro deve invece contenere una serie di categorie che permettano la consultazione e la ricerca dei libri nella biblioteca tramite le categorie. Queste sono le categorie tematiche (ad esempio [[Categoria:Linguaggi descrittivi]] o [[Categoria:Matematica]]). È possibile poi aggiungere una classificazione di Dewey.

Un'altra categorizzazione da aggiungere è quella alfabetica, tramite l'uso del template {{alfabetico|lettera}} che categorizza il libro nella corretta categoria alfabetica secondo la lettera iniziale.

Gtk-zoom-in.svg Avanzamento del libro e dei moduli[modifica]

Searchtool.svg Per approfondire, vedi Aiuto:Fasi di sviluppo.

Per dare informazioni sullo stato di completamento del libro e dei moduli e inserirlo automaticamente nella categoria relativa al suo stadio di sviluppo, è stato elaborato il template {{avanzamento}} che va posto in fondo alla pagina in questo modo:

{{avanzamento|xx|''data''}}

Una volta inserito il tempate {{avanzamento}} nella pagina questo sarà automaticamente utilizzato per la generazione dei link (usando i template {{modulo}} e {{libro}}) e per la compilazione dei bollettini.

Usa lo schema che segue per classificare i libri:

Pulsante Fase di sviluppo Codice Descrizione
Button 00%.png 00%.svg 00% {{avanzamento|00%}} Quando il libro ha solo la pagina principale e l'introduzione o pochi capitoli a loro volta stub. Per ulteriori informazioni vedi Aiuto:Stub
Button 25%.png 25%.svg 25% {{avanzamento|25%}} Quando il libro è stato suddiviso in capitoli e alcuni di questi hanno del contenuto
Button 50%.png 50%.svg 50% {{avanzamento|50%}} Quando almeno metà dei capitoli hanno informazioni complete
Button 75%.png 75%.svg 75% {{avanzamento|75%}} Quando tutti o la maggior parte capitoli hanno informazioni complete
Button 100%.png 100 percents.svg 100% {{avanzamento|100%}} Quando il libro è stato riletto (errori di ortografia, inezie del layout ecc..)

Per valutare invece un modulo, se non sei tu l'autore il libro, valuta in base ai contenuti che ti aspetteresti di trovare. Se sei tu l'autore del modulo, e sai quindi quanto dovrà essere lunga la pagina, inserisci l'avanzamento come più ritieni giusto.

Per facilitare l'inserimento del template sono stati sviluppati dei pulsanti per la barra di modifica. Cliccando su ciascun pulsante si cambia l'avanzamento della pagina al livello desiderato.

Searchtool.svg Per approfondire, vedi Aiuto:Barra degli strumenti di modifica.

Se il libro è uno stub ti invitiamo a contribuire per migliorarlo almeno fino a renderlo sviluppato al 25%.

Menù di navigazione[modifica]

Searchtool.svg Per approfondire, vedi Aiuto:Template e Aiuto:Indice di navigazione.

Pur dividendo in capitoli, il libro potrebbe aver bisogno di un template di navigazione più comodo, qui trovi un esempio. Creare un template di questo tipo è obbligatorio tuttavia potrebbe risultare difficile a qualcuno; in questo caso, si seguano le indicazioni della pagina apposita.

Nuvola apps locale.png Interlink e interwiki[modifica]

Per ottimizzare ancor più la qualità del libro si possono inserire gli interlink e gli interwiki, i primi servono per linkare il libro ai corrispondenti nelle altre lingue, i secondi servono per inserire un link ad un altro progetto wikimedia.

Interlink[modifica]

Ad esempio, per inserire nel libro linguaggio HTML un collegamento alla versione in lingua inglese è necessario scrivere [[:en:HTML]]. Se per caso trovi un libro in una wb straniera e trovi il suo corrispondente in italiano per favore inserisci a fine testo la seguente sintassi: [[:it:NomeWikibokinItaliano]]

Interwiki[modifica]

Searchtool.svg Per approfondire, vedi Aiuto:Interprogetto.

Per inserire una riquadro, che riporti l'esistenza di un determinato articolo anche su un progetto fratello, basta usare gli appositi template.

Progetto Template
Wikipedia {{interprogetto|w=Titolo pagina}}
Wikisource {{interprogetto|s=Titolo pagina}}
Wikizionario {{interprogetto|wikt=Titolo pagina}}
Wikinews {{interprogetto|n=Titolo pagina}}
Wikiquote {{interprogetto|q=Titolo pagina}}
Commons {{interprogetto|c=Titolo pagina}}

Ad esempio, per creare un collegamente all'articolo HTML di Wikipedia all'interno del libro linguaggio HTML si usa la seguente sintassi: {{interprogetto|w=HTML|w_etichetta=l'HTML}}

Nuvola apps bookcase.png Pubblicazione[modifica]

Searchtool.svg Per approfondire, vedi Wikibooks:Ripiani.
Inserisci sempre i libri nel corretto ripiano, in questo modo sarà più facile trovarli!

Una volta creata la base del libro, bisogna renderlo accessibile agli altri utenti. Infatti, l'unico modo che hanno per poterlo vedere è osservare la pagina delle ultime modifiche.

Per poterlo rendere visibile a tutti è però necessario inserirlo nei ripiani, scegli il ripiano più appropriato. Se non sei sicuro, inserisci il libro all'interno del ripiano varie, e qualcun altro provvederà a collocarlo all'interno del ripiano più idoneo.
Per inserire un libro in un ripiano, usa il template {{libro}}, ad esempio in questo modo: {{libro|HTML}}. In questo modo sarà automaticamente linkata, anziché la pagina principale, la copertina del libro, seguita dall'avanzamento del libro.

Gaim send-im.svg Suggerire un libro[modifica]

Se non sei sicuro di poter contribuire in maniera sufficiente, inserisci le tue intenzioni nella pagina del bibliotecario e vedi se qualche altro wikibookiano è disposto ad aiutarti. Anche altri staranno aspettando il tuo contributo, quindi dacci un'occhiata.

Postscript-viewer-blue.svg Sbircia gli altri libri[modifica]

Uno dei migliori modi per realizzare un libro efficace è quello di basarsi su quei libri che vengono giudicati di ottima fattura. Ad esempio, puoi consultare la vetrina che ti permetterà di vedere i libri sono stati giudicati di ottima realizzazione, da parte della comunità. Puoi prendere spunto da essi per creare il libro, oppure guarda i libro che hanno vicino un'icona verde che attesta il fatto che il libro sia completo al 100%. Se ti è più semplice consulta la rispettiva categoria libri completi.

Nuvola apps korganizer.png Caratteristiche aggiuntive[modifica]

Libri stampabili[modifica]

Searchtool.svg Per approfondire, vedi Wikibooks:Libri stampabili.

Se vuoi rendere disponibili alla stampa i Wikibooks a cui contribusci, è necessario seguire alcune accortezze per far sì di avere un libro perfettamente stampabile.

Prefazione[modifica]

Se necessario, puoi creare un capitolo all'interno al libro chiamato Prefazione in cui viene spiegato come consultare il libro, i suoi contenuti ecc...ecc...

Bollettino[modifica]

Searchtool.svg Per approfondire, vedi Aiuto:Bollettino e Progetto:Coordinamento/Bollettini.

Un bollettino è una pagina particolare del libro (che si trova in Nome libro/Sviluppo) che serve per rappresentare schematicamente lo stato di avanzamento del libro e per dare così velocemente un'idea dello sviluppo del libro.

I bollettini sono gestiti tramite bot, quindi per avere il bollettino del libro devi fare una richiesta nell'apposita sezione del Progetto di Coordinamento: Progetto:Coordinamento/Bollettini.

Esercizi[modifica]

Searchtool.svg Per approfondire, vedi Aiuto:Esercizi.

Può essere molto utile inserire alla fine dei moduli del proprio libro una sezione di esercizi. Questo è importante soprattutto se il libro è di taglio didattico.

Gnome-help.svg Modelli di libro[modifica]

Pagine correlate[modifica]