Saltar al contenido principal
Receta número 114

Recetario · Capítulo 1 · Página y retícula

Una página de Bulaq: el texto enmarcado por su comentario

El comentario de Ibn ʿAqīl en la columna principal y las glosas en la lateral exterior, junto a lo que explican, dentro de un marco de filetes dobles.

En esta página
Salida
Canvas · PDF
Postext
Probada con Postext 1.65.0
Requiere ≥ 1.28.0 · postext-pdf ≥ 1.28.0
Licencia
Actualizada el 11 oct 2026
Código MIT · Texto MIT

pp. ٢–٣ · 2–3 de 6

  • Formato 170 × 240 mm
  • Columna y media, medianil de 7 mm
  • Amiri 12,5/22
  • Aref Ruqaa
  • 6 páginas
  • Nivel
  • Postext 1.65.0
  • Compuesto en 131 ms
  • 139 líneas de código

En pocas palabras

Una página hecha como los libros árabes impresos en El Cairo en el siglo XIX: el texto principal en el centro, notas breves sobre él en una columna estrecha junto al borde y toda la página encerrada entre filetes impresos.

Lo que vas a componer

Seis páginas compuestas como imprimían un comentario la imprenta de Bulaq y sus sucesoras de El Cairo en el siglo XIX. La explicación de Ibn ʿAqīl a los primeros versos de la Alfiyya, la gramática en mil versos de Ibn Mālik, corre por la columna principal, con los versos en rojo; en el margen exterior va una ḥāshiya, glosas breves que empiezan con las palabras del texto que explican, junto al pasaje al que pertenecen. Un filete doble enmarca la caja, con una banda en la cabeza para el capítulo y el folio, y un filete simple separa el texto de su margen. En una página de Bulaq auténtica la ḥāshiya rodea el texto por tres lados; Postext la pone en uno solo, y la receta lo dice.

Esta receta responde a

  • ¿Cómo compongo una página de Bulaq, con el comentario enmarcado alrededor del texto?

La respuesta corta

script.js · líneas 31–45en el código completo
// The text runs in the main column of a column-and-a-half layout; the side column, on the
// outer side, takes only boxes with span 'side'. A gloss is written before the passage it
// explains and starts level with its first line, on the page where that passage goes on
// (sideAtColumnEnd: 'after'). A column rule parts the two, as the jadwal of a Bulaq page does.
const layout = { layoutType: 'oneAndHalf', sideColumnRole: 'floats', sideColumnSide: 'outer',
  sideColumnPercent: 31, gutterWidth: mm(7),
  columnRule: { enabled: true, color: col('rule'), lineWidth: pt(0.6) } };
// A gloss is a callout with no box: the margin's own face, its lemma bold in the rubric.
const hashiya = { id: 'hashiya', span: 'side', sideAtColumnEnd: 'after',
  backgroundEnabled: false, borderRadius: pt(0),
  padding: { top: pt(0), right: pt(0), bottom: pt(0), left: pt(0) },
  stripe: { enabled: false }, border: { enabled: false },
  body: { fontFamily: NASKH, fontSize: pt(10), lineHeight: pt(16), color: col('ink'),
    boldColor: col('rubric'), textAlign: 'justify', firstLineIndent: pt(0),
    paragraphSpacing: true } };

Ingredientes

Tipografía
Amiri, Aref Ruqaa (SIL OFL 1.1)
Recursos
Ninguno: todas las imágenes se dibujan en código

Elaboración

#1 · La ḥāshiya en una columna lateral propia

El código es la respuesta corta de arriba. Un diseño en columna y media cuya columna lateral solo admite flotantes deja el comentario fuera del flujo del texto: cada glosa es un :::callout{type="hashiya" span="side"} escrito antes del pasaje que explica, y empieza a la altura de su primera línea; sideAtColumnEnd: 'after' lo mantiene junto al pasaje cuando este sigue en la página siguiente (Disposición). El recuadro no tiene fondo, borde ni relleno, así que se lee como texto compuesto en el margen, con el lema en negrita, que boldColor pone en rojo. sideColumnSide: 'outer' lleva la columna al corte delantero de las dos páginas: a la derecha de la página par, que en un libro encuadernado por la derecha queda a la derecha de la doble página.

Página 2: la glosa sobre «كديز» empieza a la altura del párrafo que usa la palabra, en el borde exterior, tras el filete de columna.

#2 · Un marco dibujado para cada lado del pliego

