Saltar al contenido principal
Receta número 105

Recetario · Capítulo 2 · Texto y tipografía

Una novela árabe compuesta de derecha a izquierda

Una novela árabe en 14 × 21 cm: con locale 'ar' el texto va de derecha a izquierda, el libro se encuaderna por la derecha y los folios dicen ١٢.

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

pp. ١٠–١١ · 1–2 de 7

  • Formato 140 × 210 mm
  • 1 columna
  • Markazi Text 13,5/22
  • Noto Kufi Arabic
  • Reem Kufi
  • 7 páginas
  • Nivel
  • Postext 1.57.1
  • Compuesto en 81 ms
  • 161 líneas de código

En pocas palabras

Las primeras páginas de una novela escrita en árabe, como las imprimiría una editorial árabe: las líneas van de derecha a izquierda, el libro se abre por lo que un lector occidental llama el final y los números de página usan cifras árabes.

Lo que vas a componer

El comienzo de حروف من رصاص (Letras de plomo), una novela sobre un nieto que vuelve a abrir la imprenta de su abuelo en un callejón de El Cairo, compuesta como una edición árabe en rústica: 14 × 21 cm, Markazi Text de 13,5 pt sobre 22 pt de interlineado, justificado, con la sangría a la derecha. El fragmento empieza en la página 10 con una portadilla de parte en el azul de la puerta de la imprenta, una celosía de estrellas de ocho puntas dibujada con código y el nombre de la parte en Reem Kufi de 64 pt. Enfrente, en la página izquierda, se abre el capítulo, numerado en letras: الفصل الأول. Los folios dicen ١٠, ١١, ١٢; el título del libro va sobre las páginas derechas y el del capítulo sobre las izquierdas. Una novela en rústica compone el mismo tipo de libro de izquierda a derecha.

Esta receta responde a

  • ¿Cómo compongo un libro árabe de derecha a izquierda y lo encuaderno por la derecha?

La respuesta corta

script.js · líneas 35–50en el código completo
const page = {
  width: mm(TRIM.width), height: mm(TRIM.height), dpi: 150, backgroundColor: col('paper'),
  // left and right are the flow's sides: in a right-to-left book left is the spine side,
  // so these margins put 20 mm at the spine and 16 mm outside on both pages of a spread.
  margins: { top: mm(23), bottom: mm(22), left: mm(20), right: mm(OUTER), mirror: true },
  // binding: 'auto' (unset) is 'right' for a right-to-left locale: page 1 is a left page.
};
const bodyText = {
  fontFamily: TEXT, fontSize: pt(BODY), lineHeight: pt(LEAD), color: col('ink'),
  boldColor: col('ink'), italicColor: col('ink'), referenceColor: col('ink'),
  // justify ends every line on both sides; the engine lengthens joined letters (kashida,
  // on by default for Arabic) after it opens the spaces a quarter. Never hyphenated.
  textAlign: 'justify', optimalLineBreaking: true,
  firstLineIndent: em(1.5), indentAfterHeading: false, // the indent is on the right
  avoidWidows: true, avoidOrphans: true, avoidRunts: true,
};

Ingredientes

Tipografía
Markazi Text, Reem Kufi, Noto Kufi Arabic (SIL OFL 1.1)
Recursos
Ninguno: todas las imágenes se dibujan en código

Elaboración

#1 · Un idioma, tres decisiones

El código está en la respuesta corta, más arriba. La configuración solo dice locale: 'ar', y el motor saca de ahí tres cosas: el texto va de derecha a izquierda (direction: 'auto'), el libro se encuaderna por la derecha (page.binding: 'auto') y todos los números que escribe el motor, folios incluidos, usan las cifras arábigo-índicas (numerals: 'auto') (Empezar un libro en árabe). Márgenes y alineaciones siguen diciendo left y right, pero en un libro de derecha a izquierda se refieren a los lados del flujo: margins.left es el lado del lomo y la sangría queda a la derecha. Las líneas justificadas abren primero los espacios y después alargan las letras enlazadas con el tatweel, la cachida de los libros árabes; el texto nunca se divide con guiones (Justificación y cachida).

