Visualizza wikitesto di Template:Libro/man

[[WP:TS|Tabella sinottica]] da utilizzare in testa a voci o sezioni dedicate a un singolo libro (o opera in più volumi). Non va utilizzato nelle voci su intere serie o collane letterarie.

La tabella non contiene dati strettamente editoriali (editore, numero di pagine, ISBN ecc.) perché si riferisce all'opera contenuta, a prescindere dal formato. Un'opera letteraria ha in genere numerose edizioni diverse nel mondo e nel tempo. Queste vanno descritte nel corpo della voce, tipicamente con un elenco puntato di {{tl|Cita libro}} in una sezione dal titolo "Edizioni".

== Sintassi ==
Per inserire il template in una voce copiare il seguente testo:
{{TabellaTemplate
|parametri =
{{parametro|tipo|F}}
{{parametro|titolo}}
{{parametro|titoloorig|C}}
{{parametro|titolotraslitterato|C}}
{{parametro|titoloalt|A}}
{{parametro|titoloalfa|F}}
{{parametro|immagine|F|P18}}
{{parametro|didascalia|F}}
{{parametro|autore||P50}}
{{parametro|annoorig}}
{{parametro|forza_cat_anno|A}}
{{parametro|periodo}}
{{parametro|annoita|F}}
{{parametro|editioprinceps}}
{{parametro|genere}}
{{parametro|sottogenere|C}}
{{parametro|lingua|C}}
{{parametro|ambientazione|F}}
{{parametro|protagonista|F}}
{{parametro|coprotagonista|F}}
{{parametro|antagonista|F}}
{{parametro|altri_personaggi|F}}
{{parametro|personaggi|F}}
{{parametro|serie|F}}
{{parametro|preceduto|F}}
{{parametro|seguito|F}}
|istruzioni = 
* '''tipo''' = genere (es. giallo, fantascienza): determina il colore di sfondo per alcuni particolari generi, vedi [[Template:Libro/selettore colori]]
* '''titolo''' = titolo italiano
* '''titoloorig''' = titolo in lingua originale se diverso da quello italiano. È generalmente visualizzato in corsivo, eccetto che per lingue (come giapponese o coreano) con caratteri non latini, l'infobox decide automaticamente in base al valore del parametro <code>lingua</code> o <code>lingua1</code>. Nel caso si voglia forzare il corsivo si può utilizzare il parametro <code>forzacorsivo=s</code>, per disattivarlo usare <code>forzacorsivo=n</code>.
* '''titolotraslitterato''' = da usare per titoli in lingue che non usano l'alfabeto latino, per inserire la traslitterazione del titolo originale.
* '''titoloalt''' = titolo alternativo; se sono presenti altri titoli alternativi usare i parametri <code>titoloalt2</code>, <code>titoloalt3</code> e così via. In alternativa è possibile inserirli tutti usando il parametro <code>titolialt</code>.
* '''titoloalfa''' = titolo per ordinamento alfabetico (es. ''Cacciatore, Il''), privo di articolo iniziale e caratteri speciali. Il parametro è necessario solo per articoli che potrebbero essere altre parole ("I" o "A") e casi particolari, altrimenti viene calcolato automaticamente.
* '''immagine''' = copertina del libro o altra immagine significativa (non immettere prefissi come <code>image:</code>, <code>immagine:</code> o <code>file:</code>). {{WikidataProp|P18|tipo=manf}}.
* '''didascalia''' = didascalia (solo se diversa da "copertina del libro")
* '''autore''' = nome dell'autore/i. {{WikidataProp|P50|tipo=man}}.
* '''annoorig''' = anno della prima pubblicazione del libro nella lingua originale, senza parentesi quadre. Viene utilizzato per la categorizzazione automatica [[:Categoria:Opere letterarie per anno|per anno]] (dal 1801 in poi) e [[:Categoria:Opere letterarie per secolo|per secolo]] (fino al 1800). Se per qualche ragione è necessario inserire in questo campo cose diverse da un anno nudo e crudo, tramite il parametro <code>forza_cat_anno</code> è possibile comunque forzare la categorizzazione automatica (in questo caso considerare piuttosto l'uso del parametro <code>periodo</code>, vedi sotto).
** Se si tratta di opere pubblicate a puntate indicare l'intervallo degli anni mettendo la [[lineetta enne]] e le parentesi quadre (es.&nbsp;<code><nowiki>[[1978]]–[[1980]]</nowiki></code>). Usare anche <code>forza_cat_anno=no</code> per categorizzare manualmente, oppure <code>forza_cat_anno=1978</code> se il primo anno è considerato comunque rilevante ([https://it.wikipedia.org/w/index.php?title=I_promessi_sposi&diff=45869734&oldid=45851923 esempio]).
** Se l'anno non è applicabile perché non conosciuto con certezza o per altri motivi, indicare il secolo, il decennio o quello che è possibile indicare, inserire <code>forza_cat_anno=no</code> e poi categorizzare manualmente per secolo ([https://it.wikipedia.org/w/index.php?title=Perceval_o_il_racconto_del_Graal&diff=45869790&oldid=42640303 esempio]). 
** Se si tratta di un anno o un secolo a.C. usare <code>forza_cat_anno=no</code> e categorizzare manualmente ([https://it.wikipedia.org/w/index.php?title=Amores&diff=45869671&oldid=45757646 esempio])
* '''forza_cat_anno''' = inserire un anno senza parentesi quadre (es. {{param|forza_cat_anno|valore=1999}}) oppure <code>no</code>
** inserendo un anno senza parentesi quadre usa quest'ultimo anziché <code>annoorig</code> per categorizzare automaticamente per anno
** inserendo <code>no</code> spegne la categorizzazione automatica per anno in modo da consentire la categorizzazione manuale
* '''periodo''' = parametro utilizzabile in alternativa a <code>annoorig</code> nei casi in cui si conosce il periodo storico in cui è stata formata un'opera, ma questa non è un anno preciso. Se utilizzata ha la precedenza su <code>annoorig</code> (che non viene visualizzato) e disattiva la categorizzazione automatica (che è comunque utilizzabile forzando un valore con <code>forza_cat_anno</code>)
* '''annoita''' = anno prima pubblicazione del libro in italiano, solo per libri stranieri e anche se uguale a ''annoorig''. Inserire solo il numero, il wikilink viene aggiunto in automatico; in casi particolari può essere inserito testo libero.
* '''editioprinceps''' = per indicare l'anno e altre informazioni sull'[[editio princeps]] di un libro antico. Non effettua nessuna categorizzazione.
* '''genere''' = [[Genere_letterario#Classificazione|genere letterario]], compreso fra i seguenti:
** [[romanzo]]
** [[racconto]]
** [[biografia]]
** [[saggio]]
** ...<!-- lista da completare -->
* '''sottogenere''' = quando applicabile:
** Per la narrativa, il [[Narrativa di genere|filone narrativo]] trattato, per esempio:
*** [[fantascienza]]
*** [[fantasy]]
*** [[horror]]
*** [[Giallo (genere)|giallo]]
*** [[letteratura per ragazzi]]
*** ...
** Per opere non di narrativa (saggi, enciclopedie...), l'argomento trattato, ad esempio:
*** [[economia]]
*** [[storia]]
*** [[politica]]
*** [[religione]]
*** ...
* '''lingua''' = la lingua dell'edizione originale, codice [[ISO 639-2]]/[[ISO 639-3|3]] (es. ''it'') oppure testo libero (es. ''italiano'') senza wikilink. Nel caso di opere scritte contemporaneamente in più lingue, aggiungere <code>lingua2</code>, <code>lingua3</code>... Effettua anche la categorizzazione automatica per lingua. Per casi particolari o per aggiungere note usare <code>altrelingue</code>, che non effettua categorizzazioni e può contenere testo libero
* '''ambientazione''' = solo per le opere narrative, luogo e tempo in cui è ambientato il racconto/romanzo
* '''protagonista''' = protagonista/i del racconto/romanzo
* '''coprotagonista''' = 
* '''antagonista''' = 
* '''altri_personaggi''' = 
* '''personaggi''' = elenco dei personaggi, da utilizzare ''in alternativa'' agli altri parametri sui personaggi, quando ad es. non sono definibili i ruoli di protagonisti, antagonisti ecc.
* '''serie''' = se il libro fa parte di una serie, il titolo della serie (tra <nowiki>[[ ]]</nowiki> se la voce è presente). Non inserire la collana editoriale.
* '''preceduto''' = titolo dell'episodio precedente nella serie 
* '''seguito''' = titolo dell'episodio successivo
}}
{{clear}}

== Esempio di compilazione ==
{{Libro
|tipo = giallo
|titolo = Titolo del libro
|titoloorig = Titolo originale
|titoloalt = Titolo alternativo
|immagine = Total_internal_reflection_of_Chelonia_mydas.jpg
|didascalia = didascalia
|autore = autore
|annoorig = 1999
|annoita = [[2000]]
|genere = [[romanzo]]
|sottogenere = [[Giallo (genere)|giallo]]
|lingua = fr
|ambientazione = Nullandia, 1777
|personaggi = <!-- alternativo alle seguenti -->
|protagonista = il protagonista
|coprotagonista = il coprotagonista
|antagonista = l'antagonista
|altri_personaggi = i personaggi secondari
|serie = Le cronache dei ciambotti
|preceduto = Titolo 0
|seguito = Titolo 2
}}
<pre>
{{Libro
|tipo = giallo
|titolo = Titolo del libro
|titoloorig = Titolo originale
|titoloalt = Titolo alternativo
|titoloalfa = xxx
|immagine = Total_internal_reflection_of_Chelonia_mydas.jpg
|didascalia = didascalia
|autore = autore
|annoorig = 1999
|annoita = [[2000]]
|genere = [[romanzo]]
|sottogenere = [[Giallo (genere)|giallo]]
|lingua = fr
|ambientazione = Nullandia, 1777
|personaggi = <!-- alternativo alle seguenti -->
|protagonista = il protagonista
|coprotagonista = il coprotagonista
|antagonista = l'antagonista
|altri_personaggi = i personaggi secondari
|serie = Le cronache dei ciambotti
|preceduto = Titolo 0
|seguito = Titolo 2
}}
</pre>
{{clear}}

== Categorie automatiche ==
Il template effettua categorizzazioni automatiche enciclopediche per anno/secolo (tramite [[Modulo:Libro]]) e per lingua (tramite [[Template:Libro/lingua]]), in base ai parametri <code>genere</code>, <code>annoorig</code> e <code>lingua</code>. Queste possono causare errori, e in casi particolari si possono inibire (vedi descrizione dei parametri).

== Errori e categorie di servizio ==
In [[:Categoria:Errori di compilazione del template Libro]] si trovano gli errori di compilazione di questo template:
*[[:Categoria:Scheda libro con anno di prima pubblicazione mancante]]: voci nelle quali manca il parametro "annoorig".
*[[:Categoria:Scheda libro con anno di prima pubblicazione non riconosciuto]]: voci nelle quali il parametro "annoorig" non è stato riconosciuto.
*[[:Categoria:Scheda libro con didascalia senza immagine]]: voci nelle quali è presente il parametro "didascalia" ma non è specificato il parametero "immagine".
*[[:Categoria:Scheda libro con genere mancante]]: voci nelle quali manca il parametro obbligatorio "genere".
*[[:Categoria:Scheda libro con lingua originale mancante]]: voci nelle quali manca il parametro "lingua".
*[[:Categoria:Scheda libro con lingua originale non riconosciuta]]: voci nelle quali il parametro lingua non è stato riconosciuto.
*[[:Categoria:Scheda libro senza autore]]: voci nelle quali manca il parametro obbligatorio "autore".
*[[:Categoria:Scheda libro senza titolo]]: voci nelle quali manca il parametro obbligatorio "titolo".
*[[:Categoria:Voci con template Libro con parametri sconosciuti]]: voci che utilizzano parametri sconosciuti (con errori di battitura, inventati o senza nome).

== Voci a cui aggiungere il template ==
Alcuni elenchi di voci a cui aggiungere il template:

* [[:Categoria:Aggiungere template Libro]]

== Pagine correlate ==
* [[Template:Fumetto e animazione]]
* [[Modulo:Libro]]

{{progetto|letteratura|template}}

<noinclude>[[Categoria:Manuali dei template]]</noinclude>