Saltar al contenido principal
Receta número 137

Recetario · Capítulo 6 · Recuadros y notas

Un preprint de IA con ejemplos de prompt en recuadros

El artículo de la cadena de pensamiento, recompuesto: prompts y respuestas en recuadros con pestaña, citas autor-año desde BibTeX y gráficos desde sus tablas.

  • Muestra en inglés: aún no hay edición en español
  • Formato 215,9 × 279,4 mm
  • 2 columnas, medianil de 7 mm
  • Newsreader 9,6/12,8
  • IBM Plex Mono
  • IBM Plex Sans
  • 7 páginas
  • Nivel
  • Postext 1.65.0
  • Compuesto en 698 ms
  • 247 líneas de código

En pocas palabras

Un artículo famoso de inteligencia artificial, abreviado y compuesto de nuevo. Los prompts de ejemplo y las respuestas del modelo van en recuadros rotulados, uno junto al otro, con una marca de acierto o de error.

Lo que vas a componer

Siete páginas de un preprint de aprendizaje automático en tamaño carta: Chain-of-Thought Prompting Elicits Reasoning in Large Language Models, de Wei et al., abreviado a partir de su versión de arXiv con licencia CC BY 4.0. La primera página lleva la figura más conocida del artículo, compuesta con recuadros en lugar de pegada como imagen: a la izquierda, el prompt estándar; a la derecha, el prompt con cadena de pensamiento. Cada prompt va en un recuadro con la pestaña Model Input y cada respuesta en otro con la pestaña Model Output; los ejemplos, en IBM Plex Mono, y el razonamiento, en negrita de color, con un aspa en la respuesta errónea y una marca en la correcta. El texto cita como lo hacen los artículos de NeurIPS, (Brown et al., 2020), a partir de la bibliografía original convertida en BibTeX. La tabla 2 y dos gráficos están redibujados con los datos que publica el artículo.

Esta receta responde a

  • ¿Cómo compongo en recuadros, uno al lado del otro, los ejemplos de prompt y de respuesta del modelo de un artículo de IA?
  • ¿Cómo vuelvo a componer con Postext un artículo de acceso abierto de arXiv o PubMed Central, con sus citas, sus figuras y su línea de licencia?
  • ¿Cómo cito obras y compongo la bibliografía en APA, IEEE u otro estilo de cita?

La respuesta corta

script.js · líneas 32–56en el código completo
// :::columns{count=2 breaks="4"} inside the "figure" box opens the right column at its fourth
// block; each nested box counts as one block.
const tab = (fill) => ({ fontFamily: SANS, fontSize: pt(7), fontWeight: 600,
  color: col('paper'), background: col(fill), position: 'top-left', inset: mm(3),
  height: mm(4.2), offset: mm(2.1), paddingX: mm(2.2) }); // straddles the top edge
const exemplar = (id, fill, ink, extra) => ({ id, background: col(fill),
  border: { enabled: true, color: col('rule'), width: pt(0.6) }, borderRadius: mm(2.4),
  padding: { top: mm(4.4), right: mm(3), bottom: mm(2.6), left: mm(3) },
  marginTop: mm(4.2), marginBottom: ZERO, label: tab(ink),
  body: { fontFamily: MONO, fontSize: pt(7.8), lineHeight: pt(10.4), color: col('ink'),
    boldColor: col(ink), // **…** marks the chain of thought: the highlight of the original
    textAlign: 'left', hyphenation: false, paragraphSpacing: true, firstLineIndent: ZERO },
  ...extra });
const mark = (id) => ({ icon: { kind: 'resource', resourceId: id, size: mm(5.6),
  position: 'corner', cornerSide: 'right' } }); // a badge on the top-right corner