Página 12: líneas justificadas con cachida, la sangría a la derecha y el folio ١٢ en el borde exterior.

#2 · El número del capítulo en letras

script.js · líneas 54–75en el código completo
const SINK = 58; // mm: where the text starts on an opener
const centred = (y, size) => ({ anchor: { to: 'container', edge: 'top' },
  offset: { y: mm(y) }, ...(size && { size }) });
const opener = {
  enabled: true, minHeight: mm(SINK),
  slot: { elements: [
    { kind: 'image', id: 'star', resourceId: 'star', placement: centred(8, { width: mm(9) }) },
    // {number} is the level's numbering template below: الفصل الأول, الفصل الثاني…
    { kind: 'text', id: 'kicker', content: '{number}', fontFamily: LABEL, fontSize: pt(10),
      fontWeight: 600, color: col('door'), align: 'center', placement: centred(22) },
    { kind: 'text', id: 'title', content: '{titleText}', fontFamily: DISPLAY, fontSize: pt(30),
      fontWeight: 600, lineHeight: 1.3, color: col('ink'), align: 'center', overflow: 'wrap',
      placement: centred(29, { width: 'fill' }) },
  ] },
};
const chapter = {
  level: 1, fontFamily: DISPLAY, fontWeight: 600, marginTop: pt(0), marginBottom: pt(0),
  // Each chapter opens a page, on either side of the spine.
  breakBefore: { enabled: true, parity: 'any' },
  // A masculine ordinal in words: {1:ordinal-feminine} would give الأولى, الثانية…
  numberingTemplate: 'الفصل {1:ordinal}', advancedDesign: opener,
};

El numberingTemplate del nivel escribe الفصل y el número como ordinal masculino, así que el segundo capítulo es الفصل الثاني sin tocar el Markdown; {1:ordinal-feminine} da الأولى, الثانية para un nombre femenino como الليلة (Ordinales y cardinales con letras). La apertura lo imprime con {number} sobre el título. Las aperturas árabes suelen ir centradas, y con align: 'center' no hace falta pensar en qué lado empieza el diseño.

#3 · Las cabeceras se quedan en su página

script.js · líneas 79–96en el código completo
// Running heads and folios keep their physical sides in a right-to-left book. The right page
// is an even page here and is read first: the book's title; the left page, the chapter's.
const label = { fontFamily: LABEL, fontSize: pt(8), color: col('muted'), pages: 'body' };
const at = (edge, x, y = 12) => ({ anchor: { to: 'page', edge }, offset: { x: mm(x), y: mm(y) } });
const folio = { ...label, fontWeight: 600, color: col('ink') };
const header = { elements: [
  { kind: 'text', id: 'r-folio', content: '{pageNumber}', parity: 'even', ...folio,
    align: 'right', placement: at('top-right', -OUTER) },
  { kind: 'text', id: 'r-title', content: '{title}', parity: 'even', ...label, align: 'right',
    placement: at('top-right', -(OUTER + 9)) },
  { kind: 'text', id: 'l-chapter', content: '{chapterTitle}', parity: 'odd', ...label,
    align: 'left', placement: at('top-left', OUTER + 9) },
  { kind: 'text', id: 'l-folio', content: '{pageNumber}', parity: 'odd', ...folio,
    align: 'left', placement: at('top-left', OUTER) },
] };
// The openers carry no head: their folio drops to the foot, centred.
const footer = { elements: [{ kind: 'text', id: 'drop-folio', content: '{pageNumber}', ...folio,
  pages: 'opener', align: 'center', placement: at('bottom', 0, -11) }] };

