Saltar al contingut principal
Recepta número 88

Receptari · Capítol 5 · Estructura del llibre

Una ponència a dues columnes en estil IEEE

Una ponència a dues columnes: títol a tota l'amplada, citacions IEEE amb intervals [2]–[4], remissions a la secció II i una llista numerada compacta.

En aquesta pàgina
Sortida
Canvas · PDF
Nivell
Intermedi
Postext
Provada amb Postext 1.70.5
Requereix ≥ 1.65.0 · postext-pdf ≥ 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 215,9 × 279,4 mm
  • 2 columnes, espai entre columnes de 6,3 mm
  • STIX Two Text 10/12
  • Schibsted Grotesk
  • 2 pàgines
  • Nivell
  • Postext 1.70.5
  • Compost en 153 ms
  • 127 línies de codi

En poques paraules

Un article breu per a un congrés, a dues columnes. L'autor escriu un codi per a cada font; Postext numera les citacions entre claudàtors, remet a les seccions per número i pàgina i imprimeix al final la llista numerada de referències.

Què compondràs

Una ponència de dues pàgines per a un petit taller d'enginyeria documental, composta com componen les seves les actes dels congressos de l'IEEE: carta US, dues columnes de tres polzades i mitja, una lletra de tipus Times a 10 pt i seccions numerades I, II, III en majúscules centrades. El títol, els tres blocs d'autor, el resum i les paraules clau ocupen les dues columnes sota una banda pàl·lida en el blau del taller, l'únic color de les pàgines. Els autors citen amb claus de BibTeX; Postext imprimeix [1] en l'ordre en què se cita cada obra per primera vegada, agrupa tres obres seguides com [2]–[4], escriu «Knuth i Plass [1]» quan els noms formen part de la frase i munta al final la llista numerada a 8 pt. Les remissions a seccions diuen «la secció IV, a la pàg. 2» i continuen sent certes quan el text es mou.

Aquesta recepta respon a

  • Com cito obres i componc la bibliografia en APA, IEEE o un altre estil de cita?
  • Com remeto a una secció i a la pàgina on és, i mantinc totes dues correctes quan el llibre canvia?

La resposta curta

script.js · línies 32–46al codi complet
// [@key] prints [1] in order of first citation, @key in the sentence "Knuth and Plass [1]".
registerCitationEngine(createCiteprocEngine({ styles: STYLES, locales: LOCALES }));
// The bundled IEEE style lists [2], [3], [4]; the IEEE editorial guide writes [2]–[4].
// One attribute on the CSL <citation> element makes citeproc-js join the run.
const ieee = STYLES.ieee.replace('<citation>', '<citation collapse="citation-number">');
const citations = {
  style: 'custom', customStyle: ieee, // or style: 'ieee' for the file as it ships
  link: true,
  bibliography: {
    fontSize: em(0.8), lineHeight: pt(9.4), // 8 pt on 9.4 pt, two sizes under the text
    labelWidth: mm(6), // the [n] column: wide enough for [10], the turnovers align after it
    entrySpacing: pt(1.2),
    doi: 'text', // printed, not linked: the PDF stays black
  },
};

Ingredients

Tipografia
STIX Two Text, Schibsted Grotesk (SIL OFL 1.1)
Recursos
Cap: totes les imatges es dibuixen en codi

Elaboració

#1 · L'estil IEEE, amb els seus intervals

El codi és la resposta curta de més amunt. Un cop registrat, postext-citeproc compon cada [@clave] amb citeproc-js i l'estil CSL d'IEEE, i numera les obres en l'ordre en què se citen per primera vegada. El fitxer d'estil que porta el motor escriu tres obres seguides com [2], [3], [4]; la guia editorial d'IEEE les uneix com [2]–[4]. N'hi ha prou d'afegir collapse="citation-number" a l'element <citation> de l'estil i passar el resultat com a customStyle perquè citeproc-js ho faci. labelWidth dona als números de la llista una columna pròpia, de manera que la segona línia de cada entrada comença sota la primera paraula i no sota el claudàtor.

#2 · Un bloc de títol a dues columnes

