Saltar al contingut principal
Recepta número 137

Receptari · Capítol 6 · Requadres i notes

Un preprint d'IA amb exemples de prompt en requadres

L'article de la cadena de pensament, recompost: prompts i respostes en requadres amb pestanya, cites autor-any des de BibTeX i gràfics des de les taules.

  • Mostra en anglès: encara no hi ha edició en català
  • Format 215,9 × 279,4 mm
  • 2 columnes, espai entre columnes de 7 mm
  • Newsreader 9,6/12,8
  • IBM Plex Mono
  • IBM Plex Sans
  • 7 pàgines
  • Nivell
  • Postext 1.65.0
  • Compost en 698 ms
  • 247 línies de codi

En poques paraules

Un article famós d'intel·ligència artificial, abreujat i compost de nou. Els prompts d'exemple i les respostes del model van en requadres retolats, l'un al costat de l'altre, amb una marca d'encert o d'error.

Què compondràs

Set pàgines d'un preprint d'aprenentatge automàtic en mida carta: Chain-of-Thought Prompting Elicits Reasoning in Large Language Models, de Wei et al., abreujat a partir de la versió d'arXiv amb llicència CC BY 4.0. La primera pàgina porta la figura més coneguda de l'article, composta amb requadres en lloc d'enganxada com a imatge: a l'esquerra, el prompt estàndard; a la dreta, el prompt amb cadena de pensament. Cada prompt va en un requadre amb la pestanya Model Input i cada resposta en un altre amb la pestanya Model Output; els exemples, en IBM Plex Mono, i el raonament, en negreta de color, amb una creu a la resposta errònia i una marca a la correcta. El text cita com ho fan els articles de NeurIPS, (Brown et al., 2020), a partir de la bibliografia original convertida en BibTeX. La taula 2 i dos gràfics estan redibuixats amb les dades que publica l'article.

Aquesta recepta respon a

  • Com componc en requadres, l'un al costat de l'altre, els exemples de prompt i de resposta del model d'un article d'IA?
  • Com torno a compondre amb Postext un article d'accés obert d'arXiv o PubMed Central, amb les seves cites, les seves figures i la seva línia de llicència?
  • Com cito obres i componc la bibliografia en APA, IEEE o un altre estil de cita?

La resposta curta

script.js · línies 32–56al codi complet
// :::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')),
];

Ingredients

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

Elaboració

#1 · La figura 1 són tres estils de requadre

El codi és la resposta curta. La figura és un requadre a tota l'amplada de la pàgina, sense marc propi; a dins, :::columns{count=2 breaks="4"} obre la columna dreta al quart bloc, i cada requadre imbricat compta com un bloc. Els requadres de prompt i de resposta surten de la mateixa funció, de manera que només canvien el fons, el color de la pestanya i el distintiu de la cantonada: un icon amb position: 'corner' admet un recurs SVG, i així arriben a la pàgina la marca i la creu, que les fonts del document no tenen. Al teu article, escriu cada exemple com a paràgrafs normals dins d'un requadre i marca el raonament amb **…**: el boldColor de l'estil el converteix en el ressaltat.

#2 · Cites autor-any, a la manera de natbib

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

Els congressos d'aprenentatge automàtic fan servir l'aspecte autor-any de natbib: una coma entre el nom i l'any, i et al. a partir de tres autors. L'estil inclòs més semblant és Chicago autor-data, així que la recepta canvia un grup del seu CSL, el que uneix autor i any, d'un espai a una coma. Porta el teu fitxer .bib tal com és: enganxa'l en un bloc :::references{format=bibtex} i cita amb [@clau] per a (Brown et al., 2020) i amb @clau per a Brown et al. (2020). Un sufix conserva la coma que el precedeix i el seu èmfasi, així que [@brown2020language, *inter alia*] imprimeix (Brown et al., 2020, inter alia) com l'article. Els peus citen igual: el de la figura 4 escriu @jie2022learning i @lan2021mwptoolkit, i les dues obres entren a la llista de referències sense nocite.

