No Zotero em um Mac, dê uma formatação distinta a livros editados em vários volumes adicionando um ramo condicional a um estilo CSL. Este passo a passo aborda volumes individuais com editores e sem autor, usando metadados sintéticos e um estilo de demonstração completo.

Defina quais livros devem receber a formatação especial

O CSL usa book para livros com autor, coletâneas editadas, obras completas em vários volumes e volumes individuais. A lista documentada de tipos não tem um tipo separado para livros editados em vários volumes. A abordagem compatível é verificar os metadados do livro dentro de um estilo. Especificação CSL 1.0.2

Neste passo a passo, o contrato de renderização é deliberadamente específico: um book com um editor, um volume e sem author recebe uma entrada bibliográfica que começa pelo título. Todos os outros registros recebem a entrada comum da demonstração, que começa pelo criador. Esta é uma escolha ilustrativa de formatação, não um padrão de citação prescrito.

A entrada especial seguirá esta ordem: título em itálico, nomes dos editores e indicação da função, número do volume e, em seguida, local de publicação, editora e ano. Por exemplo, a saída pretendida para o registro sintético abaixo é:

Exercícios de formas reunidos. Nora Vale, ed. vol. 2. Sampletown: Example Workshop Press, 2024.

A distinção entre um volume e uma coleção é importante. volume no CSL identifica o volume específico; number-of-volumes registra a quantidade total. Nem o número de editores nem um número incluído no título estabelecem essa distinção. Definições de variáveis do CSL

Insira um registro de teste com metadados inequívocos

Crie um registro do tipo Book no Zotero com os seguintes valores sintéticos. Registre Nora Vale como criadora com a função Editor e deixe o campo de autor vazio. A documentação do Zotero descreve funções de criador separadas e distingue Volume de # of Volumes. Tipos e campos de itens do Zotero

Campo do Zotero Valor sintético
Item Type Book
Title Exercícios de formas reunidos
Função do criador Editor
Nome do criador Nora
Sobrenome do criador Vale
Volume 2
# of Volumes 3
Place Sampletown
Publisher Example Workshop Press
Date 2024

Insira 2 em Volume, sem adicionar vol.. O estilo fornece a indicação. Aqui, 2 identifica o volume citado e 3 descreve a coleção completa. O Zotero recomenda inserir valores numéricos de volume como números. Campos de livros e periódicos do Zotero

Para um registro separado que represente a coleção completa de três volumes, deixe Volume vazio e mantenha # of Volumes como 3. Segundo o contrato deste artigo, esse registro segue o caminho comum. Isso impede que a bibliografia trate a coleção como se fosse um volume numerado específico.

Crie um estilo de demonstração completo no seu Mac

Abra o TextEdit e escolha Format → Make Plain Text antes de colar o código. Salve-o como edited-multivolume-demo.csl, verificando se o nome do arquivo termina em .csl. O guia de edição do Zotero documenta especificamente a edição de texto simples com o TextEdit em um Mac. Edição de estilos CSL — guia passo a passo

A seguir, temos um estilo de demonstração completo. A bibliografia implementa o contrato acima; as citações no texto mostram apenas o título. A entrada comum é intencionalmente concisa. Use este arquivo para entender e testar a regra antes de adaptá-la a um estilo estabelecido em uma biblioteca com registros variados.

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

O elemento updated é um metadado obrigatório do arquivo de estilo. Aqui, ele registra a data de criação desta demonstração; não é uma data de publicação ou revisão do artigo. O elemento raiz usa version="1.0", conforme especificado para estilos compatíveis com CSL 1.0. Estrutura de estilos CSL

Entenda a condição antes de alterá-la

A condição externa exige um livro e as duas variáveis preenchidas porque usa match="all". A condição interna exige que não haja autor, por meio de match="none". O aninhamento expressa a combinação sem fazer com que o teste de ausência se aplique às outras condições. Renderização condicional no CSL

A tabela de decisão resultante é a verificação prática para esta implementação específica:

Registro Entrada especial que começa pelo título? Motivo
Livro, editor, volume 2, sem autor Sim Atende a todos os requisitos
Livro, editor, volume 1, sem autor Sim O primeiro volume também atende ao contrato
Livro, editor, sem volume, coleção de três volumes Não Representa a coleção segundo esta convenção
Livro, autor, editor, volume 2 Não Há um autor
Livro, volume 2, sem editor Não Não há editor
Seção de livro com editor e volume Não O tipo de item não é book

