Saltar al contingut principal
Recepta número 107

Receptari · Capítol 5 · Estructura del llibre

Un article acadèmic àrab amb notes, cites i índex

Article de revista àrab: notes «(١)» per pàgina, cites CSL entre elles amb la configuració regional àrab i un índex que ordena sense l'article ال.

En aquesta pàgina
Sortida
Canvas · PDF
Nivell
Avançat
Postext
Provada amb Postext 1.65.0
Requereix ≥ 1.65.0 · postext-pdf ≥ 1.65.0
Llicència
Actualitzada el 31 d’oct. del 2026
Codi MIT · Text CC BY 4.0
  • Mostra en castellà: encara no hi ha edició en català
  • Format 170 × 240 mm
  • 1 columna
  • Amiri 12/20
  • Noto Kufi Arabic
  • 5 pàgines
  • Nivell
  • Postext 1.65.0
  • Compost en 588 ms
  • 145 línies de codi

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

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

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.

L'índex: dues columnes des de la dreta, lletres en vermell i الكشيدة sota ك amb una remissió.

#2 · Una capçalera d'article sense franja

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

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

Sandbox
// ═══ 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

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