script.js · línies 50–72al codi complet
const text = (id, content, size, extra) => ({ kind: 'text', id, content, fontFamily: SERIF,
  fontSize: pt(size), color: col('ink'), align: 'center', overflow: 'wrap', ...extra });
const at = (to, edge, x, y, width) => ({ anchor: { to, edge }, offset: { x: mm(x), y: mm(y) },
  ...(width && { size: { width: mm(width), height: 'auto' } }) });
const AUTHOR_W = MEASURE / 3;
const titleBlock = {
  enabled: true,
  minHeight: mm(64), // venue line, two lines of title and five of author block
  slot: { elements: [
    { kind: 'box', id: 'band', style: { backgroundColor: col('tint') }, // from the trim's top
      placement: { anchor: { to: 'page', edge: 'top-left' },
        size: { width: 'fill', height: mm(TOP + 66) } } },
    text('venue', '{attr.venue}', 7.5, { fontFamily: SANS, fontWeight: 600, color: col('accent'),
      letterSpacing: pt(1.2), textTransform: 'uppercase',
      placement: at('container', 'top-left', 0, 0, MEASURE) }),
    { kind: 'rule', id: 'venue-rule', thickness: pt(0.5), color: col('rule'),
      placement: at('#venue', 'below', 0, 2, MEASURE) },
    text('title', '{titleText}', 23, { lineHeight: 1.1, placement: at('#venue', 'below', 0, 7,
      MEASURE) }),
    ...['a1', 'a2', 'a3'].map((id, i) => text(id, `{attr.${id}}`, 9.5, { lineHeight: 1.25,
      placement: at('#title', 'below', i * AUTHOR_W, 6, AUTHOR_W) })),
  ] },
};

El títol és l'únic títol de nivell 1 del document, amb l'estil paper. L'estil ocupa tota la pàgina i dibuixa el títol amb el seu disseny: la línia del taller, el títol i tres blocs d'autor d'un terç de la mesura, cadascun llegit d'un atribut del títol, on \n separa les línies. La banda és una caixa ancorada al tall, així que arriba fins a la vora superior del paper.

#3 · Resum i paraules clau en negreta

script.js · línies 76–82al codi complet
const calloutStyles = [{ id: 'abstract', span: 'page', backgroundEnabled: false,
  border: { enabled: false }, stripe: { enabled: true, side: 'top', width: pt(0.5),
    color: col('rule') },
  padding: { top: mm(3), right: mm(14), bottom: mm(1), left: mm(14) },
  marginTop: pt(0), marginBottom: pt(LEAD),
  body: { fontSize: pt(9), lineHeight: pt(11), fontWeight: 700, firstLineIndent: pt(0),
    textAlign: 'justify', paragraphSpacing: true } }];

Un requadre a tota l'amplada porta el resum i les paraules clau. El cos va a 9 pt en negreta, com el compon IEEE, i ***Resumen*—** al text dona l'etiqueta en cursiva amb la seva ratlla. El filet de dalt és la franja del requadre, i el farciment estreny la mesura a un centenar de caràcters.

#4 · Seccions numerades i remissions a les seccions

script.js · línies 86–97al codi complet
const levels = [
  { level: 1, breakBefore: { enabled: true, parity: 'any' } }, // any page: no forced recto
  { level: 2, numberingTemplate: '{2:I}.', numberSeparator: ' ', fontSize: pt(9),
    lineHeight: pt(LEAD), fontWeight: 400, letterSpacing: em(0.06), textTransform: 'uppercase',
    marginTop: pt(LEAD), marginBottom: pt(0) }, // a line above, none below: at a column's head
  // the margin above drops and the text still starts on the next grid line
];
const headingStyles = [
  { id: 'paper', numbered: false, span: 'page', advancedDesign: titleBlock },
  { id: 'back', numbered: false }, // Acknowledgment and References: no number
];
const crossRefs = { section: t({ en: 'Section {n}', es: 'sección {n}' }) };

{2:I}. numera les seccions I., II., III. Una remissió imprimeix el número sense el punt, així que :ref{id="sec:results"} dona «secció IV» amb la plantilla de crossRefs, i :ref{id="sec:results" style=page} dona «pàg. 2». Totes dues es calculen sobre les pàgines ja compostes, de manera que segueixen el text si s'afegeix un paràgraf o una secció canvia de lloc. Els títols d'agraïments i referències porten l'estil back i queden sense número.

