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
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
- Funciones
- Texto de derecha a izquierdaLibros encuadernados por la derechaCifras de los números generadosJustificación con cachidaFuentes árabesEl árabe como idioma del documentoOrdinales árabes en letrasTipografía del textoSangrías, alineación y separación de párrafosAperturas diseñadasEstilos de títuloTítulos numeradosAtributos de títuloCabeceras y foliosCabeceras según el tipo de páginaMárgenes simétricosImágenes en los diseños de páginaExportación a PDF
- También usa
- Párrafos en la otra direcciónColor del papelEstilos de párrafoFuentes incrustadas en el PDFFiguras y tablas como recursosCabeceras por secciónCapítulos sin número
- 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).

#2 · El número del capítulo en letras
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
// 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
// # الدرب {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
// ═══ 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
- Receta
- Ignacio Ferro
- 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)
- 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)


