En poques paraules
Les primeres pàgines d'una novel·la en àrab, tal com les imprimiria una editorial àrab: les línies van de dreta a esquerra, el llibre s'obre pel que un lector occidental anomena el final i els números de pàgina fan servir xifres àrabs.
Què compondràs
El començament de حروف من رصاص (Lletres de plom), una novel·la sobre un nét que torna a obrir la impremta del seu avi en un carreró del Caire, composta com una edició àrab en rústica: 14 × 21 cm, Markazi Text de 13,5 pt sobre 22 pt d'interlineat, justificat, amb el sagnat a la dreta. El fragment comença a la pàgina 10 amb una portadella de part en el blau de la porta de la impremta, una gelosia d'estrelles de vuit puntes dibuixada amb codi i el nom de la part en Reem Kufi de 64 pt. Al davant, a la pàgina esquerra, s'obre el capítol, numerat en lletres: الفصل الأول. Els folis diuen ١٠, ١١, ١٢; el títol del llibre va sobre les pàgines dretes i el del capítol sobre les esquerres. Una novel·la en rústica compon el mateix tipus de llibre d'esquerra a dreta.
Aquesta recepta respon a
- Com componc un llibre àrab de dreta a esquerra i l'enquaderno per la dreta?
La resposta curta
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,
};
Ingredients
- Funcions
- Text de dreta a esquerraLlibres enquadernats per la dretaXifres dels números generatsJustificació amb caixidaFonts àrabsL'àrab com a llengua del documentOrdinals àrabs en lletresTipografia del textSagnats, alineació i separació de paràgrafsObertures dissenyadesEstils de títolTítols numeratsAtributs de títolCapçaleres i folisCapçaleres segons el tipus de pàginaMarges simètricsImatges als dissenys de pàginaExportació a PDF
- També fa servir
- Paràgrafs en l'altra direccióColor del paperEstils de paràgrafFonts incrustades al PDFFigures i taules com a recursosCapçaleres per seccióCapítols sense número
- Tipografia
- Markazi Text, Reem Kufi, Noto Kufi Arabic (SIL OFL 1.1)
- Recursos
- Cap: totes les imatges es dibuixen en codi
Elaboració
#1 · Un idioma, tres decisions
El codi és a la resposta curta, més amunt. La configuració només diu locale: 'ar', i el motor en treu tres coses: el text va de dreta a esquerra (direction: 'auto'), el llibre s'enquaderna per la dreta (page.binding: 'auto') i tots els números que escriu el motor, folis inclosos, fan servir les xifres arabicoíndiques (numerals: 'auto') (Començar un llibre en àrab). Marges i alineacions continuen dient left i right, però en un llibre de dreta a esquerra designen els costats del flux: margins.left és el costat del llom i el sagnat queda a la dreta. Les línies justificades obren primer els espais i després allarguen les lletres enllaçades amb el tatweel, la caixida dels llibres àrabs; el text no es parteix mai amb guionets (Justificació i caixida).

