Geef bewerkte meerdelige boeken in Zotero op een Mac een eigen opmaak door een voorwaardelijke vertakking aan een CSL-stijl toe te voegen. Deze handleiding richt zich op afzonderlijke delen met redacteuren en zonder auteur, met synthetische metadata en een complete demonstratiestijl.

Bepaal welke boeken de speciale opmaak moeten krijgen

CSL gebruikt book voor boeken met auteurs, geredigeerde verzamelbundels, volledige meerdelige werken en afzonderlijke delen. De gedocumenteerde typelijst bevat geen apart type voor bewerkte meerdelige boeken. De ondersteunde aanpak is om de metadata van het boek binnen een stijl te testen. CSL 1.0.2 Specification

Voor deze handleiding is de opmaakafspraak bewust specifiek: een book met een editor, een volume en zonder author krijgt een bibliografie-item dat met de titel begint. Alle andere records krijgen het gewone item uit de demonstratie, dat met de maker begint. Dit is een illustratieve opmaakkeuze, geen voorgeschreven citatiestandaard.

Het speciale item volgt deze volgorde: cursieve titel, namen van de redacteur en rolaanduiding, deelnummer, daarna plaats van uitgave, uitgever en jaar. De beoogde uitvoer voor het onderstaande synthetische record is bijvoorbeeld:

Collected Shape Exercises. Nora Vale, red. deel 2. Sampletown: Example Workshop Press, 2024.

Het onderscheid tussen een deel en een reeks is van belang. CSL’s volume duidt het specifieke deel aan; number-of-volumes vermeldt het totale aantal. Noch het aantal redacteuren, noch een getal in de titel maakt dat onderscheid duidelijk. CSL variable definitions

Voer een testrecord in met ondubbelzinnige metadata

Maak in Zotero een record van het type Book met de volgende synthetische waarden. Sla Nora Vale op als maker met de rol Editor en laat de auteur leeg. Zotero documenteert afzonderlijke makerrollen en maakt onderscheid tussen Volume en # of Volumes. Zotero Item Types and Fields

Zotero-veld Synthetische waarde
Item Type Book
Title Collected Shape Exercises
Makerrol Editor
Voornaam maker Nora
Achternaam maker Vale
Volume 2
# of Volumes 3
Place Sampletown
Publisher Example Workshop Press
Date 2024

Voer 2 in bij Volume, zonder vol. toe te voegen. De stijl levert het label. Hier duidt 2 het geciteerde deel aan en beschrijft 3 de volledige reeks. Zotero raadt aan numerieke deelwaarden als getallen in te voeren. Zotero’s book and periodical fields

Laat voor een afzonderlijk record dat de volledige reeks van drie delen voorstelt Volume leeg en behoud # of Volumes als 3. Volgens de afspraak in dit artikel volgt dat record de gewone route. Zo voorkomt u dat de bibliografie de reeks behandelt alsof het een specifiek genummerd deel is.

Maak een complete demonstratiestijl op uw Mac

Open Teksteditor en kies Format → Make Plain Text voordat u de code plakt. Sla het bestand op als edited-multivolume-demo.csl en controleer of de bestandsnaam eindigt op .csl. Zotero’s bewerkingsgids beschrijft expliciet het bewerken van platte tekst met Teksteditor op een Mac. Editing CSL Styles — Step-by-Step Guide

Hieronder staat een complete demonstratiestijl. De bibliografie past de bovenstaande afspraak toe; de citaties in de tekst tonen alleen de titel. Het gewone item is bewust beknopt gehouden. Gebruik dit bestand dus om de regel te begrijpen en te testen voordat u een bestaande stijl aanpast voor een bibliotheek met uiteenlopende records.

