Pular para o conteúdo principal
Receita número 107

Receitas · Capítulo 5 · Estrutura do livro

Um artigo acadêmico árabe com notas, citações e índice

Um artigo de revista árabe: notas «(١)» numeradas por página, citações CSL entre elas no idioma árabe e um índice ordenado sem o artigo ال.

Nesta página
Saída
Canvas · PDF
Nível
Avançado
Postext
Testada com o Postext 1.65.0
Requer ≥ 1.65.0 · postext-pdf ≥ 1.65.0
Licença
Atualizada em 31 de out. de 2026
Código MIT · Texto CC BY 4.0

p. ٨٧ · 1 de 5

  • Amostra em inglês: ainda sem edição em português
  • Refile 170 × 240 mm
  • 1 coluna
  • Amiri 12/20
  • Noto Kufi Arabic
  • 5 páginas
  • Nível
  • Postext 1.65.0
  • Diagramado em 534 ms
  • 145 linhas de código

Em poucas palavras

Cinco páginas de uma revista acadêmica árabe: o artigo, as notas de rodapé, a lista de referências e um índice. O índice põe الكشيدة sob ك, como fazem os índices árabes, e não sob o artigo ال.

O que você vai compor

Cinco páginas de uma edição de uma revista árabe imaginária, em 17 × 24 cm, a partir da página 87: um artigo sobre se a justificação com kashida deixa a leitura mais lenta, composto em Amiri de 12 pt com títulos de seção em Noto Kufi Arabic. As notas ficam no pé de cada página e são numeradas «(١)», «(٢)» a partir de um em cada página, como as revistas árabes as numeram; as citações, escritas como [@ayalon2016] no Markdown, também são notas, formatadas pelo estilo de notas Chicago com o idioma árabe do CSL. Segue uma lista de referências, primeiro as obras árabes, e um índice em duas colunas fecha o texto. O índice põe الكشيدة sob ك e الصحف اليومية sob ص: o artigo ال não conta. O ensaio de história com notas Chicago faz o mesmo em inglês.

Esta receita responde a

  • Como ordeno um índice árabe ignorando o artigo ال?
  • Como cito as fontes em um artigo em árabe, com notas de rodapé e bibliografia?

A resposta curta

script.js · linhas 36–59no 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

Tipografia
Amiri, Noto Kufi Arabic (SIL OFL 1.1)
Materiais
Nenhum: todas as imagens são desenhadas em código

Preparo

#1 · Notas, citações e índice num só lugar

O código é a resposta curta logo acima. As configurações de notas de rodapé são as três que os livros árabes pedem: markerTemplate: '({n})' para os parênteses, numbering: 'page' para recomeçar em cada página e noteNumberPosition: 'inline' para a nota abrir com «(١)» na própria linha; os algarismos são os do documento, e o fio fica à direita (Notas de rodapé). As citações compartilham a numeração das notas. citations.locale: 'ar' dá os termos do CSL em árabe, como عدد para o número de uma edição. index.ignoreArticle ordena cada entrada pela palavra que vem depois de ال e unifica as formas da hamza, por isso أميري e الأعمدة vão ambas para ا (Sumário e índice); a opção já vem ativada num índice árabe e está escrita aqui para ficar à vista.

O índice: duas colunas a partir da direita, letras em vermelho e الكشيدة sob ك com uma remissiva.

#2 · Um cabeçalho de artigo sem faixa

script.js · linhas 63–76no 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),
] } };

O título do artigo é o título de nível 1, desenhado por um design: o nome e o número da revista, um fio fino, o título em duas linhas centralizadas e a autora. A linha da edição está digitada em algarismos arábico-índicos, porque o atributo de um design é texto do autor e o motor não o reescreve. A numeração das páginas começa em 87 (page.pageNumbering.startAt), por isso os fólios mostram onde o artigo fica dentro da edição.

#3 · Cabeços a partir do canto externo

script.js · linhas 80–90no 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),
] };