El texto sigue el flujo, pero las cabeceras y los folios conservan sus lados físicos. La página 12 es par y, en este libro, página derecha: su folio va arriba a la derecha y el título del libro a su lado; la 13 queda a la izquierda y lleva el capítulo. Si lees la doble página desde la derecha, como un lector árabe, el título del libro llega primero. showBook coloca las páginas en espejo, la 11 a la izquierda de la 10, y la pantalla enseña las dobles páginas tal como se abre el libro.

#4 · Una portadilla dibujada con código

script.js · líneas 100–120en el código completo
// # الدرب {style="plate" kicker="…" line="…"}: a heading that paints a whole page.
const onPage = (y) => ({ anchor: { to: 'page', edge: 'top' }, offset: { y: mm(y) } });
const plate = {
  id: 'plate', span: 'page', numbered: false, runningChapter: false, toc: false,
  breakBefore: { enabled: true, parity: 'any' }, // (gotcha: style-inherits-break)
  header: { elements: [] }, footer: { elements: [] },
  advancedDesign: { enabled: true, slot: { elements: [
    // The drawing carries 3 mm of bleed a side: a box of the trim would fit it by its width
    // and leave a strip of paper at the head and the foot.
    { kind: 'image', id: 'field', resourceId: 'lattice', placement: {
      anchor: { to: 'page', edge: 'top-left' }, offset: { x: mm(-3), y: mm(-3) },
      size: { width: mm(TRIM.width + 6), height: mm(TRIM.height + 6) } } },
    { kind: 'text', id: 'part', content: '{attr.kicker}', fontFamily: LABEL, fontSize: pt(11),
      fontWeight: 600, color: col('brass'), align: 'center', placement: onPage(76) },
    { kind: 'text', id: 'name', content: '{titleText}', fontFamily: DISPLAY, fontSize: pt(64),
      fontWeight: 600, lineHeight: 1.2, color: col('paper'), align: 'center',
      placement: onPage(86) },
    { kind: 'text', id: 'line', content: '{attr.line}', fontFamily: TEXT, fontSize: pt(13),
      color: col('paper'), align: 'center', placement: onPage(124) },
  ] } },
};

La portadilla es un encabezado de primer nivel, # الدرب {style="plate" …}, cuyo estilo pinta la hoja entera y le quita cabecera y folio. La celosía es un SVG generado en el propio script con dos cuadrados girados 45°, la estrella jatam de la ornamentación geométrica islámica, en el azul y el latón de la paleta, y el PDF la conserva como trazados vectoriales. numbered: false deja la portadilla fuera de la cuenta de capítulos, y la apertura que sigue es الفصل الأول.

La receta completa

Sandbox
// ═══ Postext Cookbook · Nº 105 · An Arabic novel set right to left, bound on the right ═══
// https://postext.dev/en/cookbook/arabic-novel-right-bound
// Code: MIT · Text: original Arabic prose (CC BY 4.0) · Pattern: drawn in code
// Fonts: Markazi Text, Reem Kufi, Noto Kufi Arabic (SIL OFL 1.1) · Needs postext ≥ 1.25.0
import {
  buildDocument, withLoadedFonts, renderPageToCanvas, registerResourceImage,
} from 'https://esm.sh/postext';
import { renderToPdf, decompressWoff2 } from 'https://esm.sh/postext-pdf';

const LANG = 'es'; // @lang: the language of the frame; the novel is Arabic in both editions
const RECIPE = 'arabic-novel-right-bound';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// The blue of the press's door, the brass of its key, ink on a cream book paper.
// #region palette: the door's blue, the key's brass, every colour linked by id
const palette = {
  ink: '#1f1c19', // text: a warm near-black
  door: '#2b4766', // the accent: the part page's field, the openers' kickers
  brass: '#b08d4a', // the second accent: the medallion's line and the openers' star
  lattice: '#3d5d82', // the pattern's lines, a step lighter than the field
  rule: '#cbc3b5', // hairlines
  muted: '#6b645b', // running heads, folios, the colophon
  paper: '#fbf8f1', // a cream book paper
};
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = Object.entries({ ...palette, 'main-color': palette.door })
  .map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
