Perché gli export di Zotero ed EndNote a volte non rispettano lo stile richiesto

Quando l'output sembra sbagliato, l'istinto è dare la colpa al file di stile. Spesso lo stile fa esattamente ciò per cui è stato scritto, con dati incompleti o classificati male. Ma i file di stile possono anche essere superati o rappresentare una variante locale diversa, quindi la prima domanda utile non è «Zotero è rotto?» bensì «quale livello ha fornito l'istruzione o il valore sbagliato?»

Uno stile CSL è un insieme di istruzioni: metti qui l'abbreviazione della rivista, metti il volume in corsivo, usa la maiuscola da frase per il titolo. Se l'elemento nella tua libreria non ha alcuna abbreviazione di rivista memorizzata, l'istruzione non ha nulla da collocare e lo stile ripiega sul titolo completo oppure lascia uno spazio vuoto. Nessuna delle due cose è un bug dello stile.

I gestori di riferimenti automatizzano la formattazione; non garantiscono che i metadati importati siano accurati. L'automazione rende coerenti i dati coerenti e rende quelli sbagliati sistematicamente sbagliati.

• Livello dei metadati: autore, titolo, data, contenitore, volume, fascicolo, pagine, DOI e lingua devono descrivere correttamente la fonte.
• Livello del tipo: l'elemento deve essere un articolo di rivista, un capitolo, un contributo a convegno, un set di dati o un altro tipo corretto, perché lo stile sappia quali campi applicare.
• Livello dello stile: lo stile CSL o di output installato deve corrispondere all'edizione richiesta e a ogni variante specifica della rivista.
• Livello del documento: i campi di citazione attivi devono restare collegati, aggiornati e privi di modifiche manuali che il prossimo aggiornamento sovrascriverà.

Un test rapido separa i primi due livelli dal terzo. Apri l'elemento nella libreria e confronta i campi grezzi con la fonte. Se l'autore o la data sono già sbagliati lì, cambiare stile non può ripararli. Se i campi sono corretti ma la punteggiatura o l'ordine divergono dall'esempio di riferimento, controlla lo stile e la variante selezionati.

Le abbreviazioni delle riviste sono una fonte frequente di non conformità nelle sottomissioni in ambito medico e chimico. Gli output in stile Vancouver richiedono di norma le abbreviazioni NLM e le riviste ACS possono richiedere le forme CASSI. Una regola generica di accorciamento non riesce a ricavare in modo affidabile nessuna di queste abbreviazioni controllate a partire da un qualsiasi titolo completo di rivista.

Il campo dipende molto da ciò che espongono la pagina dell'editore, un database o il traduttore del sito. I guasti più comuni sono un campo vuoto, il titolo completo copiato nel campo dell'abbreviazione, la punteggiatura presa dalla convenzione sbagliata, o un titolo vecchio rimasto dopo il cambio di nome della rivista. Due record dello stesso articolo possono quindi differire semplicemente perché uno arriva dalla pagina dell'editore e l'altro da un'esportazione di database.

Zotero può abbreviare automaticamente nella forma Index Medicus/MEDLINE quando il campo è vuoto, il che aiuta in medicina e non risolve le riviste ACS, le cui abbreviazioni portano punti che la convenzione medica omette.

La documentazione di Zotero spiega anche un'importante regola di precedenza: se il campo Journal Abbr è compilato, viene usato; l'abbreviazione MEDLINE automatica è in genere un ripiego quando quel campo è vuoto. Un valore memorizzato male può quindi prevalere su un risultato automatico migliore. Ispeziona l'elemento prima di pensare che il motore di abbreviazione abbia fallito.

• Per le forme NLM, verifica la rivista nel catalogo NLM invece di togliere i punti a occhio.
• Per la chimica, verifica le istruzioni della rivista di destinazione e la forma CASSI; non tutti gli stili editoriali seguono la stessa punteggiatura.
• Per le riviste rinominate, usa il titolo e l'abbreviazione adatti al fascicolo citato, non automaticamente il marchio attuale della rivista.
• Per i titoli non identificati, non inventare un'abbreviazione. Molti stili preferiscono il titolo completo quando non esiste una forma breve autorevole.

