En pocas palabras
Un artículo breve para un congreso, a dos columnas. El autor escribe un código para cada fuente; Postext numera las citas entre corchetes, remite a las secciones por número y página e imprime al final la lista numerada de referencias.
Lo que vas a componer
Una ponencia de dos páginas para un pequeño taller de ingeniería documental, compuesta como componen las suyas las actas de los congresos del IEEE: carta US, dos columnas de tres pulgadas y media, una letra de tipo Times a 10 pt y secciones numeradas I, II, III en mayúsculas centradas. El título, los tres bloques de autor, el resumen y las palabras clave ocupan las dos columnas bajo una banda pálida en el azul del taller, el único color de las páginas. Los autores citan con claves de BibTeX; Postext imprime [1] en el orden en que se cita cada obra por primera vez, agrupa tres obras seguidas como [2]–[4], escribe «Knuth y Plass [1]» cuando los nombres forman parte de la frase y monta al final la lista numerada a 8 pt. Las remisiones a secciones dicen «la sección IV, en la pág. 2» y siguen siendo ciertas cuando el texto se mueve.
Esta receta responde a
- ¿Cómo cito obras y compongo la bibliografía en APA, IEEE u otro estilo de cita?
- ¿Cómo remito a una sección y a la página en que está, y mantengo ambas correctas cuando el libro cambia?
La respuesta corta
// [@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
},
};
Ingredientes
- Funciones
- Citas en un estilo de citaBibliografía a partir de las referenciasReferencias cruzadasTítulos numeradosEstilos de títuloCapítulos sin númeroAperturas diseñadasRecuadros a todo el anchoPaleta de color semánticaExportación a PDF
- También usa
- RecuadrosCitas que colocan las figurasAtributos de títuloFuentes incrustadas en el PDFSaltos de línea en los títulos
- Tipografía
- STIX Two Text, Schibsted Grotesk (SIL OFL 1.1)
- Recursos
- Ninguno: todas las imágenes se dibujan en código
Elaboración
#1 · El estilo IEEE, con sus intervalos
El código es la respuesta corta de arriba. Registrado una vez, postext-citeproc compone cada [@clave] con citeproc-js y el estilo CSL de IEEE, y numera las obras en el orden en que se citan por primera vez. El archivo de estilo que trae el motor escribe tres obras seguidas como [2], [3], [4]; la guía editorial de IEEE las une como [2]–[4]. Basta añadir collapse="citation-number" al elemento <citation> del estilo y pasar el resultado como customStyle para que citeproc-js lo haga. labelWidth da a los números de la lista una columna propia, de modo que la segunda línea de cada entrada empieza bajo la primera palabra y no bajo el corchete.
#2 · Un bloque de título a dos columnas
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ítulo es el único encabezado de nivel 1 del documento, con el estilo paper. El estilo ocupa toda la página y dibuja el título con su diseño: la línea del taller, el título y tres bloques de autor de un tercio de la medida, cada uno leído de un atributo del encabezado cuyo \n separa las líneas. La banda es una caja anclada al corte, así que llega hasta el borde superior del papel.
#3 · Resumen y palabras clave en negrita
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 recuadro a todo el ancho lleva el resumen y las palabras clave. Su cuerpo va a 9 pt en negrita, como lo compone IEEE, y ***Resumen*—** en el texto da la etiqueta en cursiva con su raya. El filete de arriba es la franja del recuadro, y el relleno estrecha la medida a unos cien caracteres.
#4 · Secciones numeradas y remisiones a ellas
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 las secciones I., II., III. Una remisión imprime el número sin el punto, así que :ref{id="sec:results"} da «sección IV» con la plantilla de crossRefs, y :ref{id="sec:results" style=page} da «pág. 2». Las dos se calculan sobre las páginas ya compuestas, de modo que siguen al texto si se añade un párrafo o una sección cambia de sitio. Los títulos de agradecimientos y referencias llevan el estilo back y quedan sin 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 receta 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
El script.js compuesto funciona tal cual: pégalo como script de módulo en cualquier página o abre la receta en CodePen. Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)
Variantes
#Deja el estilo como viene
Sin el cambio, tres obras seguidas se imprimen una a una, como prefieren algunas revistas.
- style: 'custom', customStyle: ieee, // or style: 'ieee' for the file as it ships
+ style: 'ieee',#Escribe los intervalos dentro de un solo par de corchetes
Otros estilos numéricos imprimen [2–4]. La marca brackets escribe los números por su cuenta y une los consecutivos.
- style: 'custom', customStyle: ieee, // or style: 'ieee' for the file as it ships
+ style: 'ieee', marker: 'brackets', collapseRanges: true,Errores frecuentes
- Si las dos columnas de la última página no acaban a la misma altura, mira qué queda donde se cortarían: el motor no deja un título de sección al pie de una columna, lejos de su texto, y renuncia al corte. Una frase más o menos en las últimas secciones lleva el corte más allá del título.
- Las órdenes de BibTeX como
{\TeX}no se expanden. EscribeThe {TeX}book; las llaves mantienen las mayúsculas como están.
Créditos
- Receta
- Ignacio Ferro
- Texto
- Texto original, CC BY 4.0
- Fuentes
- STIX Two Text (SIL OFL 1.1) · Schibsted Grotesk (SIL OFL 1.1)
- Código
- MIT, como Postext
Editar este texto ↗ (se abre en una nueva pestaña)Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)


