En poques paraules
Cinc pàgines d'una revista acadèmica àrab: l'article, les notes a peu de pàgina, la llista de referències i un índex. L'índex posa الكشيدة sota ك, com els índexs àrabs, i no sota l'article ال.
Què compondràs
Cinc pàgines d'un número d'una revista àrab imaginària, en 17 × 24 cm i a partir de la pàgina 87: un article sobre si la justificació amb caixida fa més lenta la lectura, compost en Amiri de 12 pt amb els títols de secció en Noto Kufi Arabic. Les notes van al peu de cada pàgina i es numeren «(١)», «(٢)» des d'u a cada pàgina, com les numeren les revistes àrabs; les cites, escrites [@ayalon2016] al Markdown, també són notes, amb l'estil de notes de Chicago i la configuració regional àrab de CSL. Segueix la llista de referències, primer les obres àrabs, i tanca un índex a dues columnes. L'índex posa الكشيدة sota ك i الصحف اليومية sota ص: l'article ال no compta. L'assaig d'història amb notes de Chicago fa el mateix en anglès.
Aquesta recepta respon a
- Com ordeno un índex àrab sense tenir en compte l'article ال?
- Com cito les fonts en un article àrab, amb notes a peu de pàgina i bibliografia?
La resposta curta
// Citations are written [@ayalon2016, 45] in the text; a note style puts each one in a
// footnote, numbered with the author's own [^notes]. The CSL locale is Arabic: ص for a page.
registerCitationEngine(createCiteprocEngine({ styles: STYLES, locales: LOCALES }));
const citations = {
style: 'chicago-notes-bibliography', notes: 'footnote', locale: 'ar',
bibliography: { fontSize: em(0.9), lineHeight: pt(17), hangingIndent: em(2),
entrySpacing: pt(2) },
};
const footnotes = {
markerTemplate: '({n})', // «(١)», in the document's digits
numbering: 'page', // from (١) again on every page, as Arabic journals number them
noteNumberPosition: 'inline', // the note opens with (١) on the line, not raised
fontSize: pt(10), lineHeight: pt(18), spaceBetween: pt(2), // 1.8 ×: tanwīn clears the line
textAlign: 'start', // ragged from the right: a Latin title would open wide gaps
separator: { width: 0.3, lineWidth: pt(0.5), color: col('red') }, // on the start side
};
// The index sorts by the word after the article: الكشيدة files under ك, not under ا.
// ignoreArticle is already true for an Arabic index; it is written out to be seen.
const index = {
ignoreArticle: true,
fontFamily: TEXT, fontSize: pt(10.5), lineHeight: pt(16), indent: em(1.2),
main: { bold: true }, // the page that defines the term
groups: { fontFamily: LABEL, fontSize: pt(10), fontWeight: 700, color: col('red') },
};
Ingredients
- Funcions
- L'àrab com a llengua del documentÍndex ordenat sense l'articleCites en notesNotes a peu de pàginaCites en un estil de citaBibliografia a partir de les referènciesÍndex analíticText de dreta a esquerraFonts àrabsXifres dels números generatsTítols numeratsEstils de títolObertures dissenyadesCapçaleres i folisRequadresExportació a PDF
- També fa servir
- Paràgrafs en l'altra direccióEquilibri de columnesAtributs de títolColor del paperCapçaleres segons el tipus de pàginaEstils de paràgrafFonts incrustades al PDFLlibres enquadernats per la dretaPreliminars en romansGeometria per seccióCapítols sense número
- Tipografia
- Amiri, Noto Kufi Arabic (SIL OFL 1.1)
- Recursos
- Cap: totes les imatges es dibuixen en codi
Elaboració
#1 · Notes, cites i índex en un mateix lloc
El codi és a la resposta curta, més amunt. Els ajustos de les notes són els tres que demanen els llibres àrabs: markerTemplate: '({n})' per als parèntesis, numbering: 'page' per tornar a començar a cada pàgina i noteNumberPosition: 'inline' perquè la nota comenci amb «(١)» a la seva línia; les xifres són les del document i el filet queda a la dreta (Notes a peu de pàgina). Les cites comparteixen la numeració de les notes. citations.locale: 'ar' dona els termes de CSL en àrab, com عدد per al número d'una revista. index.ignoreArticle ordena cada entrada per la paraula que segueix ال i unifica les formes de la hamza, de manera que أميري i الأعمدة van totes dues sota ا (Índex general i índex analític); ve activat per a un índex àrab i aquí s'escriu perquè es vegi.

