En poques paraules
Una pàgina feta com els llibres àrabs impresos al Caire al segle XIX: el text principal al centre, notes breus sobre ell en una columna estreta al costat de la vora i tota la pàgina tancada entre filets impresos.
Què compondràs
Sis pàgines compostes com imprimien un comentari la impremta de Bulaq i les seves successores del Caire al segle XIX. L'explicació d'Ibn ʿAqīl als primers versos de l'Alfiyya, la gramàtica en mil versos d'Ibn Mālik, corre per la columna principal, amb els versos en vermell; al marge exterior hi ha una ḥāshiya, glosses breus que comencen amb les paraules del text que expliquen, al costat del passatge al qual pertanyen. Un filet doble emmarca la caixa, amb una banda al capdamunt per al capítol i el foli, i un filet simple separa el text del seu marge. En una pàgina de Bulaq autèntica la ḥāshiya envolta el text per tres costats; Postext la posa en un de sol, i la recepta ho diu.
Aquesta recepta respon a
- Com componc una pàgina de Bulaq, amb el comentari emmarcat al voltant del text?
La resposta curta
// The text runs in the main column of a column-and-a-half layout; the side column, on the
// outer side, takes only boxes with span 'side'. A gloss is written before the passage it
// explains and starts level with its first line, on the page where that passage goes on
// (sideAtColumnEnd: 'after'). A column rule parts the two, as the jadwal of a Bulaq page does.
const layout = { layoutType: 'oneAndHalf', sideColumnRole: 'floats', sideColumnSide: 'outer',
sideColumnPercent: 31, gutterWidth: mm(7),
columnRule: { enabled: true, color: col('rule'), lineWidth: pt(0.6) } };
// A gloss is a callout with no box: the margin's own face, its lemma bold in the rubric.
const hashiya = { id: 'hashiya', span: 'side', sideAtColumnEnd: 'after',
backgroundEnabled: false, borderRadius: pt(0),
padding: { top: pt(0), right: pt(0), bottom: pt(0), left: pt(0) },
stripe: { enabled: false }, border: { enabled: false },
body: { fontFamily: NASKH, fontSize: pt(10), lineHeight: pt(16), color: col('ink'),
boldColor: col('rubric'), textAlign: 'justify', firstLineIndent: pt(0),
paragraphSpacing: true } };
Ingredients
- Funcions
- Notes al margeTextos, filets i caixes als dissenys de pàginaText de dreta a esquerraColumna i mitjaColumna al marge per a flotantsFilet de columnaLlibres enquadernats per la dretaFonts àrabsL'àrab com a llengua del documentVers àrab (bayt en dos hemistiquis)Xifres dels números generatsCobertes, portades i colofonsEstils de títolAtributs de títolCapçaleres i folisColor del paperEstils de paràgrafParàgrafs en l'altra direccióPaleta de color semànticaExportació a PDF
- També fa servir
- RequadresObertures dissenyadesCapçaleres segons el tipus de pàginaFonts incrustades al PDFCapçaleres per secció
- Tipografia
- Amiri, Aref Ruqaa (SIL OFL 1.1)
- Recursos
- Cap: totes les imatges es dibuixen en codi
Elaboració
#1 · La ḥāshiya en una columna lateral pròpia
El codi és la resposta curta de dalt. Un disseny en columna i mitja amb una columna lateral que només admet flotants deixa el comentari fora del flux del text: cada glossa és un :::callout{type="hashiya" span="side"} escrit abans del passatge que explica, i comença a l'altura de la seva primera línia; sideAtColumnEnd: 'after' el manté al costat del passatge quan aquest continua a la pàgina següent (Disposició). El requadre no té fons, vora ni farciment, així que es llegeix com a text compost al marge, amb el lema en negreta, que boldColor posa en vermell. sideColumnSide: 'outer' porta la columna al tall davanter de les dues pàgines: a la dreta de la pàgina parella, que en un llibre enquadernat per la dreta queda a la dreta de la doble pàgina.

