La sua modifica può richiedere buona conoscenza delle funzioni parser. Per favore tenta di modificarlo solo se sei certo di capirne la funzione e sei preparato a riparare ogni conseguente danno collaterale nel caso in cui i risultati fossero diversi da quanto avevi in mente. Tutti gli esperimenti devono essere prima condotti in una pagina di prova.
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 {{Cita libro}} in una sezione dal titolo "Edizioni".
Sintassi
Per inserire il template in una voce copiare il seguente testo:
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 lingua o lingua1. Nel caso si voglia forzare il corsivo si può utilizzare il parametro forzacorsivo=s, per disattivarlo usare forzacorsivo=n.
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 titoloalt2, titoloalt3 e così via. In alternativa è possibile inserirli tutti usando il parametro titolialt.
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 image:, immagine: o file:). Se non specificata, è letta su Wikidata dalla proprietà identificativo BAV (P18), se presente.
didascalia = didascalia (solo se diversa da "copertina del libro")
autore = nome dell'autore/i. Se non specificato, è letto su Wikidata dalla proprietà identificativo NCL (P50), se presente.
annoorig = anno della prima pubblicazione del libro nella lingua originale, senza parentesi quadre. Viene utilizzato per la categorizzazione automatica per anno (dal 1801 in poi) e 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 forza_cat_anno è possibile comunque forzare la categorizzazione automatica (in questo caso considerare piuttosto l'uso del parametro periodo, vedi sotto).
Se si tratta di opere pubblicate a puntate indicare l'intervallo degli anni mettendo la lineetta enne e le parentesi quadre (es. [[1978]]–[[1980]]). Usare anche forza_cat_anno=no per categorizzare manualmente, oppure forza_cat_anno=1978 se il primo anno è considerato comunque rilevante (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 forza_cat_anno=no e poi categorizzare manualmente per secolo (esempio).
Se si tratta di un anno o un secolo a.C. usare forza_cat_anno=no e categorizzare manualmente (esempio)
forza_cat_anno = inserire un anno senza parentesi quadre (es. forza_cat_anno = 1999) oppure no
inserendo un anno senza parentesi quadre usa quest'ultimo anziché annoorig per categorizzare automaticamente per anno
inserendo no spegne la categorizzazione automatica per anno in modo da consentire la categorizzazione manuale
periodo = parametro utilizzabile in alternativa a annoorig 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 annoorig (che non viene visualizzato) e disattiva la categorizzazione automatica (che è comunque utilizzabile forzando un valore con forza_cat_anno)
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.
lingua = la lingua dell'edizione originale, codice ISO 639-2/3 (es. it) oppure testo libero (es. italiano) senza wikilink. Nel caso di opere scritte contemporaneamente in più lingue, aggiungere lingua2, lingua3... Effettua anche la categorizzazione automatica per lingua. Per casi particolari o per aggiungere note usare altrelingue, 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 [[ ]] se la voce è presente). Non inserire la collana editoriale.
preceduto = titolo dell'episodio precedente nella serie
{{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
}}
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 genere, annoorig e lingua. Queste possono causare errori, e in casi particolari si possono inibire (vedi descrizione dei parametri).
Questo template ha una formattazione personalizzata.
Parametro
Descrizione
Tipo
Stato
Tipo di genere
tipo
genere (es. giallo, fantascienza): determina il colore di sfondo per alcuni particolari generi
Stringa
facoltativo
Titolo
titolo
Titolo del libro in lingua italiana, deve coincidere con il titolo della voce
Stringa
obbligatorio
Titolo originale
titoloorig
Titolo del libro in lingua originale, se diversa dalla lingua italiana
Stringa
facoltativo
Titolo traslitterato
titolotraslitterato
Se il titolo originale del libro è in caratteri non latini inserire la traslitterazione
Stringa
facoltativo
Titoli alternativi
titolialt
Titoli alternativi (per edizioni italiane diverse)
Stringa
facoltativo
Ordinamento
titoloalfa
Titolo privo degli articoli iniziali per ordinamento alfabetico, inserire solo se diverso dal titolo della voce (es. Cacciatore, Il)
Stringa
facoltativo
Copertina
immagine
Copertina del libro o altra immagine significativa, con estensione e senza prefisso (image:, immagine: o file:), es. 'Copertina.jpg'
Stringa
facoltativo
Didascalia
didascalia
Didascalia (solo se diversa da 'copertina del libro')
Stringa
facoltativo
Autore/i
autore
Nome dell'autore o degli autori (separati da virgola se più di uno), con wikilink
Stringa
obbligatorio
Anno pubblicazione
annoorig
Anno della prima pubblicazione del libro nella lingua originale, senza wikilink. Se non conosciuto, indicare il decennio o il secolo. Per opere pubblicate a puntate, indicare l'intervallo degli anni mettendo la lineetta enne e il wikilink (es. [[1978]]–[[1980]])
Stringa
consigliato
Forza categorizzazione
forza_cat_anno
Forza la categorizzazione per anno al valore indicato. Indicare l'anno senza wikilink. Indicando 'no' disabilita la categorizzazione automatica. Usare 'no' per opere realizzate avanti Cristo
Stringa
facoltativo
Periodo
periodo
parametro utilizzabile in alternativa a annoorig 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 annoorig (che non viene visualizzato) e disattiva la categorizzazione automatica (che è comunque utilizzabile forzando un valore con forza_cat_anno)
Stringa
consigliato
Pubblicazione in italiano
annoita
Solo per libri tradotti: anno della prima pubblicazione del libro in lingua italiana, con wikilink. Inserire anche se uguale a annoorig.
Stringa
facoltativo
Editio Princeps
editioprinceps
per indicare l'anno e altre informazioni sull'editio princeps di un libro antico. Non effettua nessuna categorizzazione.
Stringa
consigliato
Genere letterario
genere
Genere letterario, (con wikilink): romanzo / racconto / biografia / saggio / ecc.
Stringa
obbligatorio
Sottogenere
sottogenere
Tipo di argomento trattato (con wikilink), es. fantascienza, giallo, horror, fantasy, ecc. Se più di uno, separare con una virgola.
Stringa
facoltativo
Lingua originale
lingua
Lingua dell'edizione originale, codice ISO 639-2/3 (es. 'it', 'en') oppure testo libero (es. 'italiano', 'inglese') senza wikilink
Stringa
obbligatorio
Ambientazione
ambientazione
Solo per le opere narrative, luogo e tempo in cui è ambientato il racconto/romanzo
Stringa
facoltativo
Protagonista
protagonista
Protagonista del racconto/romanzo, eventualmente con wikilink
Stringa
facoltativo
Coprotagonista
coprotagonista
Coprotagonista del racconto/romanzo, eventualmente con wikilink
Stringa
facoltativo
Antagonista
antagonista
Avversario del protagonista del racconto/romanzo, eventualmente con wikilink
Stringa
facoltativo
Altri personaggi
altri_personaggi
Elenco di altri personaggi, separati da una virgola, eventualmente con wikilink
Stringa
facoltativo
Elenco personaggi
personaggi
Da usare in alternativa agli altri parametri, quando i ruoli non sono definibili. Elenco completo di tutti i personaggi, separati da una virgola, eventualmente con wikilink
Stringa
facoltativo
Serie
serie
Se il libro fa parte di una serie, il titolo della serie (eventualmente con wikilink). Non inserire la collana editoriale.
Stringa
facoltativo
Libro precedente
preceduto
Se il libro fa parte di una serie, titolo dell'episodio precedente della serie (eventualmente con wikilink). Non usare per il primo libro della serie.
Stringa
facoltativo
Libro successivo
seguito
Se il libro fa parte di una serie, titolo dell'episodio successivo della serie (eventualmente con wikilink). Non usare per l'ultimo libro della serie.