En pocas palabras
Cinco páginas de una revista académica árabe: el artículo, sus notas al pie, la lista de referencias y un índice. El índice pone الكشيدة bajo ك, como los índices árabes, y no bajo el artículo ال.
Lo que vas a componer
Cinco páginas de un número de una revista árabe imaginaria, en 17 × 24 cm y a partir de la página 87: un artículo sobre si la justificación con cachida hace más lenta la lectura, compuesto en Amiri de 12 pt con los títulos de sección en Noto Kufi Arabic. Las notas van al pie de cada página y se numeran «(١)», «(٢)» desde uno en cada página, como las numeran las revistas árabes; las citas, escritas [@ayalon2016] en el Markdown, también son notas, con el estilo de notas de Chicago y la configuración regional árabe de CSL. Sigue la lista de referencias, primero las obras árabes, y cierra un índice a dos columnas. El índice pone الكشيدة bajo ك y الصحف اليومية bajo ص: el artículo ال no cuenta. El ensayo de historia con notas de Chicago hace lo mismo en inglés.
Esta receta responde a
- ¿Cómo ordeno un índice árabe sin tener en cuenta el artículo ال?
- ¿Cómo cito las fuentes en un artículo árabe, con notas al pie y bibliografía?
La respuesta corta
// 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') },
};
Ingredientes
- Funciones
- El árabe como idioma del documentoÍndice ordenado sin el artículoCitas en notasNotas al pieCitas en un estilo de citaBibliografía a partir de las referenciasÍndice analíticoTexto de derecha a izquierdaFuentes árabesCifras de los números generadosTítulos numeradosEstilos de títuloAperturas diseñadasCabeceras y foliosRecuadrosExportación a PDF
- También usa
- Párrafos en la otra direcciónEquilibrado de columnasAtributos de títuloColor del papelCabeceras según el tipo de páginaEstilos de párrafoFuentes incrustadas en el PDFLibros encuadernados por la derechaPreliminares en romanosGeometría por secciónCapítulos sin número
- Tipografía
- Amiri, Noto Kufi Arabic (SIL OFL 1.1)
- Recursos
- Ninguno: todas las imágenes se dibujan en código
Elaboración
#1 · Notas, citas e índice en un mismo sitio
El código está en la respuesta corta, más arriba. Los ajustes de las notas son los tres que piden los libros árabes: markerTemplate: '({n})' para los paréntesis, numbering: 'page' para volver a empezar en cada página y noteNumberPosition: 'inline' para que la nota empiece con «(١)» en su línea; las cifras son las del documento y el filete queda a la derecha (Notas al pie). Las citas comparten la numeración de las notas. citations.locale: 'ar' da los términos de CSL en árabe, como عدد para el número de una revista. index.ignoreArticle ordena cada entrada por la palabra que sigue a ال y unifica las formas de la hamza, así que أميري y الأعمدة van las dos bajo ا (Índice general e índice analítico); viene activado para un índice árabe y aquí se escribe para que se vea.

#2 · Una cabecera de artículo sin 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ítulo del artículo es el encabezado de primer nivel, dibujado por un diseño: el nombre y el número de la revista, un filete fino, el título en dos líneas centradas y la autora. La línea del número está tecleada con cifras arábigo-índicas, porque el atributo de un diseño es texto del autor y el motor no lo reescribe. La numeración empieza en la 87 (page.pageNumbering.startAt), así que los folios dicen dónde está el artículo dentro del número.
#3 · Cabeceras desde la esquina 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),
] };
Las páginas derechas llevan el nombre de la revista y las izquierdas la autora y un título abreviado, cada una con su folio en la esquina exterior. Los elementos de la cabecera conservan sus lados físicos, así que la página par, que en esta encuadernación queda a la derecha, se ancla a top-right.
La receta 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
El script.js compuesto funciona tal cual: pégalo como script de módulo en cualquier página o abre la receta en CodePen. Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)
Variantes
#Numera las notas a lo largo del artículo
Muchas revistas árabes modernas numeran las notas por artículo en lugar de por página.
- numbering: 'page', // from (١) again on every page, as Arabic journals number them
+ numbering: 'chapter',#Cita con autor y año
- style: 'chicago-notes-bibliography', notes: 'footnote', locale: 'ar',
+ style: 'apa', locale: 'ar',Errores frecuentes
Error frecuente
Etiqueta un libro árabe 'ar', no con LANG
Las ediciones de una receta son en y es, pero una muestra árabe es árabe en las dos: `locale: LANG` la compondría de izquierda a derecha, la encuadernaría por la izquierda, numeraría sus páginas 1 2 3 y llamaría Figure o Figura a sus figuras. Desde postext 1.30 la etiqueta es además el idioma en el que se compone el texto (en el que se mide, se pinta y se incrusta), así que bajo una etiqueta inglesa o española una fuente como Markazi Text no dibuja las formas árabes de sus comillas angulares y sus puntos, y las líneas se parten por otro sitio. Escribe tú la etiqueta: 'ar' (cifras arábigo-índicas, la convención del Mashriq), una región como 'ar-EG' o 'ar-SA', o 'ar-MA', 'ar-DZ' o 'ar-TN' para una edición magrebí con cifras europeas. Una página latina que solo cita árabe conserva su propio locale. Texto de derecha a izquierda →
Error frecuente
Las fuentes árabes necesitan su archivo arabic, con el bloque arabic
Fontsource sirve Amiri, Noto Naskh Arabic o Scheherazade New en un archivo por subconjunto, y las letras árabes están en el archivo arabic. loadFonts solo descarga latin (y latin-ext), así que en pantalla el árabe sale de una fuente del sistema y se mide mal, y fontsourceProvider entrega al PDF ese archivo latin, que imprime cajas vacías. Añade el bloque arabic del kit, llama a loadArabicFonts(FONTS, markdown) después de loadFonts, con todos los pesos que las páginas usan en árabe listados en FONTS, y pasa a renderToPdf fontProvider: arabicPdfProvider. Fuentes árabes →
Error frecuente
Un estilo de título hereda el salto de página de su nivel
Una entrada de headingStyles toma de su nivel de título todo lo que no fija, también breakBefore. Un índice o un colofón con estilo sobre un H1 tras un :::pagebreak hereda la paridad 'odd' y cae detrás de una página en blanco. Dale a ese estilo breakBefore: { enabled: false }. Estilos de título →
- La puntuación que escribe un estilo CSL es la del estilo: las comas, los puntos y coma y las comillas entre las partes de una nota son latinos, como en الهاشمي, الحرف العربي. Las fechas y los números salen de los datos, así que las obras árabes llevan
issued: {literal: "٢٠١٩"}y localizadores como[@hashimi2019, ٧٧]; las obras latinas conservan 0–9. - Una nota o una referencia a una obra latina sigue siendo un párrafo de la página árabe, compuesto desde la derecha, y se lee de izquierda a derecha por dentro: el motor compone la referencia como un tramo aislado, de modo que su URL, sus comillas y su punto final se quedan donde termina.
Créditos
- Receta
- Ignacio Ferro
- Texto
- Un artículo académico escrito en árabe para la receta; su revista, su autora, su experimento y sus fuentes árabes son inventados · Postext Cookbook · original
- Fuentes
- Amiri (SIL OFL 1.1) · Noto Kufi Arabic (SIL OFL 1.1)
- Código
- MIT, como Postext
Editar este texto ↗ (se abre en una nueva pestaña)Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)