script.js · líneas 49–79en el código completo
// Page-level design elements are physical: the frame follows the margins of each side of
// the spread. In a book bound on the right the even page is the right-hand one, its spine
// on its left, so its inner margin is the left one. A heading's design is set in the flow
// and mirrored with the page (inFlow): there 'left' is the sheet's right.
const frame = (parity, withBand = true, inFlow = false) => {
  const left = (parity === 'even') !== inFlow ? M.inner : M.outer;
  const width = TRIM.width - M.inner - M.outer;
  const box = (id, inset, thickness) => ({ kind: 'box', id: `${id}-${parity}`, parity,
    style: { borderColor: col('rule'), borderWidth: pt(thickness) },
    placement: { anchor: { to: 'page', edge: 'top-left' },
      offset: { x: mm(left - 4 + inset), y: mm(M.top - 13 + inset) },
      size: { width: mm(width + 8 - 2 * inset),
        height: mm(TRIM.height - M.top - M.bottom + 17 - 2 * inset) } } });
  return [box('outer', 0, 1.4), box('inner', 1.3, 0.4), ...(withBand ? [
    { kind: 'rule', id: `band-${parity}`, parity, direction: 'horizontal', thickness: pt(0.4),
      color: col('rule'), placement: { anchor: { to: 'page', edge: 'top-left' },
        offset: { x: mm(left - 2.7), y: mm(M.top - 4) },
        size: { width: mm(width + 5.4) } } }] : [])];
};
// The chapter centred in the band, the folio at its outer end. The frame stands off the
// sheet's centre by half the difference of the margins, towards the outer edge.
const SHIFT = (M.inner - M.outer) / 2; // mm
const band = (id, content, parity, edge, x, extra = {}) => ({ kind: 'text', id, content,
  parity, pages: 'body', fontFamily: NASKH, fontWeight: 700, fontSize: pt(10.5),
  color: col('ink'),
  placement: { anchor: { to: 'page', edge }, offset: { x: mm(x), y: mm(M.top - 11) } }, ...extra });
const header = { elements: [...frame('even'), ...frame('odd'),
  band('head-even', '{chapterTitle}', 'even', 'top', SHIFT),
  band('head-odd', '{chapterTitle}', 'odd', 'top', -SHIFT),
  band('folio-even', '{pageNumber}', 'even', 'top-right', -(M.outer + 1), { pages: 'all' }),
  band('folio-odd', '{pageNumber}', 'odd', 'top-left', M.outer + 1, { pages: 'all' })] };

El marco son tres elementos de diseño de página en la cabecera: dos cajas con borde y sin relleno, separadas 1,3 mm, y un filete bajo la banda que lleva la cabecera. Los elementos de página son físicos, así que el marco se construye dos veces, una por paridad, con los márgenes de ese lado (Orden de las páginas y encuadernación por la derecha). El folio va en el extremo exterior de la banda en todas las páginas, también en las aperturas; el título del capítulo va centrado y no aparece en la apertura, donde el propio título queda debajo.

#3 · Una portada dentro del mismo marco

script.js · líneas 83–101en el código completo
const line = (id, content, y, style) => ({ kind: 'text', id, content, align: 'center',
  overflow: 'wrap', color: col('ink'),
  // Centred in the frame: the title page is an odd page set in the mirrored flow.
  placement: { anchor: { to: 'page', edge: 'top' }, offset: { x: mm(SHIFT), y: mm(y) },
    size: { width: mm(110) } }, ...style });
const titlePage = { id: 'title', span: 'page', runningChapter: false,
  breakBefore: { enabled: true, parity: 'any' }, header: { elements: [] },
  footer: { elements: [] },
  advancedDesign: { enabled: true, slot: { elements: [...frame('odd', false, true),
    line('book', '{titleText}', 64, { fontFamily: RUQAA, fontWeight: 700, fontSize: pt(40),
      lineHeight: 1.3, color: col('rubric') }),
    line('on', '{attr.on}', 88, { fontFamily: NASKH, fontWeight: 700, fontSize: pt(17) }),
    { kind: 'rule', id: 'rule', direction: 'horizontal', thickness: pt(0.75), color: col('rubric'),
      placement: { anchor: { to: 'page', edge: 'top' }, offset: { x: mm(SHIFT), y: mm(104) },
        size: { width: mm(30) } } },
    line('margin', '{attr.margin}', 112, { fontFamily: NASKH, fontSize: pt(13) }),
    line('latin', '{attr.latin}', 196, { fontFamily: NASKH, fontSize: pt(9), italic: true,
      color: col('muted') }),
  ] } } };

La portada reutiliza el marco sin la banda. El diseño de un título se compone en el flujo y se refleja con la página, así que allí el marco se construye con los lados cambiados (inFlow): su izquierda es la derecha de la hoja. Sus líneas salen de atributos del encabezado, on y margin, de modo que toda la portada es una línea de Markdown, y la línea latina de debajo cambia con la edición.

La receta completa

Sandbox
// ═══ Postext Cookbook · Nº 114 · A Bulaq page: the text framed by its commentary ════════
// https://postext.dev/en/cookbook/bulaq-framed-page
// Code: MIT · Text: Ibn ʿAqīl, Sharḥ; Ibn Mālik, Alfiyya, ar.wikisource (PD) · Pictures: none
// Fonts: Amiri, Aref Ruqaa (SIL OFL 1.1) · Needs postext ≥ 1.28.0
import { buildDocument, withLoadedFonts, renderPageToCanvas } from 'https://esm.sh/postext';
import { renderToPdf, decompressWoff2 } from 'https://esm.sh/postext-pdf';