script.js · línies 16–22al codi complet
const palette = {
  ink: '#16181d', accent: '#1d4a7a', tint: '#e9eef5', rule: '#aeb6c2', muted: '#5a606b',
  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º 088 · A two-column conference paper in IEEE style ═══════
// https://postext.dev/en/cookbook/ieee-conference-paper
// Code: MIT · Text: original (CC BY 4.0) · Pictures: none
// Fonts: STIX Two Text, Schibsted Grotesk (SIL OFL 1.1) · Needs postext ≥ 1.65.0
import {
  buildDocumentWithFonts, renderPageToCanvas, registerCitationEngine,
} from 'https://esm.sh/postext';
import { renderToPdf, decompressWoff2 } from 'https://esm.sh/postext-pdf';
import { createCiteprocEngine, STYLES, LOCALES } from 'https://esm.sh/postext-citeproc';

const LANG = 'es'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'ieee-conference-paper';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: black type on white, with one blue for the workshop's own marks
const palette = {
  ink: '#16181d', accent: '#1d4a7a', tint: '#e9eef5', rule: '#aeb6c2', muted: '#5a606b',
  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 [SERIF, SANS] = ['STIX Two Text', 'Schibsted Grotesk'];
// The IEEE conference template in mm: US letter, 0.75 in head, 1 in foot, 0.625 in sides,
// two columns of 3.5 in with 0.25 in between.
const [TRIM_W, TRIM_H, TOP, BOTTOM, SIDE, GUTTER] = [215.9, 279.4, 19, 25.4, 15.9, 6.35];
const MEASURE = TRIM_W - 2 * SIDE;
const LEAD = 12; // pt: 10 pt type on 12 pt, as the template sets it

// #region answer: IEEE numbers, collapsed ranges and a references list with a label column
// [@key] prints [1] in order of first citation, @key in the sentence "Knuth and Plass [1]".
registerCitationEngine(createCiteprocEngine({ styles: STYLES, locales: LOCALES }));
// The bundled IEEE style lists [2], [3], [4]; the IEEE editorial guide writes [2]–[4].
// One attribute on the CSL <citation> element makes citeproc-js join the run.
const ieee = STYLES.ieee.replace('<citation>', '<citation collapse="citation-number">');
const citations = {
  style: 'custom', customStyle: ieee, // or style: 'ieee' for the file as it ships
  link: true,
  bibliography: {
    fontSize: em(0.8), lineHeight: pt(9.4), // 8 pt on 9.4 pt, two sizes under the text
    labelWidth: mm(6), // the [n] column: wide enough for [10], the turnovers align after it
    entrySpacing: pt(1.2),
    doi: 'text', // printed, not linked: the PDF stays black
  },
};
// #endregion

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

#Deixa l'estil tal com ve

Sense el canvi, tres obres seguides s'imprimeixen una per una, com prefereixen algunes revistes.

-  style: 'custom', customStyle: ieee, // or style: 'ieee' for the file as it ships
+  style: 'ieee',

#Escriu els intervals dins d'un sol parell de claudàtors

Altres estils numèrics imprimeixen [2–4]. La marca brackets escriu els números pel seu compte i uneix els consecutius.

-  style: 'custom', customStyle: ieee, // or style: 'ieee' for the file as it ships
+  style: 'ieee', marker: 'brackets', collapseRanges: true,

Errors freqüents

  • Si les dues columnes de l'última pàgina no acaben a la mateixa altura, mira què queda on es tallarien: el motor no deixa un títol de secció al peu d'una columna, lluny del seu text, i renuncia al tall. Una frase més o menys a les últimes seccions porta el tall més enllà del títol.
  • Les ordres de BibTeX com {\TeX} no s'expandeixen. Escriu The {TeX}book; les claus mantenen les majúscules com són.

Crèdits

Text
Text original, CC BY 4.0
Fonts
STIX Two Text (SIL OFL 1.1) · Schibsted Grotesk (SIL OFL 1.1)
SandboxPDF