Saltar al contingut principal
Recepta número 97

Receptari · Capítol 5 · Estructura del llibre

Una bibliografia des d'una exportació BibTeX de Zotero

Lectures d'un seminari amb l'exportació BibTeX de Zotero tal qual, citada en Chicago autor-any, i nocite per a les obres que el text no cita.

En aquesta pàgina
Sortida
Canvas
Nivell
Intermedi
Postext
Provada amb Postext 1.65.0
Requereix ≥ 1.65.0
Llicència
Actualitzada el 31 d’oct. del 2026
Codi MIT · Text CC BY 4.0
  • Mostra en castellà: encara no hi ha edició en català
  • Format 210 × 280 mm
  • 2 columnes, espai entre columnes de 7 mm
  • Spectral 9,6/13,4
  • IBM Plex Sans Condensed
  • 2 pàgines
  • Nivell
  • Postext 1.65.0
  • Compost en 550 ms
  • 121 línies de codi

En poques paraules

La llista de lectures d'un seminari universitari. El professor enganxa el fitxer que exporta Zotero; Postext compon les cites i una llista que inclou també llibres que el text no esmenta.

Què compondràs

La llista de lectures d'un seminari de sis setmanes sobre història i sociologia de la ciència, en una pàgina de 210 × 280 mm a dues columnes. Un camp verd fosc ocupa la meitat superior de la primera pàgina, amb el títol del curs en Spectral Light de 50 pt; a sota, la guia del professor per a cada setmana. Les referències són la col·lecció de Zotero del seminari, exportada en BibTeX i enganxada al document sense tocar-ne ni una línia: les claus de cita que genera Zotero, les claus que posa al voltant de les majúscules, els accents {\"o}, month = dec i els camps file, keywords i urldate. El text cita vuit de les obres. Les altres cinc, lectures de fons que el seminari no comenta, entren a la llista amb nocite.

Aquesta recepta respon a

  • Com faig servir una exportació BibTeX de Zotero i llisto obres que el text no cita?
  • Com cito obres i componc la bibliografia en APA, IEEE o un altre estil de cita?

La resposta curta

script.js · línies 28–40al codi complet
// 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
  },
};

Ingredients

Tipografia
Spectral, IBM Plex Sans Condensed (SIL OFL 1.1)
Recursos
Cap: totes les imatges es dibuixen en codi

Elaboració

#1 · L'estil s'anomena una vegada

El codi és la resposta curta de més amunt. El motor de cites es registra abans de la primera composició i l'estil és un sol paràmetre: Chicago autor-any escriu «(Shapin 1984)» per a [@shapin_pump_1984] i «Shapin y Schaffer (1985)» per a @shapin_leviathan_1985 dins de la frase. Les claus són les que Zotero construeix amb el primer autor, la primera paraula amb pes del títol i l'any, així que gieryn_boundary-work_1983 conserva el seu guionet; Postext llegeix un guionet o un guió baix dins d'una clau com a part de la clau.

#2 · L'exportació, tal com l'escriu Zotero

L'últim bloc del document guarda l'exportació, una entrada per obra i sagnada amb tabuladors, com l'escriu Zotero:

@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},
}

El lector treu les claus que protegeixen les majúscules, compon {\"o} i {\'e} en ö i é, converteix -- en guió mitjà i llegeix month = dec com un nom de mes sense claus. urldate passa a ser la data de consulta i language la llengua de l'obra; file, keywords, abstract i shorttitle se salten, així que res del teu disc no arriba a la pàgina.

#3 · Les obres que el text no cita

El frontmatter les enumera per la clau:

---
title: "La ciencia como práctica social"
nocite: "@fleck_genesis_1979, @merton_sociology_1973, @latour_science_1987, @rheinberger_toward_1997, @lopez_pinero_ciencia_1979"
---

La llista recull totes les obres citades més aquestes cinc, ordenades juntes per autor com demana Chicago; cap marca no distingeix una entrada no citada. nocite: "@*" llista l'exportació sencera, i bibliography.includeUncited: true fa el mateix des de la configuració, per a un disseny que sempre imprimeix tota la biblioteca.

#4 · Un camp verd per a la targeta

script.js · línies 44–68al codi complet
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' } } },
  ] },
};

La banda és un requadre ancorat al tall, de 132 mm, i les dues columnes comencen 9 mm per sota. El títol, el filet i l'entradeta s'encadenen amb ancoratges below, de manera que un títol més llarg empeny l'entradeta cap avall en lloc de xocar-hi.

script.js · línies 15–21al codi complet
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' } }));

La recepta 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 = 'es'; // @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

L'script.js compost funciona tal com és: enganxa'l com a script de mòdul en qualsevol pàgina o obre la recepta a CodePen. Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)

Variants

#Llista la col·lecció sencera de Zotero

Quan l'exportació és la llista, les claus sobren: s'imprimeixen totes les entrades del bloc, citades o no.

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

#Canvia l'estil

Les mateixes claus donen una llista Harvard (Cite Them Right) sense cap altre canvi.

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

Errors freqüents

Error freqüent

Una clau de nocite que no coincideix amb res es descarta sense avís

Una clau citada sense referència dona l'avís unknownCitationKey, però una clau de nocite que no correspon a cap entrada s'omet sense avisar. Copia les claus de l'exportació i compta les entrades de la llista. Bibliografia a partir de les referències →

  • Una clau de nocite que no correspon a cap entrada desapareix sense avís. Copia les claus de l'exportació en comptes de teclejar-les i compta les entrades a la pàgina.
  • Zotero construeix les claus a partir de les dades: si corregeixes el nom d'un autor o un títol a Zotero, la propera exportació pot canviar la clau i trencar totes les seves cites. Fixa les claus abans d'escriure el text: Zotero llegeix una línia Citation Key: … al camp Extra de cada registre.
  • Zotero exporta en UTF-8 per defecte, amb els accents tal qual. El bloc d'aquesta recepta es va exportar amb la codificació Western, que escriu {\"o}; Postext llegeix totes dues.
  • La 18a edició de Chicago omet el lloc d'edició, així que el camp address no s'imprimeix, i un article amb DOI mostra el DOI i no l'url de JSTOR.

Crèdits

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