const LANG = 'es'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'bulaq-framed-page';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// Black and a brown-red on a toned paper: the two inks of a Cairo press around 1900.
const palette = {
  ink: '#1d1915', // text and frame rules
  rubric: '#8e3020', // the accent: lemmas of the glosses, the matn, titles
  rule: '#3a312a', // the frame
  muted: '#6a6056', // the note on the text
  paper: '#f6efe0', // a toned paper
};
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = [
  ...Object.entries(palette).map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } })),
  { id: 'main-color', name: 'rubric (defaults)', value: { hex: palette.rubric, model: 'hex' } },
];
const NASKH = 'Amiri'; // the text, the matn and the glosses
const RUQAA = 'Aref Ruqaa'; // the title page and the chapter title
const TRIM = { width: 170, height: 240 }; // mm
const M = { top: 34, bottom: 24, inner: 20, outer: 15 }; // mm: the type area inside the frame

// #region answer: the commentary's column beside the text, both inside one ruled frame
// The text runs in the main column of a column-and-a-half layout; the side column, on the
// outer side, takes only boxes with span 'side'. A gloss is written before the passage it
// explains and starts level with its first line, on the page where that passage goes on
// (sideAtColumnEnd: 'after'). A column rule parts the two, as the jadwal of a Bulaq page does.
const layout = { layoutType: 'oneAndHalf', sideColumnRole: 'floats', sideColumnSide: 'outer',
  sideColumnPercent: 31, gutterWidth: mm(7),
  columnRule: { enabled: true, color: col('rule'), lineWidth: pt(0.6) } };
// A gloss is a callout with no box: the margin's own face, its lemma bold in the rubric.
const hashiya = { id: 'hashiya', span: 'side', sideAtColumnEnd: 'after',
  backgroundEnabled: false, borderRadius: pt(0),
  padding: { top: pt(0), right: pt(0), bottom: pt(0), left: pt(0) },
  stripe: { enabled: false }, border: { enabled: false },
  body: { fontFamily: NASKH, fontSize: pt(10), lineHeight: pt(16), color: col('ink'),
    boldColor: col('rubric'), textAlign: 'justify', firstLineIndent: pt(0),
    paragraphSpacing: true } };
// #endregion

// #region frame: a double rule round the type area and a band for the running head

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

#Pon el comentario en el lado interior

Algunas imprentas ponen la ḥāshiya junto al lomo, y el texto conserva el margen exterior, más ancho.

-const layout = { layoutType: 'oneAndHalf', sideColumnRole: 'floats', sideColumnSide: 'outer',
+const layout = { layoutType: 'oneAndHalf', sideColumnRole: 'floats', sideColumnSide: 'inner',

#Encierra cada glosa en un filete

Un filete fino alrededor de cada glosa, como en algunos impresos cairotas posteriores, es el borde propio del recuadro.

-  stripe: { enabled: false }, border: { enabled: false },
+  stripe: { enabled: false }, border: { enabled: true, width: pt(0.4), color: col('rule') },

Errores frecuentes

Error frecuente

Etiqueta un libro árabe 'ar', no con LANG

Las ediciones de una receta son en y es, pero una muestra árabe es árabe en las dos: `locale: LANG` la compondría de izquierda a derecha, la encuadernaría por la izquierda, numeraría sus páginas 1 2 3 y llamaría Figure o Figura a sus figuras. Desde postext 1.30 la etiqueta es además el idioma en el que se compone el texto (en el que se mide, se pinta y se incrusta), así que bajo una etiqueta inglesa o española una fuente como Markazi Text no dibuja las formas árabes de sus comillas angulares y sus puntos, y las líneas se parten por otro sitio. Escribe tú la etiqueta: 'ar' (cifras arábigo-índicas, la convención del Mashriq), una región como 'ar-EG' o 'ar-SA', o 'ar-MA', 'ar-DZ' o 'ar-TN' para una edición magrebí con cifras europeas. Una página latina que solo cita árabe conserva su propio locale. Texto de derecha a izquierda →

Error frecuente

Las fuentes árabes necesitan su archivo arabic, con el bloque arabic

Fontsource sirve Amiri, Noto Naskh Arabic o Scheherazade New en un archivo por subconjunto, y las letras árabes están en el archivo arabic. loadFonts solo descarga latin (y latin-ext), así que en pantalla el árabe sale de una fuente del sistema y se mide mal, y fontsourceProvider entrega al PDF ese archivo latin, que imprime cajas vacías. Añade el bloque arabic del kit, llama a loadArabicFonts(FONTS, markdown) después de loadFonts, con todos los pesos que las páginas usan en árabe listados en FONTS, y pasa a renderToPdf fontProvider: arabicPdfProvider. Fuentes árabes →

Créditos

Texto
  • El comentario de Ibn ʿAqīl al comienzo de la Alfiyya, con los versos de Ibn Mālik, tal como lo da ar.wikisource (revisión 521625), sin las notas del editor moderno · Ibn ʿAqīl, Ibn Mālik · dominio público
  • Las glosas del margen, la portada, la nota sobre el texto y el colofón · Postext Cookbook · original
Fuentes
Amiri (SIL OFL 1.1) · Aref Ruqaa (SIL OFL 1.1)
SandboxPDF