• Maiuscole e minuscole. L'APA vuole la maiuscola da frase per i titoli degli articoli; MLA e Chicago vogliono la maiuscola da titolo. I gestori memorizzano le maiuscole così come sono state acquisite. I database esportano in tutte le combinazioni e uno stile non può riscrivere in modo affidabile le maiuscole di un titolo che non sa analizzare, soprattutto se contiene nomi propri, acronimi e nomi di specie.
• Analisi dei nomi degli autori. «van der Berg», i cognomi con trattino, i nomi cinesi con il cognome per primo e gli autori con un solo nome vengono tutti divisi male in fase di importazione, e lo stile formatta poi le metà sbagliate.
• Tipo di elemento. Un contributo a convegno salvato come articolo di rivista verrà formattato come articolo di rivista, in modo impeccabile e sbagliato. Preprint, tesi, norme tecniche e set di dati sono le vittime abituali.
• Attualità dello stile. Il repository di stili di Zotero è mantenuto dalla comunità. Uno stile può restare indietro rispetto a un cambio di edizione: il passaggio da APA 6 a 7 ha eliminato la sede dell'editore e cambiato la soglia dell'et al. Uno stile superato produce un output coerente e obsoleto.
• Identificativi e localizzatori. Un DOI memorizzato con il prefisso URL, un numero di articolo messo nel campo delle pagine, o un record pubblicato prima online a cui manca il volume definitivo possono produrre duplicati o localizzatori malformati.
• Date ed edizioni. La pubblicazione sul web, la pubblicazione del fascicolo e la data di accesso sono campi diversi. Anche i libri hanno bisogno dell'edizione citata, non semplicemente dell'ultima edizione trovata online.
• Lingua e maiuscole protette. Gli stili non riescono a capire in modo affidabile che un acronimo, un simbolo di gene, un nome di luogo o un titolo non inglese debba conservare maiuscole insolite, a meno che i metadati non lo segnalino correttamente.

I duplicati rendono questi errori più difficili da vedere. Un record della libreria può contenere gli autori corretti mentre un altro, citato nel documento, ha ancora il titolo sbagliato. Unisci i duplicati dentro il gestore invece di cancellarne uno alla cieca, poi aggiorna il documento e conferma che ogni citazione punti ancora all'elemento sopravvissuto.

Le modifiche manuali nella bibliografia già generata sono fragili finché le citazioni restano attive. L'aggiornamento successivo può sovrascriverle, perché il gestore rigenera correttamente l'output a partire dai dati immutati della libreria. Se una correzione deve sopravvivere alle diverse bozze, falla nell'elemento o nello stile. Riserva le modifiche solo sull'output a una copia finale controllata.

Per un manoscritto in corso, correggere i metadati alla fonte è la mossa che dura: sistema l'elemento nella libreria e lo stile potrà renderlo bene ovunque quell'elemento compaia. Dai la priorità ai record citati invece di provare a ripulire un'intera libreria accumulata prima di una scadenza.

Per un manoscritto finito con cento o più riferimenti, usa una verifica basata sul rischio. Controlla ogni elemento alla ricerca di autore, anno, titolo, fonte e localizzatore mancanti; poi campiona la formattazione per tipo di fonte e scrutina i campi che lo stile di destinazione tratta in modo speciale. Cento articoli di rivista non richiedono gli stessi controlli di un elenco che mescola set di dati, norme tecniche, capitoli e siti web.

• Aggiorna prima. Risolvi gli avvisi del gestore di citazioni e conferma che la bibliografia sia generata dal documento attuale.
• Convalida i campi obbligatori. Ordina o filtra per trovare date, autori, titoli del contenitore, DOI e numeri di pagina o di articolo vuoti.
• Confronta gli esempi difficili. Usa la guida di destinazione per controllare un articolo con molti autori, un capitolo, una pagina web e ogni fonte specifica del settore.
• Scegli dove va fatta la correzione. Libreria per una verità riutilizzabile, stile per una regola, documento solo per un output finale una tantum.
• Congela solo una copia. Se le citazioni devono essere scollegate o convertite in testo statico, conserva una versione modificabile con i campi attivi.

Correggi la fonte di verità mentre il documento è attivo. Correggi un output statico solo quando capisci che i successivi aggiornamenti della libreria non erediteranno la modifica.