انتقل إلى المحتوى الرئيسي
الوصفة رقم 107

دليل الوصفات · الفصل 5 · بنية الكتاب

بحث عربي محكَّم بحواشٍ واستشهادات وفهرس

بحث في مجلة عربية: حواشٍ «(١)» مرقّمة لكل صفحة، واستشهادات CSL بينها بالإعدادات المحلية العربية، وفهرس مرتّب دون اعتبار «ال» التعريف.

في هذه الصفحة
المُخرَج
Canvas · PDF
المستوى
متقدم
Postext
اختُبرت مع Postext 1.65.0
تتطلب ≥ 1.65.0 · postext-pdf ≥ 1.65.0
الترخيص
حُدّثت في 31 أكتوبر 2026
الشيفرة MIT · النص CC BY 4.0

ص ٨٧ · 1 من 5

  • نموذج باللغة الإنجليزية: لا توجد طبعة عربية بعد
  • مقاس القص 170 × 240 مم
  • عمود واحد
  • Amiri 12/20
  • Noto Kufi Arabic
  • 5 صفحات
  • المستوى
  • Postext 1.65.0
  • أُخرجت في 534 ms
  • أسطر الشيفرة: 145

باختصار

خمس صفحات من مجلة أكاديمية عربية: البحث وحواشيه وقائمة مراجعه وفهرس. يضع الفهرس كلمة «الكشيدة» تحت حرف الكاف، كما تفعل الفهارس العربية، لا تحت «ال» التعريف.

ما الذي ستنضده

خمس صفحات من عدد لمجلة عربية متخيَّلة، بقياس 17 × 24 سم، تبدأ من الصفحة 87: بحث يسأل هل يُبطئ الضبط بالكشيدة القراءة، منضّد بخط Amiri بحجم 12 pt، وعناوين أقسامه بخط Noto Kufi Arabic. تقع حواشيه أسفل كل صفحة، وتُرقَّم «(١)»، «(٢)» ابتداءً من الواحد في كل صفحة، كما ترقّمها المجلات العربية؛ والاستشهادات، المكتوبة [@ayalon2016] في Markdown، حواشٍ هي الأخرى، ينسّقها نمط Chicago للحواشي بالإعدادات المحلية العربية لـ CSL. تتبعها قائمة مراجع، العربية منها أولًا، ويختم البحثَ فهرسٌ بعمودين. يضع الفهرس «الكشيدة» تحت الكاف و«الصحف اليومية» تحت الصاد: «ال» التعريف لا تُحتسب. ويفعل مقال التاريخ بحواشي Chicago الشيء نفسه بالإنجليزية.

تجيب هذه الوصفة عن

  • كيف أرتّب فهرسًا عربيًّا من دون أداة التعريف ال؟
  • كيف أستشهد بالمصادر في مقال عربي، بحواشٍ سفلية وقائمة مراجع؟

الجواب المختصر

script.js · الأسطر 36–59في الشيفرة الكاملة
// 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') },
};

المكونات

الخطوط
Amiri, Noto Kufi Arabic (SIL OFL 1.1)
الأصول
لا شيء: كل صورة مرسومة بالشيفرة

طريقة التحضير

#1 · الحواشي والاستشهادات والفهرس في موضع واحد

الشيفرة هي الجواب المختصر أعلاه. إعدادات الحواشي هي الثلاثة التي تطلبها الكتب العربية: markerTemplate: '({n})' للقوسين، وnumbering: 'page' ليبدأ الترقيم من جديد في كل صفحة، وnoteNumberPosition: 'inline' لتبدأ الحاشية بـ «(١)» على سطرها؛ والأرقام أرقام المستند، والخط الفاصل يقع على اليمين (الحواشي السفلية). وتشترك الاستشهادات مع الحواشي في ترقيمها. ويأتي citations.locale: 'ar' بمصطلحات CSL العربية، مثل «عدد» لرقم العدد. ويرتّب index.ignoreArticle كل مدخل بالكلمة التي تلي «ال» ويوحّد صور الهمزة، فتذهب «أميري» و«الأعمدة» كلتاهما تحت الألف (المحتويات والفهرس). وهو مفعّل افتراضيًا في الفهرس العربي، وكُتب هنا صراحةً ليُرى.

الفهرس: عمودان من اليمين، والحروف بالأحمر، و«الكشيدة» تحت الكاف ومعها «انظر أيضًا».

#2 · ترويسة مجلة بلا شريط

script.js · الأسطر 63–76في الشيفرة الكاملة
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),
] } };

عنوان البحث هو العنوان من المستوى الأول، يرسمه تصميم: اسم المجلة ورقم العدد، وخط رفيع، والعنوان في سطرين موسّطين، والمؤلفة. كُتب سطر العدد بالأرقام العربية المشرقية، لأن سمة التصميم نصّ كتبه المؤلف ولا يعيد المحرّك كتابته. ويبدأ ترقيم الصفحات من 87 (page.pageNumbering.startAt)، فتُظهر أرقام الصفحات موضع البحث في العدد.

