En pocas palabras
El comienzo de la Muqaddima de Ibn Jaldún como edición crítica árabe moderna: la introducción numerada con letras, el texto con cifras y notas al pie que vuelven a empezar por uno en cada página.
Lo que vas a componer
Once páginas de una edición crítica árabe moderna, un taḥqīq, de la primera sección de la Muqaddima de Ibn Jaldún, sobre la excelencia de la historia. Los preliminares se folian con letras abjad, como hacen las ediciones de El Cairo y Beirut: una portada أ, su página de créditos ب y la introducción del editor ج y د. El texto vuelve a empezar en ١ en la siguiente página impar. Las notas del editor van al pie de cada página, numeradas (١), (٢), (٣) y reiniciadas en cada página, bajo un filete corto a la derecha; glosan palabras raras, identifican a las personas y lugares que nombra Ibn Jaldún y dan la sura y el versículo de cada cita del Corán. Un índice de nombres cierra el libro, ordenado como se ordenan los índices árabes, sin el artículo ال. Las notas y la introducción están escritas para esta receta.
Esta receta responde a
- ¿Cómo numero los preliminares de un libro árabe con letras abjad (أ، ب، ج)?
- ¿Cómo numero las notas al pie árabes por página, entre paréntesis: (١)?
La respuesta corta
// The page counter starts in abjad letters: the title page is أ, its back ب, the editor's
// introduction ج and د. Before the text, two directives in the Markdown count again from 1,
// in the document's digits (١ ٢ ٣ in an `ar` document), on the next odd page:
// :::pagebreak{parity="odd"}
// :::numbering{format="arabic-indic" startAt=1}
// {pageNumber} prints each page's own label, so one footer and one header serve both runs.
const pageNumbering = { format: 'abjad', startAt: 1 }; // أ ب ج د هـ و ز ح…
// The editor's notes: numbered again on every page, written «(١)», raised after the word in
// the text and on the line at the head of the note. The rule over the notes and each note's
// number stand on the start side, the right, because the page runs right to left.
const footnotes = {
numbering: 'page', markerTemplate: '({n})', noteNumberPosition: 'inline',
fontSize: pt(10.5), lineHeight: pt(18.5), color: col('ink'), textAlign: 'justify',
spaceAbove: pt(14), spaceBelowRule: pt(6),
separator: { width: 0.28, lineWidth: pt(0.6), color: col('rule') },
};
Ingredientes
- Funciones
- Notas al pieEstilos de numeración árabesPreliminares en romanosCifras de los números generadosTexto de derecha a izquierdaLibros encuadernados por la derechaFuentes árabesEl árabe como idioma del documentoEstilos de títuloAtributos de títuloAperturas diseñadasCabeceras y foliosCabeceras según el tipo de páginaÍndice analíticoÍndice ordenado sin el artículoEstilos de párrafoPaleta de color semánticaExportación a PDFFuentes incrustadas en el PDF
- También usa
- Color del papelSaltos de página y de columnaGeometría por secciónCabeceras por secciónCapítulos sin número
- Tipografía
- Amiri, Aref Ruqaa (SIL OFL 1.1)
- Recursos
- Ninguno: todas las imágenes se dibujan en código
Elaboración
#1 · Dos series de folios y notas por página
El código es la respuesta corta de arriba. page.pageNumbering empieza el libro en 'abjad', las letras en el orden abjad, con هـ para el cinco. Antes del texto, dos directivas reinician la cuenta en la siguiente página impar con las cifras del documento (:::numbering, Cifras y estilos de numeración). Las notas llevan numbering: 'page', un markerTemplate de '({n})' y noteNumberPosition: 'inline', de modo que la llamada va volada en el texto y la nota empieza con su número en la línea (Notas al pie).