#2 · El número del capítol en lletres
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 nivell escriu الفصل i el número com a ordinal masculí, de manera que el segon capítol és الفصل الثاني sense tocar el Markdown; {1:ordinal-feminine} dona الأولى, الثانية per a un nom femení com الليلة (Ordinals i cardinals en lletres). L'obertura l'imprimeix amb {number} sobre el títol. Les obertures àrabs solen anar centrades, i amb align: 'center' no cal pensar per quin costat comença el disseny.
#3 · Les capçaleres es queden a la seva 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 text segueix el flux, però les capçaleres i els folis conserven els costats físics. La pàgina 12 és parella i, en aquest llibre, pàgina dreta: el seu foli va a dalt a la dreta i el títol del llibre al costat; la 13 queda a l'esquerra i porta el capítol. Si llegeixes la doble pàgina des de la dreta, com un lector àrab, el títol del llibre arriba primer. showBook col·loca les pàgines en mirall, l'11 a l'esquerra de la 10, i la pantalla mostra les dobles pàgines tal com s'obre el llibre.
#4 · Una portadella dibuixada amb codi
// # الدرب {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 portadella és un títol de primer nivell, # الدرب {style="plate" …}, amb un estil que pinta tot el full i li treu capçalera i foli. La gelosia és un SVG generat al mateix script amb dos quadrats girats 45°, l'estrella khatam de l'ornamentació geomètrica islàmica, en el blau i el llautó de la paleta, i el PDF la conserva com a traçats vectorials. numbered: false deixa la portadella fora del compte de capítols, i l'obertura que segueix és الفصل الأول.
La recepta 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
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
#Imprimeix xifres europees
Una edició magribina imprimeix 1, 2, 3; locale: 'ar-MA' ho fa tot sol, i l'edició magribina mostra el llibre sencer.
- locale: 'ar', // written out, never LANG (gotcha: arabic-locale-tag)
+ locale: 'ar', numerals: 'latn',#Justifica només amb els espais
Algunes editorials no posen tatweel al text corregut: els espais absorbeixen tota la diferència.
textAlign: 'justify', optimalLineBreaking: true,
+ kashida: 'none',Errors freqüents
Error freqüent
Etiqueta un llibre àrab 'ar', no amb LANG
Les edicions d'una recepta són en i es, però una mostra àrab és àrab en totes dues: `locale: LANG` la compondria d'esquerra a dreta, l'enquadernaria per l'esquerra, numeraria les seves pàgines 1 2 3 i anomenaria Figure o Figura les seves figures. Des de postext 1.30 l'etiqueta és a més la llengua en què es compon el text (en què es mesura, es pinta i s'incrusta), de manera que sota una etiqueta anglesa o castellana una font com Markazi Text no dibuixa les formes àrabs de les cometes angulars i dels punts, i les línies es parteixen per un altre lloc. Escriu tu l'etiqueta: 'ar' (xifres aràbigo-índiques, la convenció del Màixriq), una regió com 'ar-EG' o 'ar-SA', o 'ar-MA', 'ar-DZ' o 'ar-TN' per a una edició magribina amb xifres europees. Una pàgina llatina que només cita àrab conserva el seu propi locale. Text de dreta a esquerra →
Error freqüent
Les fonts àrabs necessiten el seu fitxer arabic, amb el bloc arabic
Fontsource serveix Amiri, Noto Naskh Arabic o Scheherazade New en un fitxer per subconjunt, i les lletres àrabs són al fitxer arabic. loadFonts només baixa latin (i latin-ext), de manera que a la pantalla l'àrab surt d'una font del sistema i es mesura malament, i fontsourceProvider lliura al PDF aquell fitxer latin, que imprimeix caixes buides. Afegeix el bloc arabic del kit, crida loadArabicFonts(FONTS, markdown) després de loadFonts, amb tots els pesos que les pàgines fan servir en àrab llistats a FONTS, i passa a renderToPdf fontProvider: arabicPdfProvider. Fonts àrabs →
Error freqüent
Un llibre enquadernat per la dreta mostra els seus plecs amb showBook
En un llibre enquadernat per la dreta (text àrab, hebreu o persa, xinès vertical, o page.binding 'right') la pàgina 1 continua sent senar, però queda a l'esquerra del llom, i els plecs es llegeixen [3 | 2]. showPages compon tots els llibres com si s'enquadernessin per l'esquerra; showBook, del bloc book (el bloc cjk porta la mateixa funció), llegeix doc.binding i reflecteix els plecs. capture.hero continua anomenant un plec en ordre de lectura, [parella, senar]: [2, 3]. Llibres enquadernats per la dreta →
Error freqüent
Un estil de títol hereta el salt de pàgina del seu nivell
Una entrada de headingStyles pren del seu nivell de títol tot allò que no fixa, també breakBefore. Un índex o un colofó amb estil sobre un H1 després d'un :::pagebreak hereta la paritat 'odd' i cau darrere d'una pàgina en blanc. Dona a aquest estil breakBefore: { enabled: false }. Estils de títol →
- Un colofó en anglès o en castellà al final d'un llibre àrab necessita
{dir=ltr}al seu bloc: sense, la línia llatina s'alinea i es puntua com un paràgraf de dreta a esquerra, amb el punt final a l'esquerra.
Crèdits
- Recepta
- Ignacio Ferro
- Text
- The opening of a novel, حروف من رصاص (Letters of Lead), written in Arabic for the recipe; its author and its people are invented · Postext Cookbook · original
- Fonts
- Markazi Text (SIL OFL 1.1) · Reem Kufi (SIL OFL 1.1) · Noto Kufi Arabic (SIL OFL 1.1)
- Codi
- MIT, com Postext
Editar aquest text ↗ (s'obre en una pestanya nova)Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)


