باختصار
مقالة عن قصيدة لكيتس كما تطبعها مجلة أدبية. يكتب المؤلف رمزًا قصيرًا لكل مصدر، فيطبع Postext المؤلف والصفحة بين قوسين وقائمة الأعمال المستشهد بها في آخر المقالة، على أسلوب MLA.
ما الذي ستنضده
مقالة من مجلة أدبية فصلية: أربع صفحات عمّن ينطق البيتين الأخيرين من قصيدة كيتس "Ode on a Grecian Urn". الصفحة صفحة مجلة قياسها 150 × 230 mm منضَّدة بخط Spectral، وعناوين الأقسام والترويسات بخط Spectral SC، وصفحة الافتتاح في شريط بلون الطلاء الأسود فوق شريط بلون الطين الأحمر، وهما لونا الإناء الأتّيكي. تتبع الاستشهادات أسلوب MLA 9، أسلوب معظم أقسام الأدب وتاريخ الفن: المؤلف والصفحة بين قوسين، والصفحة وحدها حين تذكر الجملة اسم المؤلف، وعنوان مختصر حين يشترك عملان في مؤلف واحد، وقائمة Works Cited في صفحة خاصة بها. كل استشهاد مفتاح في النص، والأسلوب إعداد واحد.
تجيب هذه الوصفة عن
- كيف أستشهد بالأعمال وأبني قائمة المراجع بأسلوب APA أو IEEE أو أسلوب استشهاد آخر؟
الجواب المختصر
// The text cites with [@keats-letters, 48] → (Keats, Letters 48): MLA prints the author
// and the page, and adds a short title when two works share an author. [-@eliot1932, 230]
// drops the name the sentence already gives → (230). The list is alphabetical, and a
// second work by the same author opens with a dash (MLA's ---) instead of the name.
registerCitationEngine(createCiteprocEngine({ styles: STYLES, locales: LOCALES }));
const citations = {
style: 'modern-language-association', // MLA 9th edition, author-page
link: true, // a citation jumps to its entry in Works Cited
bibliography: {
// MLA's half-inch hanging indent, scaled to a 108 mm measure.
fontSize: em(0.94), lineHeight: pt(13.4), hangingIndent: em(2.2), entrySpacing: pt(3),
},
};
المكونات
- الميزات
- الاستشهادات بأسلوب توثيققائمة المراجع من البيانات المرجعيةصفحات افتتاح مصمَّمةسمات العنوانأنماط العناوينالترويسات وأرقام الصفحاتهوامش متناظرةأنماط الفقراتلوحة ألوان دلاليةالتصدير إلى PDF
- الخطوط
- Spectral, Spectral SC (SIL OFL 1.1)
- الأصول
- لا شيء: كل صورة مرسومة بالشيفرة
طريقة التحضير
#1 · الأسلوب MLA والبيانات BibTeX
الشيفرة هي الجواب المختصر أعلاه. يُسجَّل محرّك الاستشهادات مرة واحدة، ويحدّد citations.style أسلوب MLA المرفق؛ ومنه يكتب citeproc-js كل استشهاد والقائمة. توجد المراجع في كتلة :::references{format=bibtex} في آخر المقالة، مكتوبة كما يصدّرها برنامج إدارة المراجع. يحتاج MLA إلى عنوان مختصر لعملَي كيتس، ويحدّده الحقل shorttitle في كل مدخل (واسمه في CSL هو title-short).
#2 · أربعة أنواع من الاستشهاد
يستشهد النص بعمل بالصيغة [@jack1967]، فتُطبع "(Jack)" لأن المقالة تحيل إلى الكتاب كله. ومع رقم صفحة تطبع [@keats-letters, 41] العبارة "(Keats, Letters 41)": فالمقالة تستشهد بعملين لكيتس، فيضيف citeproc العنوان المختصر للتمييز بينهما. وحين تذكر الجملة الناقدَ باسمه، تُسقط [-@eliot1932, 230] الاسم وتطبع "(230)". والاستشهاد السردي بلا صفحة، @stillinger1974 records، يطبع الاسم وحده، "Stillinger records"، وبعده مسافة واحدة: فليس لدى MLA ما يضعه بين القوسين. وبعد أن يُستشهد بالقصيدة مع أرقام أبياتها، تُكتب مع الاقتباسات اللاحقة منها الأرقام وحدها، مكتوبة بين قوسين عاديين، كما يسمح MLA.
#3 · اقتباس كتلي يأتي استشهاده بعد النقطة
// More than four lines of prose go in a Markdown blockquote: in ink, indented, with no
// first-line indent. Its citation follows the final full stop, as MLA asks.
const blockquote = {
color: col('ink'), italic: false, indent: em(2), firstLineIndent: em(0),
};
تمتد الرسالة عن Negative Capability إلى أكثر من أربعة أسطر من النثر، فتُفصل اقتباسًا كتليًا في Markdown: بحروف قائمة، وبلون الحبر، ومُزاحة بمقدار 2 em بلا إزاحة للسطر الأول. يضع MLA استشهاد الاقتباس الكتلي بعد نقطته الأخيرة، ويفعل المصدر الشيء نفسه: …fact and reason. [@keats-letters, 48]. ويفصل :::space{lines=0.5} فوقه وتحته الاقتباسَ عن الفقرات المحيطة به.
#4 · قائمة Works Cited في صفحة خاصة بها
headingStyles: [{ id: 'works-cited', breakBefore: { enabled: true, parity: 'any' } }],
يأخذ العنوان نمطًا ينتقل إلى صفحة جديدة، ويضع :::bibliography{title=""} القائمة تحته من غير عنوان ثانٍ. القائمة مرتبة أبجديًا بإزاحة معلَّقة، ويبدأ العمل الثاني لكيتس بشَرطة بطول ثلاثة em مكان اسمه، كما يطلب MLA للمؤلفين المكرَّرين. ويُطبع رقم صفحة سفلي في ذيل هذه الصفحة وصفحة الافتتاح، حيث تغيب الترويسات.
#5 · صفحة افتتاح بلونَي إناء
const BAND = 116; // mm from the trim's top
const opener = {
enabled: true,
minHeight: mm(BAND - MARGIN.top + 4), // the text starts a line under the band
slot: { elements: [
{ kind: 'box', id: 'band', style: { backgroundColor: col('glaze') },
placement: { ...at('page', 'top-left'), size: { width: 'fill', height: mm(BAND) } } },
{ kind: 'box', id: 'foot', style: { backgroundColor: col('clay') },
placement: { ...at('page', 'top-left', 0, BAND - 3), size: { width: 'fill',
height: mm(3) } } },
{ kind: 'text', id: 'kicker', content: '{attr.kicker}', fontFamily: LABEL, fontWeight: 600,
fontSize: pt(9), letterSpacing: pt(1.6), color: col('slip'), align: 'left',
placement: at('container', 'top-left', 0, 6) },
{ kind: 'text', id: 'title', content: '{titleText}', fontFamily: TEXT, fontWeight: 300,
italic: true, fontSize: pt(56), lineHeight: 0.95, color: col('paper'), align: 'left',
overflow: 'wrap', placement: { ...at('container', 'top-left', -1, 30),
size: { width: mm(110), height: 'auto' } } },
{ kind: 'text', id: 'sub', content: '{attr.sub}', fontFamily: TEXT, fontWeight: 300,
fontSize: pt(13), lineHeight: 1.25, color: col('paper'), align: 'left', overflow: 'wrap',
placement: { ...at('container', 'top-left', 0, 66),
size: { width: mm(96), height: 'auto' } } },
{ kind: 'text', id: 'byline', content: '{attr.byline}', fontFamily: LABEL, fontWeight: 600,
fontSize: pt(9.5), letterSpacing: pt(1.2), color: col('slip'), align: 'left',
placement: at('container', 'top-left', 0, 82) },
] },
};
const palette = {
ink: '#1f1a17', glaze: '#231c19', clay: '#9a3d22', slip: '#e3a27e', rule: '#c9bdb0',
muted: '#6b6159', paper: '#fffdf9',
};
// Every colour is linked to its palette entry by id.
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = Object.entries({ ...palette, 'main-color': palette.clay })
.map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
عمق الشريط 116 mm، وفيه السطر التمهيدي، والعنوان بحجم 56 pt بخط Spectral Light المائل، والعنوان الفرعي واسم الكاتبة، وكلها مأخوذة من سمات العنوان. شريط الطين صندوق ثانٍ موضوع على بُعد 3 mm فوق أسفل الشريط الأسود.
الوصفة كاملة
// ═══ Postext Cookbook · Nº 096 · A humanities essay with MLA works cited ══════════
// https://postext.dev/en/cookbook/mla-humanities-essay
// Code: MIT · Text: original (CC BY 4.0) · Pictures: none
// Fonts: Spectral, Spectral SC (SIL OFL 1.1) · Needs postext ≥ 1.25.0
import {
buildDocumentWithFonts, 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 sample document ('en' | 'es')
const RECIPE = 'mla-humanities-essay';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: the black glaze and the red clay of an Attic vase
const palette = {
ink: '#1f1a17', glaze: '#231c19', clay: '#9a3d22', slip: '#e3a27e', rule: '#c9bdb0',
muted: '#6b6159', paper: '#fffdf9',
};
// Every colour is linked to its palette entry by id.
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = Object.entries({ ...palette, 'main-color': palette.clay })
.map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
// #endregion
const TEXT = 'Spectral', LABEL = 'Spectral SC';
const TRIM = { width: 150, height: 230 }; // a literary quarterly
const MARGIN = { top: 22, bottom: 22, inner: 19, outer: 21 };
const LEAD = 14.4; // pt
const at = (to, edge, x = 0, y = 0) => ({ anchor: { to, edge }, offset: { x: mm(x), y: mm(y) } });
// #region answer: MLA 9 author-page citations and a Works Cited list
// The text cites with [@keats-letters, 48] → (Keats, Letters 48): MLA prints the author
// and the page, and adds a short title when two works share an author. [-@eliot1932, 230]
// drops the name the sentence already gives → (230). The list is alphabetical, and a
// second work by the same author opens with a dash (MLA's ---) instead of the name.
registerCitationEngine(createCiteprocEngine({ styles: STYLES, locales: LOCALES }));
const citations = {
style: 'modern-language-association', // MLA 9th edition, author-page
link: true, // a citation jumps to its entry in Works Cited
bibliography: {
// MLA's half-inch hanging indent, scaled to a 108 mm measure.
fontSize: em(0.94), lineHeight: pt(13.4), hangingIndent: em(2.2), entrySpacing: pt(3),
},
};
// #endregion
// #region quotation: a block quotation, set in and upright
// More than four lines of prose go in a Markdown blockquote: in ink, indented, with no
يعمل ملف script.js المجمّع كما هو: الصقه في سكربت الوحدة (module) لأي صفحة، أو افتح الوصفة على CodePen. مجلد الوصفة على GitHub ↗ (يفتح في تبويب جديد)
تنويعات
#تابع القائمة بعد المقالة مباشرة
المجلة التي تنضّد قائمة Works Cited بعد الفقرة الأخيرة من غير صفحة جديدة تحذف الفاصل من نمط العنوان.
- headingStyles: [{ id: 'works-cited', breakBefore: { enabled: true, parity: 'any' } }],
+ headingStyles: [{ id: 'works-cited', breakBefore: { enabled: false } }],#استشهد بأسلوب Chicago بالمؤلف والسنة
المقالة نفسها بأسلوب Chicago تضع السنة بعد المؤلف، "(Brooks 1947, 165)"، وتتبعها القائمة.
- style: 'modern-language-association', // MLA 9th edition, author-page
+ style: 'chicago-author-date',أخطاء شائعة
- يطبع citeproc-js العناوين كما ترد في البيانات. يستعمل MLA الأحرف الكبيرة في أوائل كلمات العناوين الإنجليزية (title case)، فاكتبها كذلك في المراجع.
الحقوق
- الوصفة
- Ignacio Ferro
- النص
- Quotations from “Ode on a Grecian Urn” (1820) · John Keats · ملك عام
- Quotations from two letters of 1817, in Letters of John Keats to His Family and Friends, ed. Sidney Colvin (1925) · John Keats · ملك عام
- الخطوط
- Spectral (SIL OFL 1.1) · Spectral SC (SIL OFL 1.1)
- الشيفرة
- MIT، مثل Postext
حرّر هذا الشرح ↗ (يفتح في تبويب جديد)مجلد الوصفة على GitHub ↗ (يفتح في تبويب جديد)


