Wikibooks

Informatica ecologica/Introduzione: differenze tra le versioni

Naviga nella cronologia in modo interattivo
Differenza successiva →
Contenuto cancellato Contenuto aggiunto
VisualeWikitesto
Nuova pagina: {{Scrivere un libro}} {{wikibooks}} {{Indice aiuto}} Questa pagina raccoglie e riassume tutte le convenzioni per la buona organizzazione e formattazione di un wikilibro. Prima di inizi...
 
Pagina svuotata
Riga 1:
{{Scrivere un libro}}
{{wikibooks}}
{{Indice aiuto}}
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.
 
== [[Immagine:Nuvola apps emacs.png|30px]] Sicuro di voler contribuire? ==
{{vedi anche|Wikibooks:Perché contribuire ad un libro di testo open source|Aiuto:Libro abbandonato}}
Se vuoi iniziare a scrivere un nuovo libro, valuta prima se riuscirai a sviluppare almeno una parte del libro, senza abbandonare tutto il lavoro subito dopo avere incominciato. Questo perché l'abbandono dei libri da parte degli autori originali è uno dei problemi più gravi di Wikibooks; e lo diventa ancora di più se ciò si verifica quando il libro è solo un [[aiuto:stub|abbozzo]], in quanto rende impossibile ad altri utenti riprendere il lavoro.
 
Piuttosto, se non puoi o non vuoi dedicare a Wikibooks il tempo di portare a buon punto lo sviluppo di un libro, puoi sempre contribuire ai nostri wikibook già iniziati, per i quali è possibile contribuire mantenendo un'unità stilistica e contenutistica: consulta i [[Aiuto:Libro abbandonato|libri abbandonati]], i [[:Categoria:Libri 50%|libri fermi a metà]] e o [[:Categoria:Libri 75%|libri quasi completati]].
 
== [[Immagine:Gtk-ok.svg|30px]] Il tuo libro è un vero wikibook? ==
{{vedi anche|Wikibooks:Cosa mettere su Wikibooks|Wikibooks:Cosa non mettere su Wikibooks}}
Per capire se il tuo libro è adatto a [[Wikibooks:About|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 [[Wikibooks:Wikisource|Wikisource]].
* Guarda, per rendertene conto, la [[Wikibooks:Tutti i libri|lista dei libri]] disponibili su Wikibooks. Ogni libro deve soddisfare le indicazioni della pagina [[Wikibooks:Cosa mettere su Wikibooks|Cosa mettere su Wikibooks]].
 
== [[Immagine:Gnome-lockscreen.svg|30px]] Il tuo libro esiste? ==
 
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 [[Wikibooks:Biblioteca|ripiani]] per vedere se ne esiste uno simile.
 
== [[Immagine:Emblem-fun.svg|30px]] Seguirai il tuo libro? ==
 
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 tuo libro abbastanza da trattare tutti i suoi argomenti o almeno per la sua gran parte.
 
== [[Immagine:Crystal_Clear_app_package_settings.png|30px]] Sii coraggioso (''be bold'')! Si comincia ==
 
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 [[aiuto:pagina di discussione|pagina di discussione]] del libro delle informazioni approfondite riguardo le ''linee guida'' della stesura del libro (convenzioni, organizzazione, finalità).
 
=== [[Immagine:Crystal_Clear_app_fonts.png|30px]] Il titolo ===
{{Vedi anche|1=Aiuto:Convenzioni di nomenclatura}}
Un titolo deve essere allo stesso tempo breve ed esplicativo: deve essere abbastanza chiaro da distinguere il tuo 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 chiamare il tuo libro ''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]]?
 
=== [[Immagine:Inkscape.svg|30px]] La copertina ===
{{Vedi anche|1=Aiuto:Copertina}}
Come ogni libro che si rispetti, anche un libro necessita della sua copertina. Per crearla è sufficiente creare una [[Aiuto:Sottopagina|sottopagina]] in questo modo: <code>Nome libro/Copertina</code>.
 
La copertina deve contenere nell'ordine:
 