<?xml version="1.0" encoding="utf-8"?>
<style xmlns="http://purl.org/net/xbiblio/csl" version="1.0"
       class="in-text" default-locale="en-US">
  <info>
    <title>Edited Multivolume Books Demo</title>
    <id>urn:uuid:6b4f5d8c-7b20-4fea-92eb-6207d10d94e3</id>
    <updated>2026-10-29T12:13:38+00:00</updated>
  </info>
  <macro name="editors">
    <names variable="editor">
      <name and="text" delimiter=", "/>
      <label form="short" prefix=", "/>
    </names>
  </macro>
  <macro name="creators">
    <choose>
      <if variable="author">
        <names variable="author">
          <name and="text" delimiter=", "/>
        </names>
      </if>
      <else>
        <text macro="editors"/>
      </else>
    </choose>
  </macro>
  <macro name="extent">
    <choose>
      <if variable="volume">
        <group delimiter=" ">
          <label variable="volume" form="short"/>
          <text variable="volume"/>
        </group>
      </if>
      <else-if variable="number-of-volumes">
        <group delimiter=" ">
          <text variable="number-of-volumes"/>
          <label variable="number-of-volumes" form="short"/>
        </group>
      </else-if>
    </choose>
  </macro>
  <macro name="imprint">
    <group delimiter=", ">
      <group delimiter=": ">
        <text variable="publisher-place"/>
        <text variable="publisher"/>
      </group>
      <date variable="issued">
        <date-part name="year"/>
      </date>
    </group>
  </macro>
  <macro name="ordinary-entry">
    <group delimiter=". ">
      <text macro="creators"/>
      <text variable="title" font-style="italic"/>
      <text macro="extent"/>
      <text macro="imprint"/>
    </group>
  </macro>
  <macro name="entry">
    <choose>
      <if type="book" variable="editor volume" match="all">
        <choose>
          <if variable="author" match="none">
            <group delimiter=". ">
              <text variable="title" font-style="italic"/>
              <text macro="editors"/>
              <text macro="extent"/>
              <text macro="imprint"/>
            </group>
          </if>
          <else>
            <text macro="ordinary-entry"/>
          </else>
        </choose>
      </if>
      <else>
        <text macro="ordinary-entry"/>
      </else>
    </choose>
  </macro>
  <citation>
    <layout prefix="(" suffix=")" delimiter="; ">
      <text variable="title" font-style="italic"/>
    </layout>
  </citation>
  <bibliography>
    <layout suffix=".">
      <text macro="entry"/>
    </layout>
  </bibliography>
</style>

Het element updated is verplichte metadata in stijlbestanden. Hier registreert het de aanmaaktijd van deze demonstratie; het is geen publicatie- of controletijdstip van het artikel. Het hoofdelement gebruikt version="1.0", zoals voorgeschreven voor CSL 1.0-compatibele stijlen. CSL style structure

Begrijp de voorwaarde voordat u die wijzigt

De buitenste voorwaarde vereist een boek en beide ingevulde variabelen, omdat deze match="all" gebruikt. De binnenste voorwaarde vereist dat de auteur ontbreekt via match="none". Door de voorwaarden te nesten, wordt de combinatie uitgedrukt zonder dat de controle op afwezigheid op de andere voorwaarden van toepassing is. CSL conditional rendering

De resulterende beslistabel is de praktische controle voor deze specifieke implementatie:

Record Speciaal item met titel voorop? Reden
Boek, redacteur, deel 2, geen auteur Ja Voldoet aan alle vereisten
Boek, redacteur, deel 1, geen auteur Ja Ook een eerste deel voldoet aan de afspraak
Boek, redacteur, geen deel, reeks van drie delen Nee Vertegenwoordigt volgens deze conventie de reeks
Boek, auteur, redacteur, deel 2 Nee Er is een auteur opgegeven
Boek, deel 2, geen redacteur Nee Er is geen redacteur opgegeven
Boeksectie met redacteur en deel Nee Het itemtype is niet book

Deze voorwaarde controleert of metadata aanwezig is. Ze kan niet vaststellen of een geïmporteerd record het bedoelde object correct beschrijft. Controleer de titel- en deelvelden voordat u de regel op veel records toepast.

CSL 1.0.2 biedt ook geen algemene numerieke voorwaarde voor groter-dan. number-of-volumes op aanwezigheid testen zou zowel een ingevulde waarde van 1 als 3 laten overeenkomen; is-numeric lost die vergelijking niet op. Als u de regel uitbreidt naar volledige reeksen, spreek dan eerst een consistente metadataconventie af in plaats van aanwezigheid te beschouwen als bewijs van meerdere delen. CSL condition definitions

De macro extent in de demonstratie geeft voorrang aan het specifieke deel als beide velden zijn ingevuld. Daarom wordt in het voorbeeld deel 2 weergegeven en niet ook het totaal van de reeks. De gewone makermacro geeft eveneens de voorkeur aan een auteur boven redacteuren. Dit zijn expliciete vereenvoudigingen van dit voorbeeld; behoud bij aanpassing van uw eigen stijl eventuele aanvullende vereisten voor makers of omvang.

Bekijk een voorbeeld en test de grensgevallen

Selecteer het synthetische record in Zotero. Open in de Zotero-instellingen Cite en vervolgens Style Editor. Plak de volledige stijl in de editor en klik op Refresh om het geselecteerde bibliotheekitem te gebruiken. De editor toont citaties en bibliografie-items afzonderlijk en werkt het voorbeeld bij terwijl u bewerkingen uitvoert. Zotero Style Editor

Controleer of het bibliografie-item de titel in de bedoelde volgorde voorop zet. De citaatverwijzing in de tekst moet een titel tussen haakjes en in cursief blijven, omdat deze demonstratie de speciale regel alleen in de itemmacro van de bibliografie plaatst.

Maak vervolgens synthetische varianten die overeenkomen met de beslistabel. Voeg aan één record een auteur toe, verwijder het deel bij een ander en maak een record voor een volledige reeks. Geef elk een eigen neutrale titel, zodat u ze in het voorbeeld kunt herkennen. Controleer of alleen de records die aan de voorwaarden voldoen hun titels vóór de redacteuren krijgen.

De XML van het voorbeeld is tijdens de voorbereiding geparseerd en de macrokoppelingen zijn gecontroleerd. De stijl is niet weergegeven in de Mac-applicatie van Zotero. Voordat u het bestand installeert of aanpast, valideert u het volledige bestand met het CSL-schema via de validator waarnaar de ontwikkelgids van het project verwijst. Een controle van alleen de XML-syntaxis bevestigt niet dat het bestand geldig is volgens CSL. CSL Style Development — Validation

Sla uw code op voordat u de editor sluit of een andere geïnstalleerde stijl kiest: Zotero documenteert dat deze acties niet-opgeslagen bewerkingen verwijderen. Zotero Style Editor

Installeer de stijl of pas een bestaande stijl aan

Om het opgeslagen bestand te installeren, opent u de Zotero-instellingen voor Cite en gebruikt u de knop + in de stijlbeheerder om edited-multivolume-demo.csl te selecteren. In dezelfde instellingen vindt u Style Preview om geselecteerde records met geïnstalleerde stijlen te controleren. Zotero Cite settings

Begin bij een bestaande citatieopmaak met de huidige zelfstandige stijl. Een afhankelijke stijl verwijst alleen naar een bovenliggende stijl en bevat zelf geen opmaakinstructies. Primer — An Introduction to CSL

Behoud de gewone weergave van de bestaande stijl als terugvaloptie en voeg de speciale voorwaarde in vóór de bredere boekregel. Pas de speciale uitvoer aan aan de bestaande macro’s voor namen, titels en publicatiegegevens. Behoud de sortering, andere itemtypen en het citatiegedrag, tenzij die ook moeten worden gewijzigd. Zo kan de nieuwe vertakking één taak uitvoeren zonder de rest van de opmaak te vervangen.

Geef de aangepaste stijl vóór installatie een eigen titel en ID. Zotero waarschuwt dat een update de aangepaste versie kan overschrijven als de oorspronkelijke identiteit behouden blijft. Zotero’s style editing guide

Als het speciale item niet verschijnt, controleer dan het record aan de hand van de beslistabel voordat u interpunctie of macro’s wijzigt. Controleer de makerrol, deelwaarde, afwezigheid van een auteur en het itemtype. Zodra de records die aan de voorwaarden voldoen en de terugvalrecords zich gedragen zoals bedoeld, beschikt u over een herbruikbare opmaakregel met een duidelijk bereik: afzonderlijke bewerkte delen krijgen hun eigen bibliografieopmaak, terwijl andere records de gekozen gewone route blijven volgen.

Bronnen