Esta condição verifica a presença de metadados. Ela não permite determinar se um registro importado descreve corretamente o objeto pretendido. Revise os campos de título e volume antes de ampliar a regra para muitos registros.

O CSL 1.0.2 também não oferece uma condição geral de comparação numérica maior que. Verificar se number-of-volumes está presente corresponderia a um valor preenchido de 1 tanto quanto a 3; is-numeric não resolve essa comparação. Se você estender a regra às coleções completas, primeiro estabeleça uma convenção consistente de metadados, em vez de tratar a presença de um valor como prova de que há vários volumes. Definições de condições do CSL

A macro extent da demonstração dá prioridade ao volume específico quando os dois campos existem. Assim, o exemplo imprime vol. 2, sem também imprimir o total de volumes da coleção. Da mesma forma, a macro de criador comum dá preferência ao autor em vez dos editores. Essas são simplificações explícitas deste exemplo; preserve quaisquer requisitos adicionais de criadores ou extensão ao adaptar seu próprio estilo.

Visualize o resultado e teste os casos limítrofes

Selecione o registro sintético no Zotero. Nas configurações do Zotero, abra Cite e depois Style Editor. Cole o estilo completo no editor e clique em Refresh para usar o item selecionado da biblioteca. O editor exibe citações e entradas bibliográficas separadamente e atualiza a visualização conforme você edita. Editor de estilos do Zotero

Confira se a entrada bibliográfica segue a ordem pretendida, começando pelo título. A citação no texto deve continuar mostrando o título entre parênteses e em itálico, pois esta demonstração inclui a regra especial apenas na macro de entrada da bibliografia.

Em seguida, crie variações sintéticas que correspondam à tabela de decisão. Adicione um autor a um registro, remova o volume de outro e crie um registro para uma coleção completa. Dê a cada um um título neutro distinto para poder identificá-lo na visualização. Verifique se apenas os registros que atendem aos requisitos colocam os títulos antes dos editores.

O XML do exemplo foi analisado e suas referências a macros foram verificadas durante a preparação. Ele não foi renderizado no aplicativo Zotero para Mac. Antes de instalá-lo ou adaptá-lo, valide o arquivo completo com o esquema CSL usando o validador indicado no guia de desenvolvimento do projeto. Uma verificação de sintaxe XML, por si só, não confirma a validade CSL. Desenvolvimento de estilos CSL — validação

Salve o código antes de fechar o editor ou escolher outro estilo instalado: o Zotero informa que essas ações descartam as edições não salvas. Editor de estilos do Zotero

Instale o estilo ou adapte um existente

Para instalar o arquivo salvo, abra as configurações Cite do Zotero e use o botão + no gerenciador de estilos para selecionar edited-multivolume-demo.csl. As mesmas configurações oferecem Style Preview para conferir os registros selecionados com estilos instalados. Configurações de citação do Zotero

Para um formato de citação existente, comece pelo estilo independente atual. Um estilo dependente apenas aponta para um estilo principal e não contém instruções próprias de formatação. Introdução — uma apresentação do CSL

Mantenha como alternativa a renderização comum do estilo estabelecido e insira a condição especial antes da regra mais abrangente para livros. Adapte a saída especial às macros existentes para nomes, títulos e publicação. Preserve a ordenação, os outros tipos de item e o comportamento das citações, a menos que também precisem de alterações. Assim, o novo ramo resolve uma tarefa sem substituir o restante do formato.

Dê ao estilo adaptado um título e um ID distintos antes da instalação; o Zotero alerta que manter a identidade original pode permitir que uma atualização sobrescreva a versão modificada. Guia de edição de estilos do Zotero

Se a entrada especial não aparecer, confira o registro na tabela de decisão antes de alterar a pontuação ou as macros. Confirme a função do criador, o valor de volume, a ausência de autor e o tipo de item. Quando os registros que correspondem à regra e os demais se comportarem como esperado, você terá uma regra de renderização reutilizável com escopo claro: volumes individuais editados recebem um formato bibliográfico próprio, enquanto os outros registros seguem o caminho comum escolhido.

Fontes