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
// 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
- Funcionalidades
- Árabe como idioma do documentoÍndice remissivo ordenado sem o artigoCitações em notasNotas de rodapéCitações em um estilo de citaçãoBibliografia a partir das referênciasÍndice remissivoTexto da direita para a esquerdaFontes árabesAlgarismos dos números geradosTítulos numeradosEstilos de títuloAberturas desenhadasCabeços e fóliosBoxesExportação para PDF
- Também usa
- Parágrafos na outra direçãoEquilíbrio de colunasAtributos de títuloCor do papelCabeços por tipo de páginaEstilos de parágrafoFontes incorporadas ao PDFLivros encadernados pela direitaElementos pré-textuais em romanosGeometria por seçãoCapítulos sem número
- 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.

#2 · Um cabeçalho de artigo sem faixa
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
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
// ═══ 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
- Receita
- Ignacio Ferro
- 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)
- Código
- MIT, como o Postext
Editar este texto ↗ (abre em uma nova aba)Pasta da receita no GitHub ↗ (abre em uma nova aba)