Les dues adreces web del text, les dades del cens de noms de la secció 5 i la llicència del colofó, s'escriuen com a enllaços, [name census data](https://namecensus.com/). Amb links: { print: 'inline', urlDisplay: 'short' } el paper imprimeix cada adreça entre parèntesis darrere del seu text, sense https://, i el PDF conserva l'enllaç. Una adreça escrita com a text pla s'imprimeix igual, però no porta enlloc quan s'hi fa clic.

#3 · El bloc del títol

script.js · línies 74–91al codi complet
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ítol és l'únic títol de nivell 1 del document, amb un estil que ocupa les dues columnes i dibuixa un bloc dissenyat: la línia del congrés, el títol, els autors en dues files, l'afiliació i una nota sobre la versió abreujada. Els autors i la nota són atributs del títol, i un \n dins d'un atribut obre una fila nova, com \\ a l'\author de LaTeX. Per al teu article, canvia els atributs; el disseny es queda.

#4 · Números de figura iguals als de l'original

script.js · línies 95–106al codi complet
// 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 les figures per l'ordre en què es citen per primer cop, però aquí la figura 1 és un requadre i el comptador no la veu. Per això cada gràfic redibuixat té el seu tipus de recurs, amb el número escrit a l'etiqueta i un numberingTemplate buit, i conserva el número de la versió d'arXiv: figura 2, figura 4 i taula 2. En un article propi, on totes les figures són recursos, n'hi ha prou amb un tipus figure amb numberingTemplate: '{n}'.

#5 · La taula 2 a partir de les dades de l'article

script.js · línies 480–508al codi complet
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))]),
];

Els resultats s'escriuen una sola vegada, com són al LaTeX, i alimenten la taula 2 i la figura 4, de manera que el gràfic no pot contradir la taula. Cada prova ocupa dues columnes; una cel·la combinada necessita, on s'estén, cel·les de farciment marcades amb hiddenBy. La negreta assenyala les cel·les en què la cadena de pensament supera el prompt estàndard, com les cel·les verdes de l'original.

La recepta 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 },

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

#Cita en APA

APA escriu (Roy & Roth, 2015) i llista fins a vint autors, cosa que la bibliografia d'un article sobre models grans poques vegades vol.

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

#Compon l'article a una columna

Una columna a l'estil de NeurIPS necessita marges laterals més amples perquè la línia continuï sent llegible; els requadres a tota l'amplada ocupen llavors aquesta 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' },

#Llistats de codi en requadres

Si els teus prompts porten codi, els requadres de Llistats de codi i tecles acoloreixen la sintaxi amb trams en negreta i cursiva.

Errors freqüents

Error freqüent

Un requadre imbricat ignora span, placement i snapToGrid

Un requadre imbricat en un altre ignora el seu span, placement, snapToGrid i floatBarrier: sempre es compon dins del requadre que el conté, amb l'amplada interior d'aquest. Requadres niats →

Error freqüent

Les cel·les combinades necessiten hiddenBy: fes servir mergeCells

Les cel·les es col·loquen segons la seva posició a la fila, així que una cel·la combinada necessita cel·les de farciment marcades amb hiddenBy on s'estén; ometre-les, com en HTML, desplaça totes les columnes següents. Combina cel·les amb mergeCells. Des de postext 1.5 una taula amb una graella irregular s'anota a doc.contentWarnings com a raggedTableGrid, i parseTSV(text, { headerRows }) marca les files de capçalera. Taules a partir de dades →

  • Un requadre a tota l'amplada en una maqueta de dues columnes entra a la pàgina actual només si hi cap amb almenys un parell de línies de text a sota. La figura 1 queda a la pàgina 1 perquè el resum va en cos 9,3 amb un farciment ajustat; un resum més llarg l'envia a la pàgina 2.

Crèdits

Text
Fonts
Newsreader (SIL OFL 1.1) · IBM Plex Sans (SIL OFL 1.1) · IBM Plex Mono (SIL OFL 1.1)
SandboxPDF