Dans Zotero sur Mac, appliquez une mise en forme distincte aux ouvrages collectifs en plusieurs volumes en ajoutant une branche conditionnelle à un style CSL. Ce guide porte sur les volumes individuels dirigés par des éditeurs et sans auteur, à partir de métadonnées fictives et d’un style de démonstration complet.

Définir les ouvrages auxquels appliquer la mise en forme spéciale

CSL utilise book pour les livres écrits par un auteur, les recueils dirigés, les ouvrages complets en plusieurs volumes et les volumes individuels. Sa liste documentée de types ne comporte pas de type distinct pour les ouvrages collectifs en plusieurs volumes. L’approche prise en charge consiste à tester les métadonnées du livre dans un style. Spécification CSL 1.0.2

Pour ce guide, les critères de rendu sont volontairement précis : un book avec un editor, un volume et sans author reçoit une entrée bibliographique qui commence par le titre. Tous les autres documents reçoivent l’entrée standard de la démonstration, qui commence par le créateur. Il s’agit d’un choix de mise en forme illustratif, et non d’une norme de citation prescrite.

L’entrée spéciale suit cet ordre : titre en italique, noms des éditeurs et mention de leur rôle, numéro du volume, puis lieu de publication, éditeur et année. Par exemple, le rendu attendu pour le document fictif ci-dessous est le suivant :

Collected Shape Exercises. Nora Vale, éd. vol. 2. Sampletown : Example Workshop Press, 2024.

La distinction entre un volume et un ensemble est importante. La variable CSL volume désigne le volume concerné ; number-of-volumes indique le nombre total de volumes. Ni le nombre d’éditeurs ni un nombre intégré au titre ne permettent d’établir cette distinction. Définitions des variables CSL

Saisir une notice de test avec des métadonnées sans ambiguïté

Créez dans Zotero une notice de type Book avec les valeurs fictives suivantes. Saisissez Nora Vale comme créatrice avec le rôle Editor et laissez le champ auteur vide. La documentation de Zotero décrit les rôles distincts des créateurs et différencie Volume de # of Volumes. Types d’éléments et champs de Zotero

Champ Zotero Valeur fictive
Item Type Book
Title Collected Shape Exercises
Rôle du créateur Editor
Prénom du créateur Nora
Nom du créateur Vale
Volume 2
# of Volumes 3
Place Sampletown
Publisher Example Workshop Press
Date 2024

Saisissez 2 dans Volume, sans ajouter vol.. Le style fournit la mention. Ici, 2 désigne le volume cité et 3 décrit l’ensemble complet. Zotero recommande de saisir les numéros de volume sous forme numérique. Champs de Zotero pour les livres et les périodiques

Pour créer une notice distincte représentant l’ensemble des trois volumes, laissez Volume vide et conservez # of Volumes avec la valeur 3. Selon les critères de cet article, cette notice suit le chemin standard. L’ensemble n’est ainsi pas traité comme un volume particulier numéroté.

Créer un style de démonstration complet sur votre Mac

Ouvrez TextEdit et choisissez Format → Make Plain Text avant de coller le code. Enregistrez-le sous le nom edited-multivolume-demo.csl et vérifiez que le nom de fichier se termine par .csl. Le guide de Zotero sur la modification des styles décrit précisément l’édition en texte brut avec TextEdit sur Mac. Modification des styles CSL — Guide pas à pas

Voici un style de démonstration complet. Sa bibliographie applique les critères ci-dessus ; ses citations dans le texte affichent uniquement le titre. L’entrée standard est volontairement brève : utilisez ce fichier pour comprendre et tester la règle avant de l’adapter à un style établi pour une bibliothèque contenant plusieurs types de documents.

<?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>

L’élément updated est une métadonnée obligatoire du fichier de style. Ici, il indique l’heure de création de cette démonstration ; il ne s’agit ni de la date de publication ni de la date de révision de l’article. L’élément racine utilise version="1.0", conformément aux exigences des styles compatibles avec CSL 1.0. Structure d’un style CSL

Comprendre la condition avant de la modifier

La condition externe exige un livre et la présence des deux variables, car elle utilise match="all". La condition interne exige l’absence d’auteur au moyen de match="none". L’imbrication exprime cette combinaison sans appliquer le test d’absence aux autres conditions. Rendu conditionnel en CSL

Le tableau de décision suivant permet de vérifier concrètement cette mise en œuvre :

Document Entrée spéciale commençant par le titre ? Motif
Livre, éditeur, volume 2, sans auteur Oui Remplit tous les critères
Livre, éditeur, volume 1, sans auteur Oui Le premier volume respecte aussi les critères
Livre, éditeur, sans volume, ensemble de trois volumes Non Représente l’ensemble selon cette convention
Livre, auteur, éditeur, volume 2 Non Un auteur est indiqué
Livre, volume 2, sans éditeur Non Aucun éditeur n’est indiqué
Chapitre de livre avec éditeur et volume Non Le type d’élément n’est pas book

