Pular para o conteúdo principal
Receita número 97

Receitas · Capítulo 5 · Estrutura do livro

Lista de leituras com a exportação BibTeX do Zotero

A lista de leituras de um seminário com a exportação BibTeX do Zotero colada como veio, citada em Chicago autor-data, e nocite para obras que o texto não cita.

Nesta página
Saída
Canvas
Postext
Testada com o Postext 1.65.0
Requer ≥ 1.65.0
Licença
Atualizada em 31 de out. de 2026
Código MIT · Texto CC BY 4.0
  • Amostra em inglês: ainda sem edição em português
  • Refile 210 × 280 mm
  • 2 colunas, medianiz de 7 mm
  • Spectral 9,6/13,4
  • IBM Plex Sans Condensed
  • 2 páginas
  • Nível
  • Postext 1.65.0
  • Diagramado em 547 ms
  • 121 linhas de código

Em poucas palavras

A lista de leituras de um seminário universitário. O professor cola o arquivo que o Zotero exporta; o Postext compõe as citações e uma lista que inclui também livros que o texto não menciona.

O que você vai compor

A lista de leituras de um seminário de seis semanas sobre história e sociologia da ciência, composta numa página de 210 × 280 mm em duas colunas. Um campo verde-escuro ocupa a metade de cima da primeira página, com o título do curso em Spectral Light de 50 pt; o texto abaixo é o guia do professor para cada semana. As referências são a coleção do seminário no Zotero, exportada em BibTeX e colada no documento sem mexer numa linha: as chaves de citação do Zotero, as chaves em volta das maiúsculas, os acentos {\"o}, month = dec e os campos file, keywords e urldate. O texto cita oito das obras. As outras cinco, leituras de fundo que o seminário não discute, entram na lista por nocite.

Esta receita responde a

  • Como uso uma exportação BibTeX do Zotero e listo obras que o texto nunca cita?
  • Como cito obras e monto a bibliografia em APA, IEEE ou outro estilo de citação?

A resposta curta

script.js · linhas 28–40no código completo
// The works come from a :::references{format=bibtex} block: the Zotero export pasted as it
// is. The text cites some of them; `nocite` in the front matter adds the rest by key, and
// `nocite: "@*"` would add the whole export. citeproc-js writes both in the style named.
registerCitationEngine(createCiteprocEngine({ styles: STYLES, locales: LOCALES }));
const citations = {
  style: 'chicago-author-date', // '(Gieryn 1983)', 'Shapin and Schaffer (1985)'
  link: true, // a citation jumps to its entry
  bibliography: {
    // includeUncited: true is the same as nocite: "@*", set from the design side.
    fontSize: em(0.94), lineHeight: pt(12.4), hangingIndent: mm(5), entrySpacing: pt(3.5),
    doi: 'link', // Zotero's doi field prints as https://doi.org/…; its url field is dropped
  },
};

Ingredientes

Tipografia
Spectral, IBM Plex Sans Condensed (SIL OFL 1.1)
Materiais
Nenhum: todas as imagens são desenhadas em código

Preparo

#1 · Dar nome ao estilo uma vez

O código é a resposta curta acima. O motor de citações é registrado antes da primeira composição, e o estilo é uma única configuração: o Chicago autor-data escreve “(Shapin 1984)” para [@shapin_pump_1984] e “Shapin and Schaffer (1985)” para @shapin_leviathan_1985 dentro da frase. As chaves são as que o Zotero montou com o primeiro autor, a primeira palavra significativa do título e o ano, por isso gieryn_boundary-work_1983 mantém o hífen; o Postext lê um hífen ou um sublinhado dentro de uma chave como parte dela.

#2 · Colar a exportação como o Zotero a escreve

O último bloco do documento guarda a exportação, uma entrada por obra, recuada com tabulações como o Zotero a escreve:

@article{gieryn_boundary-work_1983,
	title = {Boundary-{Work} and the {Demarcation} of {Science} from {Non}-{Science}: …},
	url = {https://www.jstor.org/stable/2095325},
	doi = {10.2307/2095325},
	urldate = {2026-08-21},
	journal = {American Sociological Review},
	author = {Gieryn, Thomas F.},
	month = dec,
	year = {1983},
	keywords = {demarcation, week 4},
	pages = {781--795},
	file = {JSTOR Full Text PDF:/Users/hps214/Zotero/storage/2HJ8M6PA/Gieryn - 1983 - ….pdf:application/pdf},
}

O leitor tira as chaves que protegem as maiúsculas, compõe {\"o} e {\'e} em ö e é, transforma -- em meia-risca e lê month = dec como um nome de mês sem chaves. urldate vira a data de acesso, e language a língua da obra; file, keywords, abstract e shorttitle são ignorados, de modo que nada de seu disco chega à página.

#3 · Trazer as obras que o texto não cita

O front matter as lista pela chave:

---
title: "Science as a Social Practice"
nocite: "@fleck_genesis_1979, @merton_sociology_1973, @latour_science_1987, @rheinberger_toward_1997, @lopez_pinero_ciencia_1979"
---

A lista traz todas as obras citadas mais estas cinco, ordenadas juntas por autor, como o Chicago pede; nada marca uma entrada como não citada. nocite: "@*" lista a exportação inteira, e bibliography.includeUncited: true faz o mesmo a partir da configuração, para um projeto gráfico que sempre imprime a biblioteca toda.

#4 · Um campo verde para o cartão

script.js · linhas 44–68no código completo
const BAND = 132; // mm from the trim's top to the band's foot
const onBand = { color: col('paper'), align: 'left', overflow: 'wrap' };
const opener = {
  enabled: true,
  minHeight: mm(BAND - TOP + 9), // the columns start 9 mm under the band
  slot: { elements: [
    { kind: 'box', id: 'band', style: { backgroundColor: col('accent') },
      placement: { anchor: { to: 'page', edge: 'top-left' },
        size: { width: 'fill', height: mm(BAND) } } },
    { kind: 'text', id: 'kicker', content: '{attr.kicker}', ...onBand, fontFamily: LABEL,
      fontSize: pt(8.5), fontWeight: 600, letterSpacing: pt(1.7), textTransform: 'uppercase',
      placement: { anchor: { to: 'container', edge: 'top-left' }, offset: { y: mm(14) } } },
    { kind: 'text', id: 'title', content: '{titleText}', ...onBand, fontFamily: TEXT,
      fontSize: pt(50), fontWeight: 300, lineHeight: 1.02,
      placement: { anchor: { to: '#kicker', edge: 'below' }, offset: { y: mm(7) },
        size: { width: mm(150), height: 'auto' } } },
    { kind: 'rule', id: 'rule', direction: 'horizontal', thickness: pt(1), color: col('tint'),
      placement: { anchor: { to: '#title', edge: 'below' }, offset: { y: mm(7) },
        size: { width: mm(18) } } },
    { kind: 'text', id: 'lead', content: '{attr.lead}', ...onBand, fontFamily: TEXT,
      italic: true, fontSize: pt(13), lineHeight: 1.3, color: col('tint'),
      placement: { anchor: { to: '#rule', edge: 'below' }, offset: { y: mm(6) },
        size: { width: mm(128), height: 'auto' } } },
  ] },
};

A faixa é uma caixa ancorada no refile, com 132 mm de altura, e as duas colunas começam 9 mm abaixo dela. O título, o fio e o olho são encadeados com âncoras below, de modo que um título de curso mais longo empurra o olho para baixo em vez de bater nele.

script.js · linhas 15–21no código completo
const palette = {
  ink: '#1c211f', accent: '#2d5b48', tint: '#dfe9e2', rule: '#c3cdc6', muted: '#5c6862',
  paper: '#ffffff',
};
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = Object.entries({ ...palette, 'main-color': palette.accent })
  .map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));

A receita completa

Sandbox
// ═══ Postext Cookbook · Nº 097 · A reading list from a Zotero BibTeX export ═══════
// https://postext.dev/en/cookbook/zotero-bibtex-nocite
// Code: MIT · Text: original (CC BY 4.0) · Pictures: none
// Fonts: Spectral, IBM Plex Sans Condensed (SIL OFL 1.1) · Needs postext ≥ 1.65.0
import {
  buildDocumentWithFonts, renderPageToCanvas, registerCitationEngine,
} from 'https://esm.sh/postext';
import { createCiteprocEngine, STYLES, LOCALES } from 'https://esm.sh/postext-citeproc';

const LANG = 'en'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'zotero-bibtex-nocite';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: a department green, one tint, everything else in ink
const palette = {
  ink: '#1c211f', accent: '#2d5b48', tint: '#dfe9e2', rule: '#c3cdc6', muted: '#5c6862',
  paper: '#ffffff',
};
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = Object.entries({ ...palette, 'main-color': palette.accent })
  .map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
// #endregion
const [TEXT, LABEL] = ['Spectral', 'IBM Plex Sans Condensed'];
const LEAD = 13.4; // pt
const [TOP, OUTER] = [24, 18]; // mm

// #region answer: Chicago author-date, and a list that holds more than the text cites
// The works come from a :::references{format=bibtex} block: the Zotero export pasted as it
// is. The text cites some of them; `nocite` in the front matter adds the rest by key, and
// `nocite: "@*"` would add the whole export. citeproc-js writes both in the style named.
registerCitationEngine(createCiteprocEngine({ styles: STYLES, locales: LOCALES }));
const citations = {
  style: 'chicago-author-date', // '(Gieryn 1983)', 'Shapin and Schaffer (1985)'
  link: true, // a citation jumps to its entry
  bibliography: {
    // includeUncited: true is the same as nocite: "@*", set from the design side.
    fontSize: em(0.94), lineHeight: pt(12.4), hangingIndent: mm(5), entrySpacing: pt(3.5),
    doi: 'link', // Zotero's doi field prints as https://doi.org/…; its url field is dropped
  },
};
// #endregion

// #region opener: a green field over the top half, the course in white on it
const BAND = 132; // mm from the trim's top to the band's foot
const onBand = { color: col('paper'), align: 'left', overflow: 'wrap' };
const opener = {
  enabled: true,
  minHeight: mm(BAND - TOP + 9), // the columns start 9 mm under the band

O script.js montado funciona como está: cole-o como script de módulo em qualquer página ou abra a receita no CodePen. Pasta da receita no GitHub ↗ (abre em uma nova aba)

Variações

#Listar a coleção inteira do Zotero

Quando a exportação é a própria lista, dispense as chaves: todas as entradas do bloco são impressas, citadas ou não.

-nocite: "@fleck_genesis_1979, @merton_sociology_1973, @latour_science_1987, …"
+nocite: "@*"

#Mudar o estilo

As mesmas chaves dão uma lista Harvard (Cite Them Right) sem nenhuma outra mudança.

-  style: 'chicago-author-date', // '(Gieryn 1983)', 'Shapin and Schaffer (1985)'
+  style: 'harvard-cite-them-right',

Erros comuns

Erro comum

Uma chave de nocite que não corresponde a nada é descartada sem aviso

Uma chave citada sem referência gera o aviso unknownCitationKey, mas uma chave em nocite que não corresponde a nenhuma entrada é ignorada sem aviso. Copie as chaves da exportação e conte as entradas da lista. Bibliografia a partir das referências →

  • Uma chave em nocite que não corresponde a nenhuma entrada é descartada sem aviso. Copie as chaves da exportação em vez de digitá-las, e conte as entradas na página.
  • O Zotero monta as chaves a partir dos dados: corrija o nome de um autor ou um título no Zotero, e a próxima exportação pode mudar a chave, o que quebra todas as citações dela. Fixe as chaves antes de escrever o texto: o Zotero lê uma linha Citation Key: … no campo Extra de um item.
  • O Zotero exporta em UTF-8 por padrão, com os acentos como são. O bloco aqui foi exportado com a opção de codificação Western, que escreve {\"o}; o Postext lê as duas.
  • A 18ª edição do Chicago omite o local de publicação, por isso o campo address não é impresso, e um artigo com DOI mostra o DOI, e não o url do JSTOR.

Créditos

Texto
Texto original, CC BY 4.0
Fontes
Spectral (SIL OFL 1.1) · IBM Plex Sans Condensed (SIL OFL 1.1)
Sandbox