#2 · Un marc dibuixat per a cada costat del plec
// Page-level design elements are physical: the frame follows the margins of each side of
// the spread. In a book bound on the right the even page is the right-hand one, its spine
// on its left, so its inner margin is the left one. A heading's design is set in the flow
// and mirrored with the page (inFlow): there 'left' is the sheet's right.
const frame = (parity, withBand = true, inFlow = false) => {
const left = (parity === 'even') !== inFlow ? M.inner : M.outer;
const width = TRIM.width - M.inner - M.outer;
const box = (id, inset, thickness) => ({ kind: 'box', id: `${id}-${parity}`, parity,
style: { borderColor: col('rule'), borderWidth: pt(thickness) },
placement: { anchor: { to: 'page', edge: 'top-left' },
offset: { x: mm(left - 4 + inset), y: mm(M.top - 13 + inset) },
size: { width: mm(width + 8 - 2 * inset),
height: mm(TRIM.height - M.top - M.bottom + 17 - 2 * inset) } } });
return [box('outer', 0, 1.4), box('inner', 1.3, 0.4), ...(withBand ? [
{ kind: 'rule', id: `band-${parity}`, parity, direction: 'horizontal', thickness: pt(0.4),
color: col('rule'), placement: { anchor: { to: 'page', edge: 'top-left' },
offset: { x: mm(left - 2.7), y: mm(M.top - 4) },
size: { width: mm(width + 5.4) } } }] : [])];
};
// The chapter centred in the band, the folio at its outer end. The frame stands off the
// sheet's centre by half the difference of the margins, towards the outer edge.
const SHIFT = (M.inner - M.outer) / 2; // mm
const band = (id, content, parity, edge, x, extra = {}) => ({ kind: 'text', id, content,
parity, pages: 'body', fontFamily: NASKH, fontWeight: 700, fontSize: pt(10.5),
color: col('ink'),
placement: { anchor: { to: 'page', edge }, offset: { x: mm(x), y: mm(M.top - 11) } }, ...extra });
const header = { elements: [...frame('even'), ...frame('odd'),
band('head-even', '{chapterTitle}', 'even', 'top', SHIFT),
band('head-odd', '{chapterTitle}', 'odd', 'top', -SHIFT),
band('folio-even', '{pageNumber}', 'even', 'top-right', -(M.outer + 1), { pages: 'all' }),
band('folio-odd', '{pageNumber}', 'odd', 'top-left', M.outer + 1, { pages: 'all' })] };
El marc són tres elements de disseny de pàgina a la capçalera: dues caixes amb vora i sense farciment, separades 1,3 mm, i un filet sota la banda que porta la capçalera. Els elements de pàgina són físics, així que el marc es construeix dues vegades, una per paritat, amb els marges d'aquell costat (Ordre de les pàgines i enquadernació per la dreta). El foli va a l'extrem exterior de la banda a totes les pàgines, també a les obertures; el títol del capítol va centrat i no apareix a l'obertura, on el mateix títol queda a sota.
#3 · Una portada dins del mateix marc
const line = (id, content, y, style) => ({ kind: 'text', id, content, align: 'center',
overflow: 'wrap', color: col('ink'),
// Centred in the frame: the title page is an odd page set in the mirrored flow.
placement: { anchor: { to: 'page', edge: 'top' }, offset: { x: mm(SHIFT), y: mm(y) },
size: { width: mm(110) } }, ...style });
const titlePage = { id: 'title', span: 'page', runningChapter: false,
breakBefore: { enabled: true, parity: 'any' }, header: { elements: [] },
footer: { elements: [] },
advancedDesign: { enabled: true, slot: { elements: [...frame('odd', false, true),
line('book', '{titleText}', 64, { fontFamily: RUQAA, fontWeight: 700, fontSize: pt(40),
lineHeight: 1.3, color: col('rubric') }),
line('on', '{attr.on}', 88, { fontFamily: NASKH, fontWeight: 700, fontSize: pt(17) }),
{ kind: 'rule', id: 'rule', direction: 'horizontal', thickness: pt(0.75), color: col('rubric'),
placement: { anchor: { to: 'page', edge: 'top' }, offset: { x: mm(SHIFT), y: mm(104) },
size: { width: mm(30) } } },
line('margin', '{attr.margin}', 112, { fontFamily: NASKH, fontSize: pt(13) }),
line('latin', '{attr.latin}', 196, { fontFamily: NASKH, fontSize: pt(9), italic: true,
color: col('muted') }),
] } } };
La portada reutilitza el marc sense la banda. El disseny d'un títol es compon dins el flux i s'emmiralla amb la pàgina, així que allà el marc es construeix amb els costats canviats (inFlow): la seva esquerra és la dreta del full. Les seves línies surten d'atributs del títol, on i margin, de manera que tota la portada és una línia de Markdown, i la línia llatina de sota canvia amb l'edició.
La recepta completa
// ═══ Postext Cookbook · Nº 114 · A Bulaq page: the text framed by its commentary ════════
// https://postext.dev/en/cookbook/bulaq-framed-page
// Code: MIT · Text: Ibn ʿAqīl, Sharḥ; Ibn Mālik, Alfiyya, ar.wikisource (PD) · Pictures: none
// Fonts: Amiri, Aref Ruqaa (SIL OFL 1.1) · Needs postext ≥ 1.28.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 = 'bulaq-framed-page';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// Black and a brown-red on a toned paper: the two inks of a Cairo press around 1900.
const palette = {
ink: '#1d1915', // text and frame rules
rubric: '#8e3020', // the accent: lemmas of the glosses, the matn, titles
rule: '#3a312a', // the frame
muted: '#6a6056', // the note on the text
paper: '#f6efe0', // a toned 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: 'rubric (defaults)', value: { hex: palette.rubric, model: 'hex' } },
];
const NASKH = 'Amiri'; // the text, the matn and the glosses
const RUQAA = 'Aref Ruqaa'; // the title page and the chapter title
const TRIM = { width: 170, height: 240 }; // mm
const M = { top: 34, bottom: 24, inner: 20, outer: 15 }; // mm: the type area inside the frame
// #region answer: the commentary's column beside the text, both inside one ruled frame
// The text runs in the main column of a column-and-a-half layout; the side column, on the
// outer side, takes only boxes with span 'side'. A gloss is written before the passage it
// explains and starts level with its first line, on the page where that passage goes on
// (sideAtColumnEnd: 'after'). A column rule parts the two, as the jadwal of a Bulaq page does.
const layout = { layoutType: 'oneAndHalf', sideColumnRole: 'floats', sideColumnSide: 'outer',
sideColumnPercent: 31, gutterWidth: mm(7),
columnRule: { enabled: true, color: col('rule'), lineWidth: pt(0.6) } };
// A gloss is a callout with no box: the margin's own face, its lemma bold in the rubric.
const hashiya = { id: 'hashiya', span: 'side', sideAtColumnEnd: 'after',
backgroundEnabled: false, borderRadius: pt(0),
padding: { top: pt(0), right: pt(0), bottom: pt(0), left: pt(0) },
stripe: { enabled: false }, border: { enabled: false },
body: { fontFamily: NASKH, fontSize: pt(10), lineHeight: pt(16), color: col('ink'),
boldColor: col('rubric'), textAlign: 'justify', firstLineIndent: pt(0),
paragraphSpacing: true } };
// #endregion
// #region frame: a double rule round the type area and a band for the running head
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
#Posa el comentari al costat interior
Algunes impremtes posen la ḥāshiya al costat del llom, i el text conserva el marge exterior, més ample.
-const layout = { layoutType: 'oneAndHalf', sideColumnRole: 'floats', sideColumnSide: 'outer',
+const layout = { layoutType: 'oneAndHalf', sideColumnRole: 'floats', sideColumnSide: 'inner',#Tanca cada glossa en un filet
Un filet fi al voltant de cada glossa, com en alguns impresos caireses posteriors, és la vora pròpia del requadre.
- stripe: { enabled: false }, border: { enabled: false },
+ stripe: { enabled: false }, border: { enabled: true, width: pt(0.4), color: col('rule') },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 →
Crèdits
- Recepta
- Ignacio Ferro
- Text
- Ibn ʿAqīl’s commentary on the opening of the Alfiyya, with Ibn Mālik’s verses, as ar.wikisource gives it (revision 521625), without the modern editor’s footnotes · Ibn ʿAqīl, Ibn Mālik · domini públic
- The glosses in the margin, the title page, the note on the text and the colophon · Postext Cookbook · original
- Fonts
- Amiri (SIL OFL 1.1) · Aref Ruqaa (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)