#2 · Una capçalera d'article sense franja
const centred = (y, extra = {}) => ({ anchor: { to: 'container', edge: 'top' },
offset: { y: mm(y) }, size: { width: 'fill' }, ...extra });
const line = (id, content, family, size, colour, y, extra = {}) => ({ kind: 'text', id,
content, fontFamily: family, fontSize: pt(size), color: col(colour), align: 'center',
overflow: 'wrap', placement: centred(y), ...extra });
const masthead = { enabled: true, minHeight: mm(70), slot: { elements: [
line('journal', JOURNAL, LABEL, 9, 'red', 0, { fontWeight: 700 }),
line('issue', '{attr.issue}', LABEL, 8, 'muted', 6),
{ kind: 'rule', id: 'rule', thickness: pt(0.5), color: col('rule'),
placement: centred(13) },
line('title', '{titleText}', TEXT, 22, 'ink', 18, { fontWeight: 700, lineHeight: 1.45 }),
line('author', '{attr.author}', TEXT, 13, 'ink', 45),
line('affiliation', '{attr.affiliation}', TEXT, 10, 'muted', 52),
] } };
El títol de l'article és el títol de primer nivell, dibuixat per un disseny: el nom i el número de la revista, un filet prim, el títol en dues línies centrades i l'autora. La línia del número està teclejada amb xifres arabicoíndiques, perquè l'atribut d'un disseny és text de l'autor i el motor no el reescriu. La numeració comença a la 87 (page.pageNumbering.startAt), de manera que els folis diuen on és l'article dins del número.
#3 · Capçaleres des de la cantonada exterior
const head = (id, content, parity, edge, x) => ({ kind: 'text', id, content, parity,
pages: 'body', fontFamily: LABEL, fontSize: pt(7.5), color: col('muted'), align: edge,
placement: { anchor: { to: 'page', edge: `top-${edge}` }, offset: { x: mm(x), y: mm(13) } } });
const folio = (id, parity, edge, x) => ({ ...head(id, '{pageNumber}', parity, edge, x),
fontWeight: 700, color: col('red') });
const header = { elements: [
folio('r-folio', 'even', 'right', -SIDE.outer),
head('r-head', JOURNAL, 'even', 'right', -(SIDE.outer + 9)),
head('l-head', SHORT_TITLE, 'odd', 'left', SIDE.outer + 9),
folio('l-folio', 'odd', 'left', SIDE.outer),
] };
Les pàgines dretes porten el nom de la revista i les esquerres l'autora i un títol abreujat, cadascuna amb el foli a la cantonada exterior. Els elements de la capçalera conserven els costats físics, així que la pàgina parella, que en aquesta enquadernació queda a la dreta, s'ancora a top-right.
La recepta completa
// ═══ Postext Cookbook · Nº 107 · An Arabic research article with notes, citations and an index ═══
// https://postext.dev/en/cookbook/arabic-research-article
// Code: MIT · Text: original Arabic prose (CC BY 4.0) · Pictures: none
// Fonts: Amiri, Noto Kufi Arabic (SIL OFL 1.1) · Needs postext ≥ 1.65.0
import {
buildDocument, withLoadedFonts, renderPageToCanvas, registerCitationEngine,
} from 'https://esm.sh/postext';
import { renderToPdf, decompressWoff2 } from 'https://esm.sh/postext-pdf';
import { createCiteprocEngine, STYLES, LOCALES } from 'https://esm.sh/postext-citeproc';
const LANG = 'es'; // @lang: the language of the frame; the article is Arabic in both editions
const RECIPE = 'arabic-research-article';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: a journal's dark red on a warm white
const palette = {
ink: '#1d1a19', // text
red: '#7d2028', // the accent: the journal's name, section numbers, the notes' rule
rose: '#f1e4e1', // the abstract's ground
rule: '#c8bcb5', // hairlines
muted: '#655d58', // running heads, the colophon
paper: '#fffdfa',
};
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = Object.entries({ ...palette, 'main-color': palette.red })
.map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
// #endregion
const [TEXT, LABEL] = ['Amiri', 'Noto Kufi Arabic'];
const [BODY, LEAD] = [12, 20]; // pt: Amiri, partly vocalised, at 1.67 × the size
const TRIM = { width: 170, height: 240 }; // mm: 17 × 24 cm, the Arab journal
const SIDE = { inner: 22, outer: 18 }; // mm
const JOURNAL = 'مجلة دراسات الكتاب والنشر';
const SHORT_TITLE = 'سلمى الخطيب: أثر الكشيدة في سرعة القراءة'; // the recto's running head
// #region answer: notes «(١)» per page, the citations among them, an index without ال
// Citations are written [@ayalon2016, 45] in the text; a note style puts each one in a
// footnote, numbered with the author's own [^notes]. The CSL locale is Arabic: ص for a page.
registerCitationEngine(createCiteprocEngine({ styles: STYLES, locales: LOCALES }));
const citations = {
style: 'chicago-notes-bibliography', notes: 'footnote', locale: 'ar',
bibliography: { fontSize: em(0.9), lineHeight: pt(17), hangingIndent: em(2),
entrySpacing: pt(2) },
};
const footnotes = {
markerTemplate: '({n})', // «(١)», in the document's digits
numbering: 'page', // from (١) again on every page, as Arabic journals number them
noteNumberPosition: 'inline', // the note opens with (١) on the line, not raised
fontSize: pt(10), lineHeight: pt(18), spaceBetween: pt(2), // 1.8 ×: tanwīn clears the line
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
#Numera les notes al llarg de l'article
Moltes revistes àrabs modernes numeren les notes per article en lloc de per pàgina.
- numbering: 'page', // from (١) again on every page, as Arabic journals number them
+ numbering: 'chapter',#Cita amb autor i any
- style: 'chicago-notes-bibliography', notes: 'footnote', locale: 'ar',
+ style: 'apa', locale: 'ar',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 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 →
- La puntuació que escriu un estil CSL és la de l'estil: les comes, els punts i comes i les cometes entre les parts d'una nota són llatines, com a الهاشمي, الحرف العربي. Les dates i els números surten de les dades, així que les obres àrabs porten
issued: {literal: "٢٠١٩"}i localitzadors com[@hashimi2019, ٧٧]; les obres llatines conserven 0–9. - Una nota o una referència a una obra llatina continua sent un paràgraf de la pàgina àrab, compost des de la dreta, i es llegeix d'esquerra a dreta per dins: el motor compon la referència com un tram aïllat, de manera que l'URL, les cometes i el punt final es queden on acaba.
Crèdits
- Recepta
- Ignacio Ferro
- Text
- A research article written in Arabic for the recipe; its journal, author, experiment and Arabic sources are invented · Postext Cookbook · original
- Fonts
- Amiri (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)


