Per mantenere le regole CSL di Zotero modificate, salvale nel file sostitutivo e conserva l’ID del tuo stile personalizzato per le revisioni future. Quando personalizzi per la prima volta uno stile del repository, assegnagli un titolo e un ID distinti per proteggere le tue modifiche dagli aggiornamenti a monte.

Questo flusso di lavoro è pensato per chi usa Zotero su un Mac e ha già uno stile di citazione personalizzato, che desidera sostituire con una versione aggiornata senza perdere le scelte di formattazione. La chiave è conservare sia l’identità dello stile sia tutti i suoi contenuti modificati. Il codice di installazione di Zotero sostituisce il file di uno stile esistente; non unisce le modifiche di formattazione precedenti al file in arrivo. Fonte del codice di installazione degli stili Zotero

Cosa dovrebbe rimanere invariato quando sostituisci uno stile personalizzato?

Prima di modificarne i metadati, decidi se vuoi revisionare lo stesso stile personalizzato o creare un’alternativa separata. CSL definisce l’ID dello stile come un identificatore stabile e univoco. Zotero consiglia esplicitamente di cambiare titolo e ID quando si crea una copia personalizzata di uno stile esistente, perché mantenere l’identità originale espone le modifiche agli aggiornamenti dello stile originale. Specifica CSL 1.0.2: informazioni, Modifica degli stili CSL — guida passo passo

La tua attività Identità da usare Contenuto del file da installare
Prima personalizzazione di uno stile del repository Un titolo e un ID personalizzati distinti Lo stile completo con le tue modifiche
Revisione di uno stile personalizzato esistente Il suo ID personalizzato esistente; mantieni un titolo riconoscibile Lo stile personalizzato completo e revisionato
Alternativa sperimentale separata Un titolo e un ID distinti Uno stile completo separato
Adozione di una versione a monte più recente La tua identità personalizzata nella versione sostitutiva finale Le regole più recenti e le modifiche personalizzate che scegli di mantenere

Considera l’ultima riga un’attività di confronto manuale. Una versione sostitutiva scaricata altrove non può contenere modifiche presenti solo nella tua vecchia copia locale. Conserva il vecchio file finché non hai confrontato il risultato della sostituzione.

Cambiare solo il nome del file non basta. L’attuale implementazione di installazione di Zotero cerca uno stile esistente in base all’ID e controlla anche eventuali conflitti con il nome del file e il titolo. Assegna a una variante separata un titolo e un ID distinti e controlla la finestra di dialogo dell’installazione prima di procedere. Fonte del codice di installazione degli stili Zotero

Salva le regole effettive prima di preparare la sostituzione

Apri lo stile personalizzato che sai funzionare e salvane una copia completa al di fuori dell’editor. Un’organizzazione pratica prevede un file di lavoro chiamato neutral-notes.csl e una copia archiviata chiamata neutral-notes-before-revision.csl. Questi nomi di file sono suggerimenti organizzativi: l’ID incorporato stabilisce l’identità dello stile.

Usa testo semplice. In TextEdit, scegli Formato → Converti in testo semplice e assicurati che il nome del file salvato termini in .csl. La guida di Zotero consiglia di modificare file di testo semplice e di salvarli spesso. Modifica degli stili CSL — guida passo passo

Se le modifiche esistono solo nello Style Editor di Zotero, salvale prima di selezionare un altro stile o chiudere la finestra. La documentazione dell’editor avverte che entrambe le azioni fanno perdere le modifiche non salvate. Un’anteprima corretta è quindi solo un risultato intermedio. Editor degli stili di Zotero

Controlla se il file contiene istruzioni di formattazione

Uno stile CSL dipendente è un alias: fa riferimento a uno stile principale indipendente, di cui usa il formato di citazione. Se il tuo file è composto soprattutto da metadati e da un collegamento independent-parent, usa lo stile principale come base per la tua copia indipendente personalizzata. Rinominare l’alias non crea uno spazio in cui inserire regole di formattazione separate. Introduzione — panoramica di CSL

In uno stile indipendente, controlla gli elementi pertinenti citation, bibliography e macro. Contengono le istruzioni di resa. Per revisionare uno stile personalizzato esistente, conserva il suo id; per crearne una variante, assegna un’identità univoca. La specifica stabile attuale raccomanda gli UUID per i nuovi ID degli stili, pur riconoscendo gli ID URI esistenti. Specifica CSL 1.0.2

Trasforma le modifiche in un piccolo contratto di resa

Prima di sostituire qualsiasi cosa, annota alcuni risultati attesi precisi. In questo modo avrai un controllo ripetibile per rilevare una regola mancante anche se l’installazione della versione sostitutiva riesce. Usa metadati fittizi per le opere, così i risultati restano facili da esaminare.

Per esempio, supponiamo che la regola personalizzata della bibliografia separi l’editore e il luogo con una virgola e racchiuda il risultato tra parentesi. Definisci i seguenti controlli per la parte relativa all’editore di un libro fittizio intitolato Shape Catalogue:

