Saltar al contenido principal
Receta número 107

Recetario · Capítulo 5 · Estructura del libro

Un artículo académico árabe con notas, citas e índice

Artículo de revista árabe: notas «(١)» por página, citas CSL entre ellas con la configuración regional árabe y un índice que ordena sin el artículo ال.

En esta página
Salida
Canvas · PDF
Postext
Probada con Postext 1.65.0
Requiere ≥ 1.65.0 · postext-pdf ≥ 1.65.0
Licencia
Actualizada el 31 oct 2026
Código MIT · Texto CC BY 4.0

p. ٨٧ · 1 de 5

  • Formato 170 × 240 mm
  • 1 columna
  • Amiri 12/20
  • Noto Kufi Arabic
  • 5 páginas
  • Nivel
  • Postext 1.65.0
  • Compuesto en 588 ms
  • 145 líneas de código

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

script.js · líneas 36–59en el código completo
// 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

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.

El índice: dos columnas desde la derecha, letras en rojo y الكشيدة bajo ك con una remisión.

#2 · Una cabecera de artículo sin franja

script.js · líneas 63–76en el código completo
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

script.js · líneas 80–90en el código completo
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

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

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

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