const promptBoxes = [
  { id: 'figure', span: 'page', backgroundEnabled: false, border: { enabled: false },
    padding: mm(0), columnGap: mm(6), marginTop: ZERO, marginBottom: pt(LEAD),
    body: { fontFamily: SANS, fontSize: pt(8.4), lineHeight: pt(11.4), color: col('ink'),
      boldColor: col('accent'), textAlign: 'left', paragraphSpacing: true,
      firstLineIndent: ZERO } },
  exemplar('input', 'tint', 'accent'),
  exemplar('right', 'mint', 'green', mark('mark-right')),
  exemplar('wrong', 'mint', 'green', mark('mark-wrong')),
];

Ingredientes

Tipografía
Newsreader, IBM Plex Sans, IBM Plex Mono (SIL OFL 1.1)
Recursos
Ninguno: todas las imágenes se dibujan en código

Elaboración

#1 · La figura 1 son tres estilos de recuadro

El código es la respuesta corta. La figura es un recuadro a todo el ancho de la página, sin borde propio; dentro, :::columns{count=2 breaks="4"} abre la columna derecha en el cuarto bloque, y cada recuadro anidado cuenta como un bloque. Los recuadros de prompt y de respuesta salen de la misma función, así que solo cambian el fondo, el color de la pestaña y el distintivo de la esquina: un icon con position: 'corner' admite un recurso SVG, y así llegan a la página la marca y el aspa, que las fuentes del documento no tienen. En tu artículo, escribe cada ejemplo como párrafos normales dentro de un recuadro y marca el razonamiento con **…**: el boldColor del estilo lo convierte en el resaltado.

#2 · Citas autor-año, al modo de natbib

script.js · líneas 60–70en el código completo
registerCitationEngine(createCiteprocEngine({ styles: STYLES, locales: LOCALES }));
// Chicago author-date writes (Brown et al. 2020); ML venues put a comma before the year.
const AUTHOR_YEAR = '<group delimiter=" ">\n            <text macro="author-inline"/>';
const natbib = STYLES['chicago-author-date']
  .replace(AUTHOR_YEAR, AUTHOR_YEAR.replace('" "', '", "'));
const citations = { style: 'custom', customStyle: natbib, link: true,
  bibliography: { fontSize: em(0.8), lineHeight: pt(10.2), entrySpacing: pt(1.8),
    hangingIndent: mm(4), doi: 'text' } };
// The text's two web addresses are links: clickable in the PDF, printed in parentheses on
// paper, `[name census data](https://namecensus.com/)` as "name census data (namecensus.com)".
const links = { print: 'inline', urlDisplay: 'short' };

Los congresos de aprendizaje automático usan el aspecto autor-año de natbib: una coma entre el nombre y el año, y et al. a partir de tres autores. El estilo incluido más parecido es Chicago autor-fecha, así que la receta cambia un grupo de su CSL, el que une autor y año, de un espacio a una coma. Trae tu archivo .bib tal cual: pégalo en un bloque :::references{format=bibtex} y cita con [@clave] para (Brown et al., 2020) y con @clave para Brown et al. (2020). Un sufijo conserva la coma que lo precede y su énfasis, así que [@brown2020language, *inter alia*] imprime (Brown et al., 2020, inter alia) como el artículo. Los pies citan igual: el de la figura 4 escribe @jie2022learning y @lan2021mwptoolkit, y las dos obras entran en la lista de referencias sin nocite.