Test Metadati fittizi Parte attesa relativa all’editore
Entrambi i campi compilati Editore: Example Press; luogo: Sample Town (Example Press, Sample Town)
Solo l’editore Editore: Example Press; luogo vuoto (Example Press)
Solo il luogo Editore vuoto; luogo: Sample Town (Sample Town)
Entrambi i campi vuoti Editore e luogo vuoti Nessuna parte relativa all’editore

Il frammento seguente riguarda la resa di quella parte, non è uno stile completo installabile. Va inserito nella posizione di resa appropriata all’interno del layout bibliografico esistente o di una macro richiamata da esso. Sostituisci la vecchia parte relativa all’editore invece di aggiungerne una seconda copia:

<group delimiter=", " prefix="(" suffix=")">
  <text variable="publisher"/>
  <text variable="publisher-place"/>
</group>

Il gruppo fornisce il separatore e la punteggiatura circostante. CSL omette il gruppo quando tutte le variabili a cui fa riferimento sono vuote. La guida di modifica di Zotero usa questo schema per evitare problemi di punteggiatura quando manca un campo. Questi risultati attesi derivano dalla specifica e non da un test eseguito qui su un computer. Specifica CSL 1.0.2: Group, Modifica degli stili CSL — guida passo passo

Crea controlli equivalenti per le tue modifiche effettive: separatori tra autori, formattazione dei titoli, posizione delle date o un’altra regola specifica. Indica se ogni risultato atteso riguarda una citazione nel testo, una voce bibliografica o entrambe. Conserva anche un esempio non modificato per rilevare cambiamenti accidentali al di fuori della parte modificata.

Installa e verifica la versione sostitutiva sul Mac

Apri Zotero → Impostazioni, quindi seleziona Cita. Su Mac, il menu dell’applicazione è la posizione documentata per accedere alle impostazioni. Come posso modificare le impostazioni di Zotero?

Segui questi passaggi per tenere separate le operazioni di salvataggio, test e installazione:

  1. Seleziona gli elementi di test fittizi nella libreria di Zotero.
  2. Apri Style Editor da Cite e carica o incolla lo stile revisionato completo.
  3. Fai clic su Refresh per usare gli elementi selezionati, poi confronta l’anteprima con il tuo contratto di resa.
  4. Salva il file .csl completo con le modifiche e convalidalo rispetto allo schema CSL prima dell’installazione.
  5. In Style Manager, fai clic su + e scegli il file salvato.
  6. Controlla la finestra di dialogo dell’installazione, poi installa la revisione desiderata.
  7. Riapri lo stile installato e ripeti gli stessi controlli dei risultati.

L’editor elabora gli elementi selezionati nella libreria e aggiorna l’anteprima mentre modifichi lo stile. Può segnalare XML non valido, ma la sola anteprima non garantisce che il CSL sia valido; la documentazione indica di convalidare lo stile. L’installazione da un file locale tramite + è descritta separatamente nelle istruzioni sugli stili di Zotero. Editor degli stili di Zotero, Stili di citazione

Per le revisioni future, parti dal file personalizzato salvato che ha superato questi controlli. Se invece parti da un file a monte più recente, confrontalo con la copia personalizzata archiviata e riapplica deliberatamente le regole necessarie prima dell’installazione.

Perché Word mostra ancora la vecchia formattazione?

Installare uno stile e selezionarlo per un documento Word sono passaggi distinti. Nella scheda Zotero di Word, apri Document Preferences e seleziona il tuo stile personalizzato. Poi usa Refresh ed esamina sia una citazione sia la bibliografia. Zotero indica Document Preferences come il controllo per modificare lo stile di citazione di un documento. Usare il plugin Zotero per Word

Non correggere una regola di stile ricorrente sovrascrivendo il testo della bibliografia in Word. Zotero specifica che le modifiche manuali alla bibliografia vengono sovrascritte con l’aggiornamento. Inserisci le regole di formattazione ripetibili nel file CSL. Usare il plugin Zotero per Word

Usa il punto in cui si verifica il problema per scegliere il controllo successivo:

Cosa osservi Cosa controllare dopo
Il file sostitutivo salvato non contiene la tua modifica Recupera la regola dalla copia di lavoro archiviata
L’anteprima dell’editor non rispetta il contratto Controlla la regola di resa e i campi degli elementi di test
L’anteprima è corretta, ma lo stile installato non lo è Verifica quale file salvato hai installato, poi riapri lo stile installato
L’anteprima dello stile installato in Zotero è corretta, ma Word mostra un risultato diverso Controlla lo stile selezionato nel documento e aggiornalo
Una variante separata sostituisce inaspettatamente un altro stile Confronta gli ID e i titoli incorporati

Conserva insieme il file CSL completo di lavoro, la sua identità personalizzata stabile e il piccolo insieme di risultati attesi. Quando arriverà la prossima revisione, questi tre elementi ti permetteranno di trasferire le regole con attenzione e verificare la versione sostitutiva prima di farvi affidamento.

Fonti