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
// [@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
- Funcions
- Cites en un estil de citaBibliografia a partir de les referènciesReferències creuadesTítols numeratsEstils de títolCapítols sense númeroObertures dissenyadesRequadres a tota l'ampladaPaleta de color semànticaExportació a PDF
- També fa servir
- RequadresCites que col·loquen les figuresAtributs de títolFonts incrustades al PDFSalts de línia als títols
- 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
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
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
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.
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
// ═══ 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. EscriuThe {TeX}book; les claus mantenen les majúscules com són.
Crèdits
- Recepta
- Ignacio Ferro
- Text
- Text original, CC BY 4.0
- Fonts
- STIX Two Text (SIL OFL 1.1) · Schibsted Grotesk (SIL OFL 1.1)
- Codi
- MIT, com Postext
Editar aquest text ↗ (s'obre en una pestanya nova)Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)