Las dos direcciones web del texto, los datos del censo de nombres de la sección 5 y la licencia del colofón, se escriben como enlaces, [name census data](https://namecensus.com/). Con links: { print: 'inline', urlDisplay: 'short' } el papel imprime cada dirección entre paréntesis detrás de su texto, sin https://, y el PDF conserva el enlace. Una dirección escrita como texto llano se imprime igual, pero no lleva a ninguna parte al pulsarla.

#3 · El bloque del título

script.js · líneas 74–91en el código completo
const text = (id, content, family, size, extra) => ({ kind: 'text', id, content, align: 'left',
  fontFamily: family, fontSize: pt(size), color: col('ink'), overflow: 'wrap', ...extra });
const at = (to, edge, y, width = MEASURE) => ({ anchor: { to, edge },
  offset: { x: ZERO, y: mm(y) }, size: { width: mm(width), height: 'auto' } });
const titleBlock = { enabled: true, minHeight: mm(58), slot: { elements: [
  text('venue', '{attr.venue}', MONO, 7.5, { fontWeight: 500, letterSpacing: pt(0.6),
    color: col('accent'), placement: at('container', 'top-left', 0) }),
  text('title', '{titleText}', SERIF, 23, { fontWeight: 600, lineHeight: 1.1,
    placement: at('#venue', 'below', 5) }),
  text('authors', '{attr.authors}', SANS, 9.6, { fontWeight: 500, lineHeight: 1.45,
    placement: at('#title', 'below', 6) }),
  text('affiliation', '{attr.affiliation}', SANS, 8.6, { color: col('muted'),
    placement: at('#authors', 'below', 1.2) }),
  { kind: 'rule', id: 'rule', thickness: pt(0.5), color: col('rule'),
    placement: at('#affiliation', 'below', 4) },
  text('note', '{attr.note}', SERIF, 8.2, { lineHeight: 1.35,
    color: col('muted'), placement: at('#rule', 'below', 2) }),
] } };

El título es el único encabezado de nivel 1 del documento, con un estilo que ocupa las dos columnas y dibuja un bloque diseñado: la línea del congreso, el título, los autores en dos filas, la afiliación y una nota sobre la versión abreviada. Los autores y la nota son atributos del encabezado, y un \n dentro de un atributo abre una fila nueva, como \\ en el \author de LaTeX. Para tu artículo, cambia los atributos; el diseño se queda.

#4 · Números de figura iguales a los del original

script.js · líneas 95–106en el código completo
// Figure 1 is boxes, which the figure counter does not see: number the charts by type.
const numbered = (id, word, n, extra) => ({ id, name: `${word} ${n}`,
  shortLabel: `${word} ${n}`, captionPrefix: `${word} ${n}`, numberingTemplate: '',
  resetOn: 'never', counterFormat: 'decimal', ...extra });
const resourceTypes = [numbered('mark', 'Mark', ''), numbered('fig2', 'Figure', 2),
  numbered('fig4', 'Figure', 4),
  numbered('tab2', 'Table', 2, { captionStyle: { position: 'above' } })];
const ACROSS = { position: 'top', span: 'page' }; // a float over both columns
const svg = (id, typeId, file, [width, height], caption, note, altText, placement) => ({
  id, typeId, kind: 'svg', createdAt: 0, updatedAt: 0,
  placement: placement ?? { position: 'top' }, svg: { fileId: file, width, height },
  caption, note, altText });

El motor numera las figuras por el orden en que se citan por primera vez, pero aquí la figura 1 es un recuadro y el contador no la ve. Por eso cada gráfico redibujado tiene su propio tipo de recurso, con el número escrito en la etiqueta y un numberingTemplate vacío, y conserva el número de la versión de arXiv: figura 2, figura 4 y tabla 2. En un artículo propio, donde todas las figuras son recursos, basta un tipo figure con numberingTemplate: '{n}'.

#5 · La tabla 2 a partir de los datos del artículo

script.js · líneas 480–508en el código completo
const SETS = ['GSM8K', 'SVAMP', 'ASDiv', 'AQuA', 'MAWPS'];
const RESULTS = [ // model, size, then standard / CoT pairs per benchmark; * CoT beats standard
  ['UL2', '20B', '4.1 4.4* 10.1 12.5* 16.0 16.9* 20.5 23.6* 16.6 19.1*'],
  ['LaMDA', '420M', '2.6 0.4 2.5 1.6 3.2 0.8 23.5 8.3 3.2 0.9'],
  ['', '2B', '3.6 1.9 3.3 2.4 4.1 3.8 22.9 17.7 3.9 3.1'],
  ['', '8B', '3.2 1.6 4.3 3.4 5.9 5.0 22.8 18.6 5.3 4.8'],
  ['', '68B', '5.7 8.2* 13.6 18.8* 21.8 23.1* 22.3 20.2 21.6 30.6*'],
  ['', '137B', '6.5 14.3* 29.5 37.5* 40.1 46.6* 25.5 20.6 43.2 57.9*'],
  ['GPT', '350M', '2.2 0.5 1.4 0.8 2.1 0.8 18.1 8.7 2.4 1.1'],
  ['', '1.3B', '2.4 0.5 1.5 1.7 2.6 1.4 12.6 4.3 3.1 1.7'],
  ['', '6.7B', '4.0 2.4 6.1 3.1 8.6 3.6 15.4 13.4 8.8 3.5'],
  ['', '175B', '15.6 46.9* 65.7 68.9* 70.3 71.3* 24.8 35.8* 72.7 87.1*'],
  ['Codex', '–', '19.7 63.1* 69.9 76.4* 74.0 80.4* 29.5 45.3* 78.7 92.6*'],
  ['PaLM', '8B', '4.9 4.1 15.1 16.8* 23.7 25.2* 19.3 21.7* 26.2 30.5*'],
  ['', '62B', '9.6 29.9* 48.2 46.7 58.7 61.9* 25.6 22.4 61.8 80.3*'],
  ['', '540B', '17.9 56.9* 69.4 79.0* 72.1 73.9* 25.2 35.8* 79.2 93.3*'],
];
const cell = (content, extra) => ({ content, align: 'right', ...extra });
const tableRows = () => [
  [cell('Model', { isHeader: true, align: 'left', colSpan: 2 }), { content: '',
    hiddenBy: { row: 0, col: 0 } }, // gotcha: merged-cells-hiddenby
  ...SETS.flatMap((set, i) => [cell(set, { isHeader: true, align: 'center', colSpan: 2 }),
    { content: '', hiddenBy: { row: 0, col: 2 + 2 * i } }])],
  [cell('', { isHeader: true }), cell('', { isHeader: true }),
    ...SETS.flatMap(() => [cell('standard', { isHeader: true }), cell('CoT', { isHeader: true })])],
  ...RESULTS.map(([model, size, values]) => [cell(model ? `**${model}**` : '', { align: 'left' }),
    cell(size, { align: 'left' }),
    ...values.split(' ').map((v) => cell(v.endsWith('*') ? `**${v.slice(0, -1)}**` : v))]),
];

Los resultados se escriben una sola vez, como están en el LaTeX, y alimentan la tabla 2 y la figura 4, así que el gráfico no puede contradecir la tabla. Cada prueba ocupa dos columnas; una celda combinada necesita, donde se extiende, celdas de relleno marcadas con hiddenBy. La negrita señala las celdas en las que la cadena de pensamiento supera al prompt estándar, como las celdas verdes del original.

La receta completa

Sandbox
// ═══ Postext Cookbook · Nº 137 · An AI preprint with prompt exemplars in boxes ═══════
// https://postext.dev/en/cookbook/ai-preprint-prompt-exemplars
// Code: MIT · Text: Wei et al. 2022, arXiv:2201.11903 (CC BY 4.0) · Charts: drawn in code
// Fonts: Newsreader, IBM Plex Sans, IBM Plex Mono (SIL OFL 1.1) · Needs postext ≥ 1.65.0
import {
  buildDocumentWithFonts, renderPageToCanvas, registerCitationEngine, registerResourceImage,
  inlineSvgFonts,
} 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 = 'en'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'ai-preprint-prompt-exemplars';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: a cool ink, a prompt blue, an answer green and a red for the wrong answer
const palette = { ink: '#1b1e24', accent: '#1f5fa6', green: '#21744a', red: '#b3362d',
  tint: '#e9f0f8', mint: '#e6f2eb', rule: '#b4bcc8', muted: '#5b6270', 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, MONO] = ['Newsreader', 'IBM Plex Sans', 'IBM Plex Mono'];
// US letter, two columns of 85.5 mm as ML venues print.
const [TRIM_W, TRIM_H, TOP, BOTTOM, SIDE, GUTTER] = [215.9, 279.4, 22, 22, 19, 7];
const MEASURE = TRIM_W - 2 * SIDE;
const COLUMN = (MEASURE - GUTTER) / 2;
const LEAD = 12.8; // pt
const ZERO = pt(0);

// #region answer: Figure 1 as boxes: two columns, a tab on each box, a ✓ or ✗ in the corner
// :::columns{count=2 breaks="4"} inside the "figure" box opens the right column at its fourth
// block; each nested box counts as one block.
const tab = (fill) => ({ fontFamily: SANS, fontSize: pt(7), fontWeight: 600,
  color: col('paper'), background: col(fill), position: 'top-left', inset: mm(3),
  height: mm(4.2), offset: mm(2.1), paddingX: mm(2.2) }); // straddles the top edge
const exemplar = (id, fill, ink, extra) => ({ id, background: col(fill),
  border: { enabled: true, color: col('rule'), width: pt(0.6) }, borderRadius: mm(2.4),
  padding: { top: mm(4.4), right: mm(3), bottom: mm(2.6), left: mm(3) },
  marginTop: mm(4.2), marginBottom: ZERO, label: tab(ink),
  body: { fontFamily: MONO, fontSize: pt(7.8), lineHeight: pt(10.4), color: col('ink'),
    boldColor: col(ink), // **…** marks the chain of thought: the highlight of the original
    textAlign: 'left', hyphenation: false, paragraphSpacing: true, firstLineIndent: ZERO },
  ...extra });
const mark = (id) => ({ icon: { kind: 'resource', resourceId: id, size: mm(5.6),
  position: 'corner', cornerSide: 'right' } }); // a badge on the top-right corner
const promptBoxes = [
  { id: 'figure', span: 'page', backgroundEnabled: false, border: { enabled: false },

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

#Cita en APA

APA escribe (Roy & Roth, 2015) y lista hasta veinte autores, algo que la bibliografía de un artículo sobre modelos grandes rara vez quiere.

-const citations = { style: 'custom', customStyle: natbib, link: true,
+const citations = { style: 'apa', link: true,

#Compón el artículo a una columna

Una columna al estilo de NeurIPS necesita márgenes laterales más anchos para que la línea siga siendo legible; los recuadros a todo el ancho ocupan entonces esa columna.

-const [TRIM_W, TRIM_H, TOP, BOTTOM, SIDE, GUTTER] = [215.9, 279.4, 22, 22, 19, 7];
+const [TRIM_W, TRIM_H, TOP, BOTTOM, SIDE, GUTTER] = [215.9, 279.4, 24, 24, 38, 7];
-  layout: { layoutType: 'double', gutterWidth: mm(GUTTER) },
+  layout: { layoutType: 'single' },

#Listados de código en recuadros

Si tus prompts llevan código, los recuadros de Listados de código y teclas colorean la sintaxis con tramos en negrita y cursiva.

Errores frecuentes

Error frecuente

Un recuadro anidado ignora span, placement y snapToGrid

Un recuadro anidado en otro ignora su span, placement, snapToGrid y floatBarrier: siempre se compone dentro del recuadro que lo contiene, con el ancho interior de este. Recuadros anidados →

Error frecuente

Las celdas combinadas necesitan hiddenBy: usa mergeCells

Las celdas se colocan según su posición en la fila, así que una celda combinada necesita celdas de relleno marcadas con hiddenBy donde se extiende; omitirlas, como en HTML, desplaza todas las columnas siguientes. Combina celdas con mergeCells. Desde postext 1.5 una tabla con una rejilla irregular se anota en doc.contentWarnings como raggedTableGrid, y parseTSV(texto, { headerRows }) marca las filas de cabecera. Tablas a partir de datos →

  • Un recuadro a todo el ancho en una maqueta de dos columnas entra en la página actual solo si cabe con al menos un par de líneas de texto debajo. La figura 1 queda en la página 1 porque el resumen va en cuerpo 9,3 con un relleno ajustado; un resumen más largo la manda a la página 2.

Créditos

Texto
Fuentes
Newsreader (SIL OFL 1.1) · IBM Plex Sans (SIL OFL 1.1) · IBM Plex Mono (SIL OFL 1.1)
SandboxPDF