#3 · ترويسات من الزاوية الخارجية

script.js · الأسطر 80–90في الشيفرة الكاملة
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),
] };

على الصفحات اليمنى اسم المجلة، وعلى اليسرى اسم المؤلفة وعنوان مختصر، ولكل منها رقم صفحتها عند الزاوية الخارجية. تحتفظ عناصر الترويسة بجوانبها الفعلية، فالصفحة الزوجية، الواقعة على اليمين في هذا التجليد، تُربط بـtop-right.

الوصفة كاملة

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

يعمل ملف script.js المجمّع كما هو: الصقه في سكربت الوحدة (module) لأي صفحة، أو افتح الوصفة على CodePen. مجلد الوصفة على GitHub ↗ (يفتح في تبويب جديد)

تنويعات

#رقّم الحواشي على امتداد البحث

كثيرًا ما ترقّم المجلات العربية الحديثة الحواشي لكل بحث لا لكل صفحة.

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

#وثّق بالمؤلف والتاريخ

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

أخطاء شائعة

خطأ شائع

اوسم الكتاب العربي بـ 'ar'، لا بـ LANG

نسختا الوصفة هما en وes، لكن المثال العربي عربي في كلتيهما: `locale: LANG` سيجعله من اليسار إلى اليمين، ويجلّده على اليسار، ويرقّم صفحاته 1 2 3، ويسمّي أشكاله Figure أو Figura. ومنذ postext 1.30 صار الوسم أيضًا اللغة التي يُشكَّل بها النص (يُقاس ويُرسم ويُضمَّن بها)، فتحت وسم إنجليزي أو إسباني لا يرسم خط مثل Markazi Text الأشكال العربية لعلامتَي التنصيص « » وللنقطة، وتنكسر الأسطر في مواضع أخرى. اكتب الوسم بنفسك: 'ar' (الأرقام العربية المشرقية، عُرف المشرق)، أو منطقة مثل 'ar-EG' أو 'ar-SA'، أو 'ar-MA' أو 'ar-DZ' أو 'ar-TN' لنسخة مغاربية بالأرقام الأوروبية. أما الصفحة اللاتينية التي تقتبس العربية فقط فتحتفظ بلغتها. النص من اليمين إلى اليسار →

خطأ شائع

الخطوط العربية تحتاج إلى ملفها arabic، عبر الكتلة arabic

يقدّم Fontsource الخطوط Amiri وNoto Naskh Arabic وScheherazade New في ملف لكل مجموعة فرعية، والحروف العربية في ملف arabic. لا يجلب loadFonts إلا latin (وlatin-ext)، فيأتي النص العربي على الشاشة من خط النظام ويُقاس خطأً، ويسلّم fontsourceProvider ملف latin ذاك إلى PDF، فيطبع مربعات فارغة. اذكر كتلة الأدوات arabic، واستدعِ loadArabicFonts(FONTS, markdown) بعد loadFonts، مع ذكر كل وزن تضع به الصفحاتُ نصًا عربيًا في FONTS، وأعطِ renderToPdf القيمة fontProvider: arabicPdfProvider. الخطوط العربية →

خطأ شائع

يرث نمط العنوان فاصل الصفحة من مستواه

يأخذ مُدخل headingStyles كل حقل يتركه من مستوى عنوانه، بما فيه breakBefore. فصفحة المحتويات أو صفحة بيانات النشر المنسّقة على H1 بعد :::pagebreak ترث الزوجية 'odd' وتقع بعد صفحة فارغة. أعطِ هذا النمط breakBefore: { enabled: false }. أنماط العناوين →

  • علامات الترقيم التي يكتبها نمط CSL هي علامات النمط: الفواصل والفواصل المنقوطة وعلامات التنصيص بين أجزاء الحاشية لاتينية، كما في الهاشمي, الحرف العربي. أما التواريخ والأعداد فتأتي من البيانات، فتُكتب في المؤلفات العربية issued: {literal: "٢٠١٩"} ومواضع مثل [@hashimi2019, ٧٧]؛ وتحتفظ المؤلفات اللاتينية بالأرقام 0–9.
  • الحاشية أو المرجع الخاص بعمل لاتيني يبقى فقرة من فقرات الصفحة العربية، تبدأ من اليمين، ويُقرأ داخلها من اليسار إلى اليمين: ينضّد المحرّك المرجع مقطعًا معزولًا، فيبقى رابطه وعلامتا تنصيصه ونقطته الأخيرة حيث ينتهي.

الحقوق

الوصفة
Ignacio Ferro
النص
  • A research article written in Arabic for the recipe; its journal, author, experiment and Arabic sources are invented · Postext Cookbook · أصلي
الخطوط
Amiri (SIL OFL 1.1) · Noto Kufi Arabic (SIL OFL 1.1)
الشيفرة
MIT، مثل Postext
SandboxPDF