As páginas direitas levam o nome da revista e as esquerdas a autora e um título curto, cada uma com o fólio no canto externo. Os elementos do cabeçalho mantêm os lados físicos, de modo que a página par, que nesta encadernação fica à direita, se ancora em top-right.

A receita 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 = 'en'; // @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

O script.js montado funciona como está: cole-o como script de módulo em qualquer página ou abra a receita no CodePen. Pasta da receita no GitHub ↗ (abre em uma nova aba)

Variações

#Numere as notas ao longo do artigo

Revistas árabes modernas costumam numerar as notas por artigo em vez de por página.

-  numbering: 'page', // from (١) again on every page, as Arabic journals number them
+  numbering: 'chapter',

#Cite por autor e data

-  style: 'chicago-notes-bibliography', notes: 'footnote', locale: 'ar',
+  style: 'apa', locale: 'ar',

Erros comuns

Erro comum

Marque um livro árabe como 'ar', não com LANG

As edições de uma receita são en e es, mas uma amostra árabe é árabe nas duas: `locale: LANG` a comporia da esquerda para a direita, a encadernaria pela esquerda, numeraria as suas páginas 1 2 3 e chamaria as suas figuras de Figure ou Figura. Desde o postext 1.30 a marcação é também o idioma em que o texto é composto (em que é medido, pintado e incorporado), então, sob uma marcação inglesa ou espanhola, uma fonte como a Markazi Text não desenha as formas árabes das aspas angulares e dos pontos, e as linhas quebram em outro ponto. Escreva você mesmo a marcação: 'ar' (algarismos arábico-índicos, a convenção do Machrek), uma região como 'ar-EG' ou 'ar-SA', ou 'ar-MA', 'ar-DZ' ou 'ar-TN' para uma edição magrebina com algarismos europeus. Uma página latina que só cita árabe mantém o seu próprio locale. Texto da direita para a esquerda →

Erro comum

Fontes árabes precisam do seu arquivo arabic, pelo bloco arabic

O Fontsource serve Amiri, Noto Naskh Arabic ou Scheherazade New em um arquivo por subconjunto, e as letras árabes estão no arquivo arabic. loadFonts baixa só latin (e latin-ext), então na tela o árabe vem de uma fonte do sistema e é medido errado, e o fontsourceProvider entrega ao PDF esse arquivo latin, que imprime caixas vazias. Inclua o bloco arabic do kit, chame loadArabicFonts(FONTS, markdown) depois de loadFonts, com todos os pesos que as páginas usam em árabe listados em FONTS, e passe a renderToPdf fontProvider: arabicPdfProvider. Fontes árabes →

Erro comum

Um estilo de título herda a quebra de página do seu nível

Uma entrada de headingStyles recebe do seu nível de título todos os campos que não define, inclusive breakBefore. Um sumário ou um colofão com estilo sobre um H1 depois de um :::pagebreak herda a paridade 'odd' e cai depois de uma página em branco. Dê a esse estilo breakBefore: { enabled: false }. Estilos de título →

  • A pontuação que um estilo CSL escreve é a do estilo: as vírgulas, os pontos e vírgulas e as aspas entre as partes de uma nota são latinos, como em الهاشمي, الحرف العربي. Datas e números vêm dos dados, por isso as obras árabes levam issued: {literal: "٢٠١٩"} e localizadores como [@hashimi2019, ٧٧]; as obras latinas mantêm 0–9.
  • Uma nota ou uma referência a uma obra latina continua sendo um parágrafo da página árabe, composto a partir da direita, e é lida da esquerda para a direita por dentro: o motor compõe a referência como um trecho isolado, de modo que a URL, as aspas e o ponto final ficam onde ela termina.

Créditos

Texto
  • A research article written in Arabic for the recipe; its journal, author, experiment and Arabic sources are invented · Postext Cookbook · original
Fontes
Amiri (SIL OFL 1.1) · Noto Kufi Arabic (SIL OFL 1.1)
SandboxPDF