*Titolo
**Sottotitolo (se necessario)
*Immagine esplicativa (per un libro sui [[Personal Computer|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 '''{{tl|Copertina}}'''.
 
=== Organizzazione del libro ===
[[Image:Wikibooks_it_structure.svg|400px|thumb|right|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]]
{{Vedi anche|1=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 [[Aiuto:Sottopagina|sottopagine]] (i [[#Moduli|moduli]]) seguendo le [[Aiuto:Convenzioni di nomenclatura|convenzioni di nomenclatura]].
 
==== La pagina principale del libro ====
La pagina principale del libro (ad esempio [[HTML]]) deve contenere una breve introduzione sull'argomento, indicare le '''finalità''' del wikibook, contenere un [[#Sommario|sommario]] (preferibilmente sotto forma di [[Aiuto:indice di navigazione|indice di navigazione]]).
<br/>In fondo vanno poi inserite le [[Aiuto:Sezioni|sezioni predefinite]], se presenti, in questo ordine:
* [[Wikibooks:Libri correlati|Libri correlati]]
* [[Aiuto:Interprogetto|Altri progetti]]
* [[Wikibooks:Bibliografia|Bibliografia]]
* [[Wikibooks:Collegamenti esterni|Collegamenti esterni]]
 
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 [[Aiuto:link|link]] alla copertina.
 
La pagina principale deve poi contenere le [[aiuto:categorizzazione tematica|categorizzazione tematica]] (ad esempio <nowiki>[[Categoria:Linguaggi di programmazione]]</nowiki>) e la [[aiuto:categorizzazione alfabetica|categorizzazione alfabetica]] tramite l'uso del template {{tl|alfabetico|lettera}}.
 
===== [[Immagine:Gedit.svg|30px]] Sommario =====
Per scrivere un sommario, è sufficiente creare una lista di capitoli utilizzando il template {{tl|modulo}} preceduto dal segno <code><nowiki>#</nowiki></code>, in modo da ottenere automaticamente un elenco numerato. Ai sottocapitoli è necessario far precedere i segni <code><nowiki>#*</nowiki></code> in modo da ottenere un quadratino davanti a ogni sottocapitolo:
 
{| border="1" cellpadding="2" cellspacing="0" width="100%"
! Come viene visualizzato
! Come si scrive
|-
|
# {{modulo|Nome libro/Primo capitolo}}
#*Primo sottocapitolo
#*Secondo sottocapitolo
#Secondo capitolo
|
<pre>
# {{modulo|Nome libro/Primo capitolo}}
#*Primo sottocapitolo
#*Secondo sottocapitolo
#Secondo capitolo
</pre>
|}
 
È preferibile, invece che inserire il sommario direttamente nella pagina del libro, inserire in questa l'[[Aiuto:indice di navigazione|indice di navigazione]] del libro, in modo che anche la prima pagina sia uniforme con le altre.
 
==== Moduli ====
{{vedi anche|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 ==
{{vedi anche|Wikibooks:Categorie|Aiuto:Categorie}}
Tutte i moduli dello stesso libro, compresa la pagina principale del libro, devono essere categorizzate 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: <code><nowiki>[[Categoria:Nome libro| ]]</nowiki></code>; 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 '''[[:Categoria:Libri per area tematica|categorie tematiche]]''' (ad esempio <nowiki>[[Categoria:Linguaggi descrittivi]] o [[Categoria:Matematica]])</nowiki>. È possibile poi aggiungere una [[Wikibooks:Classificazione decimale Dewey|classificazione di Dewey]].
 
Un'altra categorizzazione da aggiungere è quella '''alfabetica''', tramite l'uso del template {{tl|alfabetico|lettera}} che categorizza il libro nella corretta categoria alfabetica secondo la lettera iniziale.
 
== [[Immagine:Gtk-zoom-in.svg|30px]] Avanzamento del tuo libro e dei moduli ==
{{Vedi anche|1=Aiuto:Fasi di sviluppo}}
 
Per dare informazioni sullo stato di completamento del tuo libro e dei moduli e inserirlo automaticamente nella categoria relativa al suo stadio di sviluppo, è stato elaborato il [[Aiuto:template|template]] '''{{tl|avanzamento}}''' che va posto in fondo alla pagina in questo modo:
 
<nowiki>{{avanzamento|xx|''data''}}</nowiki>
 
Una volta inserito il tempate {{tl|avanzamento}} nella pagina questo sarà automaticamente utilizzato per la generazione dei link (usando i template {{tl|modulo}} e {{tl|libro}}) e per la compilazione dei [[Aiuto:bollettino|bollettini]].
 
Usa lo schema che segue per classificare i libri:
{| {{prettytable}}
!Pulsante
!Fase di sviluppo
!Codice
!Descrizione
|-
| [[Immagine:Button 00%.png]] || [[Immagine:00%.svg]] <code>00%</code>
|<code><nowiki>{{avanzamento|00%}}</nowiki></code>
|Quando il libro ha solo la pagina principale e l'introduzione o pochi capitoli a loro volta ''stub''. Per ulteriori informazioni vedi [[Aiuto:Stub]]
|-
| [[Immagine:Button 25%.png]] || [[Immagine:25%.svg]] <code>25%</code>
|<code><nowiki>{{avanzamento|25%}}</nowiki></code>
|Quando il libro è stato suddiviso in capitoli e alcuni di questi hanno del contenuto
|-
| [[Immagine:Button 50%.png]] ||[[Immagine:50%.svg]] <code><nowiki>50%</nowiki></code>
|<code><nowiki>{{avanzamento|50%}}</nowiki></code>
|Quando almeno metà dei capitoli hanno informazioni complete
|-
| [[Immagine:Button 75%.png]] ||[[Immagine:75%.svg]] <code><nowiki>75%</nowiki></code>
|<code><nowiki>{{avanzamento|75%}}</nowiki></code>
|Quando tutti o la maggior parte capitoli hanno informazioni complete
|-
| [[Immagine:Button 100%.png]] ||[[Immagine:100%.svg]] <code><nowiki>100%</nowiki></code>
|<code><nowiki>{{avanzamento|100%}}</nowiki></code>
|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.
{{vedi anche|Aiuto:Barra degli strumenti di modifica}}
Se il libro è uno [[Aiuto:stub|stub]] ti invitiamo a contribuire per migliorarlo almeno fino a renderlo sviluppato al 25%.
 
== Menù di navigazione ==
{{Vedi anche|1=Aiuto:Template|2=Aiuto:Indice di navigazione}}
 
Pur dividendo in capitolo, il tuo libro potrebbe aver bisogno di un template di navigazione più comodo, [[Template:PHP|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 [[Aiuto:Indice di navigazione|pagina apposita]].
 
== [[Immagine:Nuvola apps locale.png|30px]] Interlink e interwiki ==
 
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 ===
 
Ad esempio, per inserire nel libro [[HTML|linguaggio HTML]] un collegamento alla versione in lingua inglese è necessario scrivere <code><nowiki>[[:en:HTML]]</nowiki></code>. 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: <code><nowiki>[[:it:NomeWikibokinItaliano]]</nowiki></code>
 
=== Interwiki ===
{{Vedi anche|1=Aiuto:Interprogetto}}
Per inserire una riquadro, che riporti l'esistenza di un determinato articolo anche su un progetto fratello, basta usare gli appositi template.
 
{| {{prettytable}}
!Progetto
!Template
|-
|<code>Wikipedia</code>
|<code><nowiki>{{interprogetto|w=Titolo pagina}}</nowiki></code>
|-
|<code>Wikisource</code>
|<code><nowiki>{{interprogetto|s=Titolo pagina}}</nowiki></code>
|-
|<code>Wikizionario</code>
|<code><nowiki>{{interprogetto|wikt=Titolo pagina}}</nowiki></code>
|-
|<code>Wikinews</code>
|<code><nowiki>{{interprogetto|n=Titolo pagina}}</nowiki></code>
|-
|<code>Wikiquote</code>
|<code><nowiki>{{interprogetto|q=Titolo pagina}}</nowiki></code>
|-
|<code>Commons</code>
|<code><nowiki>{{interprogetto|c=Titolo pagina}}</nowiki></code>
|}
 
Ad esempio, per creare un collegamente all'articolo [[w:HTML|HTML]] di Wikipedia all'interno del libro [[HTML|linguaggio HTML]] si usa la seguente sintassi: <code><nowiki>{{interprogetto|w=HTML|w_etichetta=l'HTML}}</nowiki></code>
 
== [[Immagine:Nuvola_apps_bookcase.png|30px]] Pubblicazione ==
{{vedi anche|Wikibooks:Ripiani}}
[[Image:Library Pengo.jpg|thumb|right|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 [[Speciale:Recentchanges|ultime modifiche]].
 
Per poterlo rendere visibile a tutti è però necessario inserirlo nei [[Wikibooks:Ripiani|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.<br/>
Per inserire un libro in un ripiano, usa il template {{tl|libro}}, ad esempio in questo modo: <code><nowiki>{{libro|HTML}}</nowiki></code>. In questo modo sarà automaticamente linkata, anziché la pagina principale, la copertina del libro, seguita dall'avanzamento del libro.
 
== [[Immagine:Gaim send-im.svg|30px]] Suggerire un libro ==
 
Se non sei sicuro di poter contribuire in maniera sufficiente, inserisci le tue intenzioni nella pagina del [[Wikibooks:Bibliotecario|bibliotecario]] e vedi se qualche altro wikibookiano è disposto ad aiutarti. Anche altri staranno aspettando il tuo contributo, quindi dacci un'occhiata.
 
== [[Immagine:Postscript-viewer-blue.svg|30px]] Sbircia gli altri libri ==
 
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 [[Wikibooks:Vetrina|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 tuo 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 [[:Categoria:Libri 100%|libri completi]].
 
== [[Immagine:Nuvola apps korganizer.png|30px]] Caratteristiche aggiuntive ==
 
=== Libri stampabili ===
{{Vedi anche|1=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 ===
 
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 ===
{{vedi anche|Aiuto:Bollettino|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 tuo libro devi fare una richiesta nell'apposita sezione del Progetto di Coordinamento: [[Progetto:Coordinamento/Bollettini]].
 
=== Esercizi ===
{{vedi anche|Aiuto:Esercizi}}
Può essere molto utile inserire alla fine dei [[aiuto:modulo|moduli]] del proprio libro una sezione di [[aiuto:esercizi|esercizi]]. Questo è importante soprattutto se il libro è di taglio didattico.
 
== [[Immagine:Gnome-help.svg|30px]] Modelli di libro ==
 
*[[Aiuto:Modello di libro - Romanzo|Come argomentare un romanzo]]
 
== Pagine correlate ==
 
*'''[[Aiuto:Modifica|Modifica]]''': come modificare una pagina.
*'''[[Aiuto:Manuale di stile|Manuale di stile]]''': i trucchi del mestiere per realizzare delle pagine impeccabili dal punto di vista della [[Aiuto:Markup|formattazione]].
 
[[Categoria:Aiuto|Come scrivere un libro]]
Estratto da "https://it.wikibooks.org/wiki/Informatica_ecologica/Introduzione"