Saltar al contingut principal
Recepta número 105

Receptari · Capítol 2 · Text i tipografia

Una novel·la àrab composta de dreta a esquerra

Una novel·la àrab en 14 × 21 cm: amb locale 'ar' el text va de dreta a esquerra, el llibre s'enquaderna per la dreta i els folis diuen ١٢.

En aquesta pàgina
Sortida
Canvas · PDF
Nivell
Intermedi
Postext
Provada amb Postext 1.65.0
Requereix ≥ 1.25.0 · postext-pdf ≥ 1.25.0
Llicència
Actualitzada el 10 d’oct. del 2026
Codi MIT · Text CC BY 4.0

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

  • Mostra en castellà: encara no hi ha edició en català
  • Format 140 × 210 mm
  • 1 columna
  • Markazi Text 13,5/22
  • Noto Kufi Arabic
  • Reem Kufi
  • 7 pàgines
  • Nivell
  • Postext 1.57.1
  • Compost en 81 ms
  • 161 línies de codi

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

script.js · línies 35–50al codi complet
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

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).

Pàgina 12: línies justificades amb caixida, el sagnat a la dreta i el foli ١٢ a la vora exterior.

#2 · El número del capítol en lletres

script.js · línies 54–75al codi complet
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

script.js · línies 79–96al codi complet
// 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

script.js · línies 100–120al codi complet
// # الدرب {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

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

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

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)
SandboxPDF