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
// 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
- Funcionalidades
- Bibliografia a partir das referênciasCitações em um estilo de citaçãoAberturas desenhadasAtributos de títuloUma ou duas colunasCabeços e fóliosEstilos de parágrafoPaleta de cores semântica
- 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
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.
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
// ═══ 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
nociteque 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
addressnão é impresso, e um artigo com DOI mostra o DOI, e não ourldo JSTOR.
Créditos
- Receita
- Ignacio Ferro
- Texto
- Texto original, CC BY 4.0
- Fontes
- Spectral (SIL OFL 1.1) · IBM Plex Sans Condensed (SIL OFL 1.1)
- Código
- MIT, como o Postext
Editar este texto ↗ (abre em uma nova aba)Pasta da receita no GitHub ↗ (abre em uma nova aba)


