Bewaar de aangepaste regels in het vervangende bestand en behoud de ID van je aangepaste stijl voor latere revisies. Geef een stijlopmaak uit een repository bij de eerste aanpassing een eigen titel en ID, zodat upstream-updates je wijzigingen niet overschrijven.

Deze werkwijze is bedoeld voor Mac-desktopgebruikers die al een aangepaste citatiestijl hebben en een herziene versie willen installeren zonder hun opmaakkeuzes te verliezen. De sleutel is om zowel de identiteit van de stijl als de volledige aangepaste inhoud te behouden. De installatiecode van Zotero vervangt een bestaand stijlbestand; eerder aangebrachte opmaakwijzigingen worden niet samengevoegd met het binnenkomende bestand. Bron voor stijlinstallatie van Zotero

Wat moet hetzelfde blijven wanneer je een aangepaste stijl vervangt?

Bepaal voordat je de metadata bewerkt of je dezelfde aangepaste stijl herziet of een apart alternatief maakt. CSL definieert de stijl-ID als een stabiele, unieke identificatie. Zotero adviseert uitdrukkelijk om de titel en ID te wijzigen wanneer je een aangepaste kopie van een bestaande stijl maakt, omdat die bewerkingen kwetsbaar zijn voor updates van de oorspronkelijke stijl als je de oorspronkelijke identiteit behoudt. CSL 1.0.2-specificatie: Info, CSL-stijlen bewerken — stapsgewijze handleiding

Je taak Te gebruiken identiteit Te installeren bestandsinhoud
Een stijlopmaak uit een repository voor het eerst aanpassen Een eigen aangepaste titel en ID De volledige stijl met je wijzigingen
Je bestaande aangepaste stijl herzien De bestaande aangepaste ID; behoud de herkenbare titel De volledige herziene aangepaste stijl
Een afzonderlijk experimenteel alternatief maken Een eigen titel en ID Een afzonderlijke volledige stijl
Een nieuwere upstream-versie overnemen Je aangepaste identiteit in het voltooide vervangende bestand De nieuwere regels plus de aangepaste regels die je bewust wilt behouden

Beschouw de laatste rij als een handmatige vergelijking. Een vervanging die je ergens anders downloadt, kan geen wijzigingen bevatten die alleen in je oudere lokale kopie staan. Bewaar dat oudere bestand totdat je de uitvoer van de vervanging hebt vergeleken.

Alleen de bestandsnaam wijzigen is niet genoeg. De huidige installatie-implementatie van Zotero zoekt naar een bestaande stijl op basis van de ID en controleert daarnaast op conflicten in bestandsnaam en titel. Geef een afzonderlijke variant zowel een eigen titel als een eigen ID en controleer het installatiedialoogvenster voordat je doorgaat. Bron voor stijlinstallatie van Zotero

Sla de daadwerkelijke regels op voordat je de vervanging voorbereidt

Open je bekende, werkende aangepaste stijl en sla een volledige kopie op buiten de editor. Een praktische indeling is een werkbestand met de naam neutral-notes.csl en een gearchiveerde kopie met de naam neutral-notes-before-revision.csl. Deze bestandsnamen zijn organisatorische suggesties; de ingesloten ID bepaalt de identiteit van de stijl.

Gebruik platte tekst. Kies in Teksteditor Opmaak → Maak platte tekst en zorg ervoor dat de opgeslagen bestandsnaam eindigt op .csl. De bewerkingshandleiding van Zotero raadt aan om in platte tekst te werken en regelmatig op te slaan. CSL-stijlen bewerken — stapsgewijze handleiding

Als je wijzigingen alleen in Zotero’s Style Editor staan, sla ze dan op voordat je een andere stijl selecteert of het venster sluit. De documentatie van de editor waarschuwt dat beide handelingen niet-opgeslagen wijzigingen verloren laten gaan. Een correcte voorbeeldweergave is dus slechts een tussenresultaat. Zotero Style Editor

Controleer of het bestand opmaakinstructies bevat

Een afhankelijke CSL-stijl is een alias: deze verwijst naar een onafhankelijke bovenliggende stijl waarvan de citatieopmaak wordt gebruikt. Als je bestand hoofdzakelijk uit metadata en een koppeling naar independent-parent bestaat, haal dan de bovenliggende stijl op als uitgangspunt voor je aangepaste, onafhankelijke kopie. De alias een andere naam geven, maakt geen ruimte voor afzonderlijke opmaakregels. Inleiding — kennismaking met CSL

Controleer bij een onafhankelijke stijl de relevante elementen citation, bibliography en macro. Daarin staan de opmaakinstructies. Behoud bij een bestaande aangepaste revisie de id; geef een nieuwe afsplitsing een unieke identiteit. De huidige stabiele specificatie beveelt UUID’s aan voor nieuwe stijl-ID’s, maar erkent ook bestaande URI-gebaseerde ID’s. CSL 1.0.2-specificatie

Leg je wijzigingen vast in een compacte set opmaakverwachtingen

Noteer voordat je iets vervangt een paar exacte verwachte resultaten. Zo kun je herhaalbaar controleren of een regel ontbreekt, zelfs wanneer de vervanging succesvol wordt geïnstalleerd. Gebruik synthetische gegevens van een werk zodat de test eenvoudig te controleren blijft.

Stel bijvoorbeeld dat je aangepaste bibliografieregel een uitgever en plaatsnaam met een komma scheidt en het resultaat tussen haakjes zet. Definieer de volgende controles voor het uitgeversgedeelte van een synthetisch boek met de titel Vormcatalogus:

Test Synthetische metadata Verwacht uitgeversgedeelte
Beide velden ingevuld Uitgever: Example Press; plaats: Sample Town (Example Press, Sample Town)
Alleen de uitgever Uitgever: Example Press; plaats leeg (Example Press)
Alleen de plaats Uitgever leeg; plaats: Sample Town (Sample Town)
Beide velden leeg Uitgever en plaats leeg Geen uitgeversgedeelte

Het volgende is een opmaakfragment voor dat gedeelte, geen volledige installeerbare stijl. Het hoort op de juiste plek voor opmaak in je bestaande bibliografielay-out of in een macro die daardoor wordt aangeroepen. Vervang het oude uitgeversgedeelte in plaats van een tweede exemplaar toe te voegen:

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

De groep levert het scheidingsteken en de omringende leestekens. CSL onderdrukt de groep wanneer alle variabelen waarnaar wordt verwezen leeg zijn. De bewerkingshandleiding van Zotero gebruikt dit patroon om problemen met leestekens te voorkomen wanneer een veld ontbreekt. Deze verwachte resultaten zijn afgeleid van de specificatie; ze zijn hier niet op een desktop getest. CSL 1.0.2-specificatie: Group, CSL-stijlen bewerken — stapsgewijze handleiding

Maak vergelijkbare controles voor je daadwerkelijke wijzigingen: scheidingstekens tussen auteurs, titelopmaak, de plaatsing van datums of een andere specifieke regel. Noteer of elke verwachting betrekking heeft op een tekstcitaat, een bibliografie-item of beide. Behoud ook één ongewijzigd voorbeeld om onbedoelde wijzigingen buiten het bewerkte gedeelte op te sporen.

Installeer en controleer de vervanging op je Mac

Open Zotero → Instellingen en selecteer vervolgens Cite. Op de Mac bevindt de optie Instellingen zich volgens de documentatie in het applicatiemenu. Hoe wijzig ik de instellingen van Zotero?

Volg deze stappen om opslaan, testen en installeren afzonderlijk te houden:

  1. Selecteer je synthetische testitems in de Zotero-bibliotheek.
  2. Open Style Editor vanuit Cite en laad of plak de volledige herziene stijl.
  3. Klik op Refresh om de geselecteerde items te gebruiken en vergelijk de voorbeeldweergave met je opmaakverwachtingen.
  4. Sla het volledige bewerkte .csl-bestand op en valideer het tegen het CSL-schema voordat je het installeert.
  5. Klik in de Style Manager op + en kies dat opgeslagen bestand.
  6. Controleer het installatiedialoogvenster en installeer vervolgens de bedoelde revisie.
  7. Open de geïnstalleerde stijl opnieuw en herhaal dezelfde uitvoercontroles.

De editor verwerkt geselecteerde bibliotheekitems en werkt de voorbeeldweergave bij terwijl je wijzigingen aanbrengt. De editor kan ongeldige XML melden, maar een voorbeeldweergave op zichzelf bewijst niet dat de CSL geldig is; de documentatie raadt aan de stijl te valideren. Lokale bestandsinstallatie via + wordt afzonderlijk beschreven in de stijlinstructies van Zotero. Zotero Style Editor, Citatiestijlen

Begin bij latere revisies met het opgeslagen aangepaste bestand dat deze controles heeft doorstaan. Als je in plaats daarvan begint met een nieuwer upstream-bestand, vergelijk het dan met je gearchiveerde aangepaste kopie en pas de benodigde regels bewust opnieuw toe voordat je het installeert.

Waarom toont Word nog steeds de oude opmaak?

Een stijl installeren en deze voor een Word-document selecteren zijn twee afzonderlijke stappen. Open in Word het tabblad Zotero, kies Document Preferences en selecteer je aangepaste stijl. Gebruik vervolgens Refresh en controleer zowel een citaat als de bibliografie. Zotero beschrijft Document Preferences als de instelling om de citatiestijl van een document te wijzigen. De Zotero Word-plugin gebruiken

Los een terugkerende stijlregel niet op door de bibliografie in Word handmatig te overschrijven. Zotero vermeldt dat handmatige wijzigingen in de bibliografie bij het vernieuwen worden overschreven. Bewaar herhaalbare opmaakregels in het CSL-bestand. De Zotero Word-plugin gebruiken

Gebruik de plek waar het misgaat om te bepalen wat je vervolgens controleert:

Wat je ziet Wat je vervolgens controleert
De opgeslagen vervangende versie bevat je wijziging niet Haal de regel terug uit de gearchiveerde werkkopie
De voorbeeldweergave in de editor voldoet niet aan je verwachtingen Controleer de opmaakregel en de velden van de testitems
De voorbeeldweergave klopt, maar de geïnstalleerde stijl niet Controleer welk opgeslagen bestand je hebt geïnstalleerd en open vervolgens die geïnstalleerde stijl opnieuw
De voorbeeldweergave van de geïnstalleerde stijl in Zotero klopt, maar Word wijkt af Controleer welke stijl voor het document is geselecteerd en vernieuw het document
Een afzonderlijke variant vervangt onverwacht een andere stijl Vergelijk de ingesloten ID’s en titels

Bewaar het volledige werkende CSL-bestand, de stabiele aangepaste identiteit en de kleine set verwachte resultaten bij elkaar. Wanneer de volgende revisie verschijnt, kun je met die drie zaken de regels bewust meenemen en de vervanging controleren voordat je erop vertrouwt.

Bronnen