// #endregion
const [TEXT, DISPLAY, LABEL] = ['Markazi Text', 'Reem Kufi', 'Noto Kufi Arabic'];
const [BODY, LEAD] = [13.5, 22]; // pt: Naskh sets small, so 13.5 pt on 1.63 × the size
const TRIM = { width: 140, height: 210 }; // mm: 14 × 21 cm, the Arab trade novel
const OUTER = 16; // mm: the outer margin, where the folios stand

// #region answer: the locale sets the direction, the binding and the digits
const page = {
  width: mm(TRIM.width), height: mm(TRIM.height), dpi: 150, backgroundColor: col('paper'),
  // left and right are the flow's sides: in a right-to-left book left is the spine side,
  // so these margins put 20 mm at the spine and 16 mm outside on both pages of a spread.
  margins: { top: mm(23), bottom: mm(22), left: mm(20), right: mm(OUTER), mirror: true },
  // binding: 'auto' (unset) is 'right' for a right-to-left locale: page 1 is a left page.
};
const bodyText = {
  fontFamily: TEXT, fontSize: pt(BODY), lineHeight: pt(LEAD), color: col('ink'),
  boldColor: col('ink'), italicColor: col('ink'), referenceColor: col('ink'),
  // justify ends every line on both sides; the engine lengthens joined letters (kashida,
  // on by default for Arabic) after it opens the spaces a quarter. Never hyphenated.
  textAlign: 'justify', optimalLineBreaking: true,
  firstLineIndent: em(1.5), indentAfterHeading: false, // the indent is on the right

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

#Imprime cifras europeas

Una edición magrebí imprime 1, 2, 3; locale: 'ar-MA' lo hace por sí solo, y la edición magrebí enseña el libro entero.

-  locale: 'ar', // written out, never LANG (gotcha: arabic-locale-tag)
+  locale: 'ar', numerals: 'latn',

#Justifica solo con los espacios

Algunas editoriales no ponen tatweel en el texto corrido: los espacios absorben toda la diferencia.

   textAlign: 'justify', optimalLineBreaking: true,
+  kashida: 'none',

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 →

Error frecuente

Un libro encuadernado por la derecha muestra sus pliegos con showBook

En un libro encuadernado por la derecha (texto árabe, hebreo o persa, chino vertical, o page.binding 'right') la página 1 sigue siendo impar, pero queda a la izquierda del lomo, y los pliegos se leen [3 | 2]. showPages compone todos los libros como si se encuadernaran por la izquierda; showBook, del bloque book (el bloque cjk trae la misma función), lee doc.binding y refleja los pliegos. capture.hero sigue nombrando un pliego en orden de lectura, [par, impar]: [2, 3]. Libros encuadernados por la derecha →

Error frecuente

Un estilo de título hereda el salto de página de su nivel

Una entrada de headingStyles toma de su nivel de título todo lo que no fija, también breakBefore. Un índice o un colofón con estilo sobre un H1 tras un :::pagebreak hereda la paridad 'odd' y cae detrás de una página en blanco. Dale a ese estilo breakBefore: { enabled: false }. Estilos de título →

  • Un colofón en inglés o en español al final de un libro árabe necesita {dir=ltr} en su bloque: sin él, la línea latina se alinea y se puntúa como un párrafo de derecha a izquierda, con el punto final a la izquierda.

Créditos

Texto
  • El comienzo de una novela, حروف من رصاص (Letras de plomo), escrito en árabe para la receta; su autora y sus personajes son inventados · Postext Cookbook · original
Fuentes
Markazi Text (SIL OFL 1.1) · Reem Kufi (SIL OFL 1.1) · Noto Kufi Arabic (SIL OFL 1.1)
SandboxPDF