#2 · Un índice que se salta el artículo
// Marks in the text, `:index[المسعودي]`, `:index[الطّبريّ]{term="الطبري"}`. With
// ignoreArticle, المسعودي files under م and الطبري under ط; ابن الكلبي stays under ا.
// It is the default when the index sorts in Arabic: written out here to say so.
const index = { ignoreArticle: true, fontFamily: NASKH, fontSize: pt(11), lineHeight: pt(17),
color: col('ink'), groups: { fontFamily: NASKH, fontWeight: 700, fontSize: pt(13),
color: col('accent'), marginTop: pt(8) } };
const indexStyle = { id: 'index', numbered: false, toc: false, span: 'page',
breakBefore: { enabled: true, parity: 'any' },
layout: { layoutType: 'double', gutterWidth: mm(10) } }; // two columns under the title
Los nombres se marcan en el texto, :index[المسعودي], y :::index los imprime al final. Con ignoreArticle, المسعودي va bajo م y الطبري bajo ط, mientras que ابن إسحاق se queda bajo ا; una remisión lleva de إسرائيل a يعقوب (Índice general e índice analítico). Los números de página del índice son las etiquetas de las páginas, así que un nombre de la introducción remite a ج.
#3 · Cabeceras sobre un filete
// Running heads are physical. In a book bound on the right the verso (even) is the right
// page: its outer edge, the folio's, is the right one, and its text block starts INNER mm
// from the left edge; the recto (odd) mirrors it.
const HEAD_Y = 14; // mm from the trim
const blockX = (parity) => (parity === 'even' ? INNER : OUTER); // the text block's left edge
const heads = (parity, content) => [
text(`${parity}-head`, content, NASKH, 10.5,
{ ...at('top-left', blockX(parity), HEAD_Y, 'page'), size: { width: mm(MEASURE) } },
{ color: col('muted'), parity, pages: 'body' }),
text(`${parity}-folio`, '{pageNumber}', NASKH, 11.5, parity === 'even'
? at('top-right', -OUTER, HEAD_Y, 'page') : at('top-left', OUTER, HEAD_Y, 'page'),
{ parity, pages: 'body', align: parity === 'even' ? 'right' : 'left' }),
{ ...rule(`${parity}-rule`, HEAD_Y + 7, MEASURE, 'top-left', 'page', blockX(parity)),
parity, pages: 'body' },
];
const header = { elements: [...heads('even', '{title}'), ...heads('odd', '{chapterTitle}')] };
const dropFolio = (pages) => text(`folio-${pages}`, '{pageNumber}', NASKH, 11.5,
at('bottom', 0, -12, 'page'), { pages });
const footer = { elements: [dropFolio('opener')] }; // on the openers, under the text
// Front matter: no running heads, the abjad folio centred at the foot of every page.
const front = { id: 'front', numbered: false, toc: false,
breakBefore: { enabled: true, parity: 'any' }, header: { elements: [] },
footer: { elements: [dropFolio('all')] }, advancedDesign: titleOnly(22) };
La página par lleva el título del libro y la impar la sección, sobre un filete fino del ancho de la caja, con el folio en el extremo exterior. En un libro encuadernado por la derecha la página par queda a la derecha, así que su folio va arriba a la derecha (Orden de las páginas y encuadernación por la derecha). Las aperturas y los preliminares llevan en cambio el folio centrado al pie.
#4 · Una portada y su página de créditos
const onPage = (y) => at('top', 0, y, 'page');
const blind = { numbered: false, toc: false, span: 'page', runningChapter: false,
breakBefore: { enabled: true, parity: 'any' }, header: { elements: [] },
footer: { elements: [] } }; // blind folios: أ and ب count, but do not print
const titlePage = { id: 'title', ...blind, advancedDesign: design([
text('book', '{attr.book}', NASKH, 14, onPage(44), { color: col('muted') }),
rule('rule-top', 58, 40, 'top', 'page'),
text('title', '{titleText}', RUQAA, 44, onPage(64), { fontWeight: 700,
color: col('accent'), lineHeight: 1.3 }),
rule('rule-foot', 92, 40, 'top', 'page'),
text('author', 'تأليف {author}', NASKH, 15, onPage(100), { fontWeight: 700 }),
text('years', '{attr.years}', NASKH, 12, onPage(110)),
text('part', '{attr.part}: {subtitle}', NASKH, 13, onPage(132)),
text('editor', '{attr.editor}', NASKH, 12, onPage(178), { color: col('accent') }),
text('latin', '{attr.latin}', NASKH, 9.5, { ...onPage(196), size: { width: mm(110) } },
{ color: col('muted'), direction: 'ltr' }), // a Latin line: its own direction
], 0) };
const imprintPage = { id: 'imprint', ...blind, advancedDesign: design([
text('edition', '{attr.edition}', NASKH, 11, onPage(170)),
text('imprint', '{attr.imprint}', NASKH, 9, { ...onPage(180), size: { width: mm(100) } },
{ color: col('muted'), lineHeight: 1.45, direction: 'ltr' }),
], 0) };
La portada y la página de créditos de su dorso son estilos de encabezado sin nada en el flujo: sus líneas salen de atributos del encabezado, así que las líneas latinas de los créditos, que cambian con la edición, son un atributo en el Markdown.
La receta completa
// ═══ Postext Cookbook · Nº 113 · A critical edition (taḥqīq) with notes per page ═══════
// https://postext.dev/en/cookbook/tahqiq-critical-edition
// Code: MIT · Text: Ibn Khaldūn, al-Muqaddima, ar.wikisource (PD) · Pictures: none
// Fonts: Amiri, Aref Ruqaa (SIL OFL 1.1) · Needs postext ≥ 1.25.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 = 'tahqiq-critical-edition';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// A modern Cairo taḥqīq: black Naskh on a cream paper, headings and rules in one dark red.
const palette = {
ink: '#1e1a16', // text and notes: a warm near-black
accent: '#8a2a1d', // headings, the title, the index letters
rule: '#8c7a62', // hairlines: the rule under the running heads, the rule over the notes
muted: '#5e564c', // running heads, the imprint
paper: '#fbf8f0', // a cream 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: 'accent (defaults)', value: { hex: palette.accent, model: 'hex' } },
];
const NASKH = 'Amiri'; // text, notes, headings in bold, running heads, index
const RUQAA = 'Aref Ruqaa'; // display: the title on the title page
const [W, H] = [170, 240]; // mm: 17 × 24 cm, the size of most Cairo and Beirut editions
const [TOP, INNER, OUTER] = [22, 20, 16]; // mm; `left` is the inner margin on both pages
const MEASURE = W - INNER - OUTER; // 134 mm
const [SIZE, LEAD] = [13, 22.5]; // pt: 1.73 ×, so the few vowels marked clear the line above
// #region answer: abjad folios for the front matter, Arabic-Indic from the text, notes (١)
// The page counter starts in abjad letters: the title page is أ, its back ب, the editor's
// introduction ج and د. Before the text, two directives in the Markdown count again from 1,
// in the document's digits (١ ٢ ٣ in an `ar` document), on the next odd page:
// :::pagebreak{parity="odd"}
// :::numbering{format="arabic-indic" startAt=1}
// {pageNumber} prints each page's own label, so one footer and one header serve both runs.
const pageNumbering = { format: 'abjad', startAt: 1 }; // أ ب ج د هـ و ز ح…
// The editor's notes: numbered again on every page, written «(١)», raised after the word in
// the text and on the line at the head of the note. The rule over the notes and each note's
// number stand on the start side, the right, because the page runs right to left.
const footnotes = {
numbering: 'page', markerTemplate: '({n})', noteNumberPosition: 'inline',
fontSize: pt(10.5), lineHeight: pt(18.5), color: col('ink'), textAlign: 'justify',
spaceAbove: pt(14), spaceBelowRule: pt(6),
separator: { width: 0.28, lineWidth: pt(0.6), color: col('rule') },
};
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
#Usa los numerales abjad
'arabic-abjad' escribe los numerales abjad aditivos en lugar de la serie simple de letras: la página once es يا, no ك.
-const pageNumbering = { format: 'abjad', startAt: 1 }; // أ ب ج د هـ و ز ح…
+const pageNumbering = { format: 'arabic-abjad', startAt: 1 }; // … ط ي يا يب#Numera las notas a lo largo de la sección
numbering: 'chapter' sigue contando las notas de una página a otra, como hacen algunas ediciones antiguas.
- numbering: 'page', markerTemplate: '({n})', noteNumberPosition: 'inline',
+ numbering: 'chapter', markerTemplate: '({n})', noteNumberPosition: 'inline',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
:::numbering se aplica en la página siguiente
:::numbering cambia la cuenta a partir de la siguiente página que empieza, no de la actual. Colócalo justo después de un :::pagebreak (con paridad odd antes del primer capítulo) para que la numeración nueva empiece donde quieres. Preliminares en romanos →
Créditos
- Receta
- Ignacio Ferro
- Texto
- La sección inicial de la Muqaddima, «Sobre la excelencia de la historia», tal como la da ar.wikisource (revisión 610595), sin sus notas · Ibn Khaldūn · dominio público
- La introducción del editor en árabe, las notas, el índice y la página de créditos · Postext Cookbook · original
- Fuentes
- Amiri (SIL OFL 1.1) · Aref Ruqaa (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)


