Template:Bio: differenze tra le versioni
m rinominata funzione |
m una versione importata |
||
(Nessuna differenza)
|
Versione attuale delle 19:58, 1 set 2020
Questo template ha un codice sorgente piuttosto complesso.
|
Le istruzioni che seguono sono contenute nella sottopagina Template:Bio/man (modifica · cronologia)
Sandbox: Template:Bio/Sandbox (modifica · cronologia) · Tutte le sottopagine: lista
Il template {{Bio}} serve per inserire i principali dati biografici nelle voci dedicate a una persona. Va inserito nella sezione iniziale della voce, all'inizio del testo, preceduto soltanto da eventuali altri template. I suoi compiti sono:
- genera l'incipit (frase iniziale) della voce, wikificato e standardizzato
- genera le categorie standard per attività, nazionalità, anno di nascita/morte, giorno di nascita/morte, luogo di nascita/morte
- rende i dati biografici disponibili ad un Bot che genera numerose liste, ad esempio i nati per anno
- genera opzionalmente un riquadro con ritratto e principali riconoscimenti
Nomi e cognomi
Indicare correttamente il nome e il cognome come tutti i parametri è fondamentale sia per la formazione dell'incipit sia per l'ordinamento nelle categorie.
- Nome contiene anche secondo e terzo nome oltre a eventuali particelle nobiliari anteposte al cognome (p.e. von, van, de).
- In alcune lingue dell'estremo oriente, tra cui cinese e giapponese, tradizionalmente il cognome viene posto prima del nome (ad es. in Mao Zedong il cognome è Mao). Cerca di compilare Nome e Cognome con quelli che veramente sono il nome e il cognome; per invertirli nella visualizzazione basta dare un valore non vuoto a CognomePrima (vedi descrizione del campo in #Tabella completa).
- Se non esiste il cognome (ad esempio perché si tratta di un personaggio dell'antichità o di un islandese indicato con nome + patronimico) le determinazioni successive al nome (ad esempio la città di provenienza, il patronimico o un appellativo) debbono essere inserite nel campo Nome successivamente al nome vero e proprio.
"Alessandro Magno", "Leonardo da Vinci", "Snorri Sturluson" sono cioè da considerarsi "nomi".
Pseudonimi
Quando il soggetto della voce ha uno pseudonimo, questo va specificato tramite il parametro Pseudonimo. Il template provvederà a generare automaticamente l'incipit corretto in base ai due casi:
- voce intitolata allo pseudonimo, esempio Feiez: il template genererà un incipit del tipo "Feiez, pseudonimo di Paolo Panigada"
- voce intitolata a nome e cognome, esempio Brett Halsey: il template genererà un incipit del tipo "Brett Halsey, noto anche con lo pseudonimo di Montgomery Ford"
In presenza del parametro Pseudonimo, se questo è uguale al titolo della voce, il template ordina secondo la lettera iniziale del nome. Quindi Iggy Pop è ordinato secondo la I. Questo meccanismo funziona anche se lo pseudonimo nel titolo è disambiguato. Per questo motivo in caso di pseudonimi percepiti come nome e cognome occorre forzare l'ordinamento. Per esempio in Daniele Luttazzi si usa ForzaOrdinamento=Luttazzi, Daniele. Nel caso sia dubbio che lo pseudonimo sia percepito come un nome/cognome (Daniele Luttazzi) oppure come un nome unico (Iggy Pop), aprire una discussione.
Tabella semplice
Per inserire correttamente il template, basta copiare la seguente tabella semplice e completarla con i dati relativi alla voce.
<Attività> e <Nazionalità> sono obbligatorie e creano la categorizzazione della voce; Esistono comunque due casi particolari:
|
{{Bio
|Nome =
|Cognome =
|Sesso =
|LuogoNascita =
|GiornoMeseNascita =
|AnnoNascita =
|LuogoMorte =
|GiornoMeseMorte =
|AnnoMorte =
|Attività = <!-- Campo obbligatorio, ma può essere sovrascritto, vedi istruzioni a fianco -->
|Nazionalità = <!-- Idem -->
|PostNazionalità =
}}
Tabella completa
Qualora si debbano impiegare altri campi oltre quelli previsti nella tabella semplice copiare la seguente tabella completa e compilarne i campi con i dati relativi alla voce.
|
{{Bio
|Titolo =
|Nome =
|Cognome =
|CognomePrima =
|Pseudonimo =
|PostPseudonimo =
|PostCognome =
|PostCognomeVirgola =
|ForzaOrdinamento =
|PreData =
|Sesso =
|LuogoNascita =
|LuogoNascitaLink =
|LuogoNascitaAlt =
|GiornoMeseNascita =
|AnnoNascita =
|NoteNascita =
|LuogoMorte =
|LuogoMorteLink =
|LuogoMorteAlt =
|GiornoMeseMorte =
|AnnoMorte =
|NoteMorte =
|Epoca =
|Epoca2 =
|PreAttività =
|Attività =
|Attività2 =
|Attività3 =
|AttivitàAltre =
|Nazionalità =
|NazionalitàNaturalizzato =
|Cittadinanza =
|PostNazionalità =
|Categorie =
|FineIncipit =
|Punto =
|Immagine =
|Didascalia =
|Didascalia2 =
|DimImmagine =
}}
Ulteriori spiegazioni sui campi
Utilizzare correttamente le maiuscole e le minuscole: in particolare i parametri |GiornoMeseNascita, |GiornoMeseMorte, |Attività, |Nazionalità vanno sempre in minuscolo.
Non utilizzare wikilink nei principali campi di questo template. I link necessari sono già contenuti all'interno del template.
In base al dato sull'attività un bot (Utente:Biobot) aggiorna automaticamente le liste per professione e nazionalità. Per evitare doppi inserimenti nella stessa lista, viene privilegiata l'attività principale. Quindi è necessario inserire le attività in ordine di rilevanza nella vita del personaggio.
Per i personaggi difficilmente inquadrabili nello schema Attività + Nazionalità, ad esempio un papa, si faccia uso dei parametri FineIncipit e/o Categorie. Si veda ad esempio Benedetto XVI. Nel caso vengano inseriti entrambi i parametri Categorie=no e FineIncipit, il template ignorerà quelli per attività e nazionalità: anche in questo caso è comunque consigliato il loro utilizzo, se possibile, per permettere l'aggiunta della voce nelle liste per professione e nazionalità da parte di Biobot.
La presenza o assenza di FineIncipit e Categorie determina quattro casi (gli esempi fanno riferimento a una voce Mario Rossi):
Caso | Utilizzo | Risultato | Note |
---|---|---|---|
Entrambi assenti |
|Attività = scrittore |
Mario Rossi (...) è uno scrittore italiano. |
|
Categorie=no |
|Attività = sarto |
Mario Rossi (...) è un sarto italiano. |
|
FineIncipit |
|Attività = nobile |
Mario Rossi (...) è stato un conte vissuto nel XIII secolo. |
|
Categorie=no e FineIncipit |
|Attività = nobile |
Mario Rossi (...) è stato un conte vissuto nel XIII secolo. |
|
Segnalazione errori
Se il template non è compilato correttamente viene visualizzato un messaggio di errore e la voce è categorizzata in:
- Categoria:Bio warning: se l'attività e la nazionalità non sono inseriti, o non hanno valori validi (e non si è utilizzato FineIncipit e Categorie=no)
- Categoria:Bio con parametri sconosciuti se vengono utilizzati dei campi non esistenti
- Categoria:Errori di compilazione del template Bio: se viene utilizzato un valore non valido per un campo. Sono considerati non validi:
- Sesso con un valore diverso da "M" o "F"
- Categorie e Punto con un valore diverso da "no"
- Epoca e Epoca2 con un valore diverso da 0, 100, 200, ... 1800, 1900, 2000 e da I, II, III, ... XIX, XX, XXI, oppure da -700, -600, -500, -400, -300, -200, -100, -0 e da VIII a.C, VII a.C., ..., I a.C.
- Epoca2 con valore uguale a Epoca
- LuogoNascitaLink con valore uguale LuogoNascita e LuogoMorteLink con valore uguale a LuogoMorte
- DimImmagine con un valore non numerico (intero positivo)
- AnnoMorte con un valore antecedente ad AnnoNascita
- PostNazionaltà che inizia con il punto
- PostCognome e PostCognomeVirgola usati insieme
- AnnoNascita valorizzato a "?" o "...", se sconosciuto va lasciato vuoto
- AnnoMorte valorizzato a "...", se sconosciuto va utilizzato "?"
- l'utilizzo di LuogoNascitaLink/LuogoNascitaAlt con LuogoNascita vuoto
- l'utilizzo di LuogoMorteLink/LuogoMorteAlt con LuogoMorte vuoto
- l'utilizzo di LuogoMorte/GiornoMeseMorte con AnnoMorte vuoto
- l'utilizzo di Epoca2 con Epoca vuoto
- l'utilizzo di Attività3 con Attività2 vuoto
I seguenti errori vengono invece solo categorizzati in Categoria:Errori di compilazione del template Bio senza messaggio di errore:
- PostNazionalità e FineIncipit di dimensione maggiore o uguale a 1000 caratteri
Categorizzazione
In base ai parametri inseriti, il template Bio categorizza automaticamente la voce in una serie di categorie, facenti parte di due grandi gruppi:
- quello legato alla data e luogo di nascita e morte;
- quello legato all'attività del biografato (e secondariamente alla sua nazionalità). Questa categorizzazione è disattivabile con il parametro Categorie impostato a "no" (Categorie=no).
La voce è inoltre categorizzata solo in categorie già esistenti, cioè non viene mai lasciato un link rosso a una categoria inesistente.
Infine tutte le voci sono categorizzate anche in Categoria:BioBot e solo per le voci nel namespace principale.
Per data di nascita e morte
La voce viene categorizzata per data di nascita e morte nel seguente modo:
- Nati nel AnnoNascita (esempio Categoria:Nati nel 2001)
- Nati il GiornoMeseNascita (esempio Categoria:Nati il 15 gennaio)
- Morti nel AnnoMorte (esempio Categoria:Morti nel 2005)
- Morti il GiornoMeseNascita (esempio Categoria:Morti il 15 febbraio)
Se AnnoMorte è valorizzato a "?" la voce è categorizzata in Categoria:Anno di morte sconosciuto.
Per luogo di nascita e morte
La voce viene categorizzata per luogo di nascita e morte nel seguente modo:
- Nati a LuogoNascita (esempio Categoria:Nati a Roma)
- Morti a LuogoMorte (esempio Categoria:Morti a Firenze)
Nel caso sia stato utilizzato anche LuogoNascitaLink o LuogoMorteLink allora la voce viene categorizzata per questi, invece che per LuogoNascita e LuogoMorte, per sfruttare la disambiguazione quando ci sono città omonime:
- Nati a LuogoNascitaLink (esempio Categoria:Nati a Nicosia (Italia))
- Morti a LuogoMorteLink
Le categorie per luogo vengono assegnate alla voce solo se esistono già. Di solito si preferisce crearle solo quando ci sono almeno 2-3 probabili elementi. La preposizione "ad" al posto di "a" va utilizzata solo per le città che iniziano per A ed è automaticamente riconosciuta.
Eventuali casi particolari, che non funzionerebbero con il comportamento sopra descritto, possono essere impostati tramite l'elenco Modulo:Bio/Cat luoghi. Ad esempio è impostato Categoria:Nati all'Aquila al posto di "Nati a L'Aquila" che apparirebbe di default. Usa la pagina Discussioni modulo:Bio/Cat luoghi per richiedere l'aggiunta di altre eccezioni.
Per attività
La voce viene categorizzata per il tipo di attività, usando la nazionalità come aggettivo.
Per ognuna dei parametri Attività (Attività, Attività2 e Attività3) la voce viene categorizzata nelle seguenti categorie (esempio per Attività):
- Attività di Nazionalità (esempio Categoria:Scrittori italiani)
- Attività di NazionalitàNaturalizzato
- Attività di Cittadinanza
Se Epoca o Epoca2 sono valorizzati (anche entrambi, per chi ha esercitato l'attività a cavallo di due secoli) sono invece create le categorie:
- Attività di Nazionalità di Epoca (esempio Categoria:Scrittori italiani del XX secolo)
- Attività di Nazionalità di Epoca2 (esempio Categoria:Scrittori italiani del XXI secolo)
- Attività di NazionalitàNaturalizzato di Epoca
- Attività di NazionalitàNaturalizzato di Epoca2
- Attività di Cittadinanza di Epoca
- Attività di Cittadinanza di Epoca2
Lo stesso procedimento viene seguito per Attività2 e Attività3, per arrivare quindi a un limite teorico di 18 categorie per una singola biografia, che abbia tre attività, NazionalitàNaturalizzato e Cittadinanza valorizzati oltre a Nazionalità, ed Epoca e Epoca2 valorizzati.
La categorizzazione per attività è disattivabile con il parametro Categorie impostato a "no" (Categorie=no).
Funzionamento e configurazione
Il template si basa sul Modulo:Bio. Per configurare le attività e nazionalità utilizzabili nei parametri Attività/Attività2/Attivita3 e Nazionalità/NazionalitàNaturalizzato/Cittadinanza occorre modificare:
- Modulo:Bio/Link attività: per la conversione dall'attività scritta nell'incipit (che può essere scritta a seconda dei casi al maschile o al femminile) nella forma utilizzata nei link (tipicamente il maschile dell'attività, ma può essere utilizzata qualsiasi voce).
- Modulo:Bio/Link nazionalità: per la conversione dalla nazionalità scritta nell'incipit alla voce della nazione relativa (che viene usata come link).
- Modulo:Bio/Plurale attività: per la conversione dal singolare (maschile o femminile) usato nell'incipit al plurale maschile usato nelle categorie.
- Modulo:Bio/Plurale nazionalità: per la conversione dal singolare (maschile o femminile) usato nell'incipit al plurale maschile usato nelle categorie.
- Modulo:Bio/Configurazione: contiene ulteriori parametri di configurazione, come gli articoli maschili e femminili da utilizzare con le attività.
Quando il template segnala che un'attività non è presente nelle tabelle occorre aggiornare le stesse inserendo l'attività richiesta e la relativa conversione.
Note
- ↑ 1,0 1,1 Vedi sondaggio
- ↑ 2,0 2,1 2,2 2,3 Si usa il calendario gregoriano per tutte le date, ove non sia specificato l'uso del calendario giuliano.
Dati per VisualEditor
La tabella TemplateData che segue è contenuta nella sottopagina Template:Bio/TemplateData (modifica·cronologia)
Questo template serve per inserire i principali dati biografici nelle voci dedicate a una persona. Va inserito nella sezione iniziale della voce, all'inizio del testo, preceduto soltanto da eventuali altri template.
Parametro | Descrizione | Tipo | Stato | |
---|---|---|---|---|
Titolo | Titolo | Eventuali titoli (Lord, Sir, padre, dott. e così via). | Stringa | facoltativo |
Nome | Nome | Nome della persona, in maniera omogenea con il titolo della voce | Stringa | obbligatorio |
Cognome | Cognome | Cognome della persona, in maniera omogenea con il titolo della voce | Stringa | facoltativo |
Pseudonimo | Pseudonimo | Eventuale pseudonimo | Stringa | facoltativo |
PostPseudonimo | PostPseudonimo | testo aggiunto dopo lo pseudonimo, per contenere lo pseudonimo in lingua originale | Stringa | facoltativo |
Cognome prima del nome | CognomePrima | Se Cognome va visualizzato prima di Nome, come in certe lingue orientali, indicare il nome della lingua | Stringa | facoltativo |
Precisazioni dopo il cognome | PostCognome | Testo aggiunto dopo il cognome, separato da spazio; può contenere il nome in lingua originale, lo pseudonimo (se la voce è intitolata al nome reale) o l'indicazione del nome reale (se la voce è intitolata allo pseudonimo), gli eventuali titoli nobiliari. Per i nomi giapponesi si utilizzi il template {{Nihongo}} con la seguente sintassi: {{Nihongo||<nome in giapponese>|<traslitterazione>}}. | Stringa | facoltativo |
Precisazioni dopo il cognome (fra virgole) | PostCognomeVirgola | Alternativo a 'Precisazioni dopo il cognome', ha lo stesso utilizzo ma racchiude il testo aggiuntivo tra due virgole. | Stringa | facoltativo |
Forza ordinamento | ForzaOrdinamento | Da compilare quando la sequenza nome + cognome non corrisponde esattamente al titolo della voce (ad esempio 'Sarah Louise Heath Palin' alla voce Sarah Palin). Non è necessario invece per la sola rimozione di caratteri speciali da Nome e Cognome, perché è eseguita automaticamente dal template. Si utilizzi la sintassi 'cognome del titolo ,nome del titolo'. NOTA IMPORTANTE: lo spazio da inserire dopo il cognome e prima della virgola è intenzionale, non è un errore di battitura. | Stringa | facoltativo |
Frase pre-data | PreData | testo aggiunto dentro le parentesi, prima del luogo/data di nascita; ove ritenuto opportuno, serve per inserire la trascrizione fonetica del nome o le versioni in altre lingue del nome | Stringa | facoltativo |
Sesso | Sesso | Scegliere tra: M / F. Determina solo il genere grammaticale della frase, quindi non occorrono altri valori. | Stringa | obbligatorio |
Luogo di nascita | LuogoNascita | Inserire solo il nome della città senza wikilink, es. 'Roma', se sconosciuto lasciare il campo vuoto. | Stringa | facoltativo |
Luogo di nascita (link) | LuogoNascitaLink | Va usato quando si vuole forzare il wikilink ad una voce diversa da LuogoNascita, va usato quando LuogoNascita punterebbe a una disambigua o a una voce sbagliata. Es. San Paolo deve puntare alla voce [[San Paolo (città)]], non a [[San Paolo]] (il santo). | Stringa | facoltativo |
Luogo di nascita (alternativo) | LuogoNascitaAlt | Permette di inserire un luogo di nascita alternativo o altre indicazioni simili. Viene separato da LuogoNascita da uno spazio. Non linka automaticamente il contenuto, eventuali wikilink devono essere inseriti manualmente. Se 'Luogo di nascita' non è presente questo parametro viene ignorato. Non va assolutamente usato per indicare provincia e/o nazione del luogo di nascita. | Stringa | facoltativo |
Giorno e mese di nascita | GiornoMeseNascita | Se conosciuta, inserire solo la data senza wikilink, es. '13 settembre', se sconosciuta lasciare il campo vuoto. Se incerta inserire un testo qualsiasi con wikilink manuali, es. '[[13 settembre|13]] o [[14 settembre]]' | Stringa | facoltativo |
Anno di nascita | AnnoNascita | Inserire solo l'anno senza wikilink, es. '1888', se sconosciuto lasciare il campo vuoto | Stringa | facoltativo |
Note sulla nascita | NoteNascita | Permette di aggiungere annotazioni alla data di nascita. Il testo viene inserito immediatamente dopo l'anno, senza separatori, per consentire l'uso di note; se invece serve uno spazio utilizzare {{sp}} | Stringa | facoltativo |
Luogo di morte | LuogoMorte | Va compilato anche quando le località di nascita e di morte coincidono, se sconosciuto lasciare il campo vuoto. Non inserire indicazioni come 'ivi' | Stringa | facoltativo |
Luogo Morte (link) | LuogoMorteLink | Analogo a 'Luogo di nascita (link)' | Stringa | facoltativo |
Luogo Morte (alternativo) | LuogoMorteAlt | Analogo a 'Luogo di nascita (alternativo)' | Stringa | facoltativo |
Giorno e mese di morte | GiornoMeseMorte | Analogo a 'Giorno e mese di nascita' | Stringa | facoltativo |
Anno di morte | AnnoMorte | Analogo a 'Anno di Nascita', ma se sconosciuto inserire '?' (è necessario compilare il campo nel caso di persone sicuramente morte anche qualora la data di morte sia sconosciuta). | Stringa | facoltativo |
Note sulla morte | NoteMorte | Analogo a 'Note sulla nascita' | Stringa | facoltativo |
Frase pre-attività | PreAttività | Un'eventuale frase prima dell'elenco delle attività, il suo utilizzo sostituisce l'inserimento automatico di 'è un', 'è stato un', 'è una' e così via. NB: utilizzare solo in casi particolari e NON per cambiare il tempo verbale ('fu un' o simile); si è scelto di usare il passato prossimo anche per personaggi antichi, poiché non si considera la mera distanza cronologica. | Stringa | facoltativo |
Attività | Attività | Deve essere compresa nell'elenco di attività esistenti. Usare il minuscolo e la concordanza del genere (es. compositore per un uomo, compositrice per una donna). In caso di più attività aggiungere i parametri 'Attività 2' e 'Attività 3' | Stringa | obbligatorio |
Attività 2 | Attività2 | Seconda attività, funzionamento analogo a 'Attività' | Stringa | facoltativo |
Attività 3 | Attività3 | Terza attività, funzionamento analogo a 'Attività' | Stringa | facoltativo |
Attività (altre) | AttivitàAltre | Parametro da usare eccezionalmente (si vedano le convenzioni per voci biografiche); le attività contenute in questo parametro non vengono categorizzate, ed eventuali wikilink vanno inseriti a mano. Il parametro viene inserito immediatamente dopo l'ultima attività categorizzata per permettere di usare una virgola come separatore; qualora si volesse inserire uno spazio usare il template {{sp}}. | Stringa | facoltativo |
Epoca | Epoca | Permette la sottocategorizzazione per secolo di attività, può contenere i valori: 0, 100, 200, ... 1800, 1900, 2000 oppure I, II, III, ... XIX, XX, XXI. Utilizzare solo se prevista categorizzazione per secolo (es. scrittori). Il template controlla l'esistenza della categoria per secolo, se non esiste il link viene fatto alla categoria senza il secolo | Stringa | facoltativo |
Epoca 2 | Epoca2 | Da utilizzare per persone che hanno vissuto a cavallo di secoli diversi | Stringa | facoltativo |
Nazionalità | Nazionalità | Deve essere compresa nell'elenco di nazionalità esistenti. Usare il minuscolo singolare e la concordanza del genere (es. italiano per un uomo, italiana per una donna). | Stringa | obbligatorio |
Nazionalità (naturalizzato) | NazionalitàNaturalizzato | Da usare nei casi di cambio di nazionalità o nazionalità multipla, funzionamento come 'Nazionalità'. | Stringa | facoltativo |
Cittadinanza | Cittadinanza | Da usare nei casi di nazionalità culturale differente dalla nazionalità anagrafica (es. Curdi di Turchia), funzionamento come 'Nazionalità'. | Stringa | facoltativo |
Categorie | Categorie | Se 'no', permette di disattivare la categorizzazione automatica della voce per 'Attività' e 'Nazionalità'. La categoria BioBot e le categorie per data/luogo di nascita/morte vengono comunque aggiunte. Eventuali categorie alternative vanno aggiunte a mano nella consueta posizione in coda alla voce. | Stringa | facoltativo |
Precisazioni dopo la nazionalità | PostNazionalità | Precisazioni dopo la nazionalità, il testo viene inserito immediatamente dopo la nazionalità per permettere di usare una virgola come separatore. Qualora si volesse inserire uno spazio usare il template {{sp}}. Non è necessario inserire il punto alla fine (il template lo aggiunge in automatico). Non inserire più di un periodo, dopo il primo punto basta semplicemente continuare fuori dal template Bio. | Stringa | facoltativo |
Punto | Punto | Se 'no', elimina il punto finale. | Stringa | facoltativo |
Fine Incipit | FineIncipit | Sostituisce completamente la generazione automatica della parte dell'incipit che segue le parentesi della data. Lo spazio iniziale e il punto finale rimangono. Se compilate, le attività e le nazionalità vengono comunque usate per la categorizzazione e sono disponibili per le liste generate dal BioBot. Se non è possibile compilare i campi Attività e Nazionalità, è necessario compilare sia Fine Incipit sia Categorie, altrimenti compare un messaggio di errore. Questo parametro va usato solo in casi eccezionali e possibilmente discutendo la cosa preventivamente nelle pagine del progetto. | Stringa | facoltativo |
Immagine | Immagine | Inserire solo il nome del file, es. 'prova.jpg' | File | facoltativo |
Dimensione Immagine | DimImmagine | Dimensione orizzontale dell'immagine, in pixel, da usare solo in caso di immagini di forma particolarmente oblunga. Inserire solo il numero, senza px alla fine. | Numero | facoltativo |
Didascalia | Didascalia | Didascalia dell'immagine, da compilare solo se diversa da Nome + Cognome che viene generato in automatico. | Stringa | facoltativo |
Didascalia 2 | Didascalia2 | Ulteriore didascalia riportata sotto la precedente, si consiglia di inserire qui un eventuale template {{premio}}. A differenza di Didascalia, questo parametro funziona anche quando non è presente un'immagine, facendo comunque apparire un riquadro. | Stringa | facoltativo |