Cette condition vérifie la présence des métadonnées. Elle ne peut pas établir si une notice importée décrit correctement le document visé. Vérifiez les champs du titre et du volume avant d’étendre la règle à de nombreuses notices.

CSL 1.0.2 ne fournit pas non plus de condition numérique générale de type « supérieur à ». Tester la présence de number-of-volumes correspondrait aussi bien à une valeur renseignée de 1 qu’à une valeur de 3 ; is-numeric ne permet pas de faire cette comparaison. Si vous étendez la règle aux ensembles complets, définissez d’abord une convention de métadonnées cohérente au lieu de considérer la présence d’une valeur comme la preuve qu’il existe plusieurs volumes. Définitions des conditions CSL

La macro extent de la démonstration donne la priorité au volume concerné lorsque les deux champs sont renseignés. L’exemple affiche donc vol. 2 sans indiquer aussi le nombre total de volumes de l’ensemble. De même, la macro standard pour les créateurs privilégie un auteur aux éditeurs. Ces simplifications sont propres à cet exemple ; lors de l’adaptation de votre style, conservez toute exigence supplémentaire concernant les créateurs ou l’étendue de l’ouvrage.

Prévisualiser le résultat et tester les cas limites

Sélectionnez la notice fictive dans Zotero. Dans les réglages de Zotero, ouvrez Cite, puis Style Editor. Collez le style complet dans l’éditeur et cliquez sur Refresh pour utiliser l’élément sélectionné de la bibliothèque. L’éditeur affiche séparément les citations et les entrées bibliographiques et actualise l’aperçu à mesure que vous modifiez le style. Éditeur de styles Zotero

Vérifiez que l’entrée bibliographique respecte l’ordre prévu, avec le titre en premier. La citation dans le texte doit rester un titre en italique entre parenthèses, car cette démonstration place la règle spéciale uniquement dans la macro des entrées de bibliographie.

Créez ensuite des variantes fictives correspondant au tableau de décision. Ajoutez un auteur à une notice, supprimez le volume d’une autre et créez une notice pour l’ensemble complet. Donnez à chacune un titre neutre différent afin de pouvoir les distinguer dans l’aperçu. Vérifiez que seuls les documents répondant aux critères affichent leur titre avant leurs éditeurs.

Le XML de l’exemple a été analysé et les références aux macros ont été vérifiées lors de sa préparation. Il n’a pas été rendu dans l’application Zotero pour Mac. Avant de l’installer ou de l’adapter, validez le fichier complet par rapport au schéma CSL à l’aide du validateur indiqué dans le guide de développement du projet. Une simple vérification de la syntaxe XML ne suffit pas à établir la validité CSL. Développement des styles CSL — Validation

Enregistrez votre code avant de fermer l’éditeur ou de choisir un autre style installé : Zotero précise que ces actions suppriment les modifications non enregistrées. Éditeur de styles Zotero

Installer le style ou en adapter un existant

Pour installer le fichier enregistré, ouvrez les réglages Cite de Zotero et utilisez le bouton + du gestionnaire de styles pour sélectionner edited-multivolume-demo.csl. Les mêmes réglages donnent accès à Style Preview, qui permet de vérifier les documents sélectionnés avec les styles installés. Réglages de citation de Zotero

Pour un format de citation existant, partez de son style indépendant actuel. Un style dépendant pointe uniquement vers un style parent et ne contient pas ses propres instructions de mise en forme. Introduction — Présentation de CSL

Conservez le rendu standard du style comme solution de repli et insérez la condition spéciale avant la règle générale pour les livres. Adaptez la sortie spéciale aux macros de nom, de titre et de publication déjà présentes. Conservez le tri, les autres types d’éléments et le comportement des citations, sauf si ces aspects doivent eux aussi être modifiés. La nouvelle branche peut ainsi répondre à un besoin précis tout en préservant le reste du format.

Avant l’installation, donnez au style adapté un titre et un identifiant distincts ; Zotero avertit que la conservation de l’identité d’origine peut permettre à une mise à jour d’écraser la version modifiée. Guide de Zotero sur la modification des styles

Si l’entrée spéciale ne s’affiche pas, vérifiez la notice à l’aide du tableau de décision avant de modifier la ponctuation ou les macros. Confirmez le rôle du créateur, la valeur du volume, l’absence d’auteur et le type d’élément. Lorsque les notices correspondantes et les notices de repli se comportent comme prévu, vous disposez d’une règle de rendu réutilisable au périmètre clair : les volumes individuels dirigés reçoivent leur propre format bibliographique, tandis que les autres notices suivent le chemin standard choisi.

Sources