باختصار
مقال بحثي في الفيزياء من عمودين، فيه صيغ داخل النص وسبع معادلات مرقّمة. يبيّن كيف تنضّد الرياضيات بحيث تبقى حادة في ملف PDF.
ما الذي ستنضده
مقال بحثي من عدد سبتمبر لمجلة Measure، وهي مجلة متخيَّلة مفتوحة الوصول في الفيزياء التجريبية، منضّد على A4 في عمودين. في الأعلى شريط بلون أخضر القوارير عليه اسم المجلة، وصورة ستروبوسكوبية لبندول متأرجح، والعنوان. وتقع أسماء المؤلفين والتواريخ والترخيص على الأبيض تحت الشريط، ويمتد عبر العمودين ملخص بخلفية ملوّنة مع أربع شارات للكلمات المفتاحية. تليه ستة أقسام مرقّمة، فيها سبع معادلات مرقّمة و46 صيغة داخل السطر؛ تنضّدها MathJax مع التسميات داخل الأشكال. ويأتي الجدول 1 ونقاط الشكل 2 من مصفوفة قياسات واحدة. وفي الصفحة الأخيرة تتقاسم نهاية الاستنتاجات والملحقات الختامية والمراجع العمودين تحت الشكل 3، وينتهي العمودان على مستوى واحد. يحتفظ ملف PDF بكل صيغة خطوطًا خارجية متجهية، بلا خط رياضيات يحتاج إلى تضمين.
تجيب هذه الوصفة عن
- كيف أنضد الرياضيات (مضمّنة، ومعروضة، ومعادلات) وأبقيها متجهية في ملف PDF؟
- كيف أكتب الأرقام العلوية والسفلية والصيغ الكيميائية من دون محرّك الرياضيات الكامل؟
- كيف أرقّم العناوين (1، 1.1، 1.1.1) وأنسّق كل مستوى بطريقة مختلفة؟
- كيف أنضد قائمة مراجع أو مسردًا (مسافة بادئة معلّقة، حرف أصغر)؟
- كيف أضيف شكلًا بتعليق مرقّم وأحيل إليه في النص («انظر الشكل 3.2»)؟
الجواب المختصر
// initMathEngine comes from https://esm.sh/postext with every other symbol: MathJax ships
// inside the package. Import from one URL only, since two URLs load two engines.
await initMathEngine(); // gotcha: math-bundle. Unawaited, formulas paint as grey boxes
const math = { // on by default: $…$ inline, $$…$$ display, and \$ for a literal dollar sign
fontSizeScale: 1.07, // TeX's x-height is 0.442 em, STIX Two Text's 0.473 em: ×1.07
marginTop: pt(LEAD), // display maths: a line above, half a line below, and the grid snap
marginBottom: pt(LEAD / 2), // then rounds the space below up to the next baseline
};
// Equation numbers are written in the Markdown: $$T_0 = 2\pi\sqrt{\frac{L}{g}} \, . \tag{1}$$
// A numbered formula spans its column, the equation centred and its number flush right.
// Formulas are MathJax paths: renderToPdf writes them as vector outlines, with no maths font.
المكونات
- الميزات
- الرياضياتالعناوين المرقّمةصفحات افتتاح مصمَّمةإطارات بعرض الصفحةالشارات داخل السطراستشهادات تضع الأشكالفصول بلا أرقامأنماط العناوينشريط فصل بعرض الصفحةسمات العنوانتعليقات مرقّمةموضع الأشكالالنص المرتفع والمنخفضنمط التعليقنمط الجدولأنماط الفقراتالأشكال والجداول بوصفها مواردقوائم المراجع ومسارد المصطلحاتالتصدير إلى PDF
- تستخدم أيضًا
- إطارات التنبيه«شكل» و«جدول» بلغتكالترويسات بحسب دور الصفحةالخطوط المضمَّنة في PDFأنواع موارد مخصّصةترقيم روماني للصفحات التمهيديةفواصل الأسطر في العناوين
- الخطوط
- STIX Two Text, Schibsted Grotesk, Azeret Mono (SIL OFL 1.1)
- الأصول
- لا شيء: كل صورة مرسومة بالشيفرة
طريقة التحضير
#1 · شغّل MathJax ورقّم المعادلات
الشيفرة هي الجواب المختصر أعلاه. تنضّد MathJax الرياضيات، وهي تأتي داخل الحزمة: تُستورد initMathEngine من https://esm.sh/postext مع سائر الرموز، ويجب أن تعمل await initMathEngine() قبل البناء الأول، وإلا رُسمت كل صيغة مربعًا رماديًا. ومن بعدها تنضّد $…$ الصيغ داخل السطر و$$…$$ الصيغ المعروضة، وتكتب renderToPdf كل صيغة مسارات متجهية. ووضع \tag{1} في آخر الصيغة المعروضة يرقّمها: تأخذ الصيغة عرض عمودها، والمعادلة موسّطة ورقمها ملاصق لليمين على السطر نفسه. الأرقام هنا مكتوبة باليد، والنص يستشهد بها كما هي، «Eq. (6)».
#2 · ارسم كتلة العنوان من أسلوب عنوان
const text = (id, content, family, size, color, placement, extra) => ({ kind: 'text', id,
content, fontFamily: family, fontSize: pt(size), color: col(color), align: 'left',
overflow: 'wrap', placement, ...extra });
const at = (to, edge, x, y, width) => ({ anchor: { to, edge }, offset: { x: mm(x), y: mm(y) },
...(width && { size: { width: mm(width) } }) });
const caps = (size, fontWeight = 600) => ({ fontWeight, letterSpacing: pt(size * 0.18),
textTransform: 'uppercase' }); // tracked capitals: the band, the abstract, the back matter
const [RULE_Y, BAND, BYLINE] = [21, 130, 152]; // mm from the top: rule, band foot, byline foot
// The journal's furniture and running heads: checks.contentInConfig allows them (#849).
const JOURNAL = { subject: 'Journal of Experimental Physics', issue: 'Vol. 7 · No. 3 · 2026',
licence: 'Open access · CC BY 4.0', verso: 'Measure · Vol. 7 · 2026',
recto: 'Oyelaran et al. · Pendulum at large amplitudes',
cite: 'Measure 7, 213–216 (2026) · doi:10.5555/measure.7.3.213' };
const titleBlock = {
enabled: true,
minHeight: mm(BYLINE - TOP), // from the top margin down to the byline: the abstract follows
slot: { elements: [
{ kind: 'box', id: 'band', style: { backgroundColor: col('journal') },
placement: { anchor: { to: 'bleed', edge: 'top-left' },
size: { width: 'fill', height: mm(BAND) } } },
{ kind: 'image', id: 'swing', resourceId: 'strobe', // drawn in code, hung from the rule
placement: at('page', 'top-left', 54, RULE_Y, 136) },
text('journal', 'Measure', SANS, 17, 'paper', at('page', 'top-left', M, 11.2),
{ fontWeight: 700, overflow: 'clip' }),
text('subject', JOURNAL.subject, SANS, 7, 'mist',
at('#journal', 'right-of', 3, 2.2), { ...caps(7), overflow: 'clip' }),
text('issue', JOURNAL.issue, MONO, 7, 'mist', at('page', 'top-right', -M, 13.3),
{ align: 'right', overflow: 'clip' }),
{ kind: 'rule', id: 'hairline', thickness: pt(0.5), color: col('mist'),
placement: at('page', 'top-left', M, RULE_Y, MEASURE) },
text('kicker', '{attr.kicker}', SANS, 7.5, 'mist', at('page', 'top-left', M, BAND - 39, 110),
caps(7.5)), // 39 mm above the band's foot: room for itself and a two-line title
text('title', '{titleText}', SANS, 36, 'paper', at('#kicker', 'below', 0, 3, 170),
{ fontWeight: 700, lineHeight: 1.04 }), // broken where the heading line has its \\
// The author marks in the attribute are the characters ¹ and ², which the latin subset
// carries: a design text prints ^1^ as written unless it sets inlineMarks: true.
text('authors', '{attr.authors}', SANS, 11, 'ink', at('page', 'top-left', M, BAND + 7, 120),
{ fontWeight: 600 }),
text('affiliations', '{attr.affiliations}', SANS, 7.5, 'muted',
at('#authors', 'below', 0, 1.6, 120), { lineHeight: 1.35 }),
...[['Received {attr.received}', 'muted', 400], ['Accepted {attr.accepted}', 'muted', 400],
['Published {publishDate}', 'muted', 400], [JOURNAL.licence, 'journal', 600]]
.map(([content, color, fontWeight], i) => text(`d${i}`, content, MONO, 6.6, color,
at('page', 'top-right', -M, BAND + 7.6 + 3.4 * i), { align: 'right', fontWeight })),
] },
};
عنوان المقال عنوان من المستوى الأول (#)، فيتصدّر مخطط ملف PDF، والأقسام المرقّمة تحته. يستبدل أسلوب العنوان article العنوانَ بخانة من عناصر التصميم: شريط ينزف من الأعلى، واسم المجلة، والصورة الستروبوسكوبية، والعنوان مقطوعًا حيث يضع عنوان Markdown الرمز \\. تأتي أسماء المؤلفين وتاريخان من سمات العنوان، وتاريخ النشر من publishDate في البيانات التمهيدية. ويحجز minHeight مسافة 130 mm من الهامش العلوي إلى أسفل أسماء المؤلفين، ويبدأ الملخص تحت ذلك.
#3 · رقّم الأقسام، لا العنوان
// Each level has its own template, {2} for a section and {2}.{3} for a subsection, and its own
// type. Heads snap the text after them back onto the grid, so the two columns stay level.
const levels = [{ level: 1, breakBefore: { enabled: true, parity: 'any' } }, // the title: an
// article opens on the next page, recto or verso
{ level: 2, numberingTemplate: '{2}', fontSize: pt(11.5), lineHeight: pt(LEAD * 2),
marginTop: pt(LEAD), marginBottom: pt(0) }, // "1 Introduction", journal green
{ level: 3, numberingTemplate: '{2}.{3}', fontSize: pt(10), lineHeight: pt(LEAD),
fontWeight: 600, color: col('ink'), marginTop: pt(LEAD / 2), marginBottom: pt(0) }, // "2.1"
];
const headingStyles = [ // the article title and the back matter are headings, but uncounted
{ id: 'article', numbered: false, span: 'page', advancedDesign: titleBlock },
{ id: 'back', numbered: false, fontSize: pt(7.5), lineHeight: pt(9), ...caps(7.5, 700),
marginTop: pt(LEAD), marginBottom: pt(2) }, // tracked capitals, like the abstract's label
];
// The default "{h1}.{n}" prints Figure 1 here too, as an empty {h1} drops with its dot; "{n}"
// says outright that figures and tables count through the article. Tables caption above.
const resourceTypes = defaultResourceTypes(LANG).map((type) => ({ ...type,
numberingTemplate: '{n}', resetOn: 'never',
...(type.id === 'table' && { captionStyle: { position: 'above' } }) }));
لكل مستوى قالبه ونوعه: يرقّم {2} الأقسام الستة من 1 إلى 6 بحجم 11.5 pt بأخضر المجلة، ويرقّم {2}.{3} الأقسام الفرعية في Theory من 2.1 إلى 2.3 بحجم 10 pt بوزن شبه عريض بلون الحبر، ويُبقي numbered: false العنوان والملحقات الختامية خارج العدّ. يعيد كل عنوان النص الذي تحته إلى شبكة خطوط الأساس البالغة 12.6 pt، فتبقى أسطر العمودين على مستوى واحد عبر الفاصل بينهما. وتُعَدّ الأشكال والجداول على امتداد المقال كله عبر {n}. والقالب الافتراضي {h1}.{n} كان سيطبع الأرقام نفسها هنا، لأن العنوان غير المرقّم يترك {h1} فارغًا والعدّاد الفارغ يسقط مع نقطته، لكن {n} لا يعتمد على ذلك. ونوع الجدول ينقل تعليقه أيضًا فوق الجدول، حيث تضعه المجلات.
#4 · مدّ الملخص عبر العمودين
const calloutStyles = [{ id: 'abstract', title: 'Abstract', span: 'page',
background: col('tint'), marginTop: pt(0), marginBottom: pt(LEAD),
padding: { top: mm(4.2), right: mm(22), bottom: mm(4.2), left: mm(22) }, // ~90 characters
// The title takes the heading face; the body the text's face, ink and justification.
titleStyle: { fontSize: pt(7.5), ...caps(7.5, 700), color: col('journal'), gap: mm(1.6) },
body: { fontSize: pt(9.8), lineHeight: pt(13.2), firstLineIndent: pt(0) } }];
// Keyword chips never break, set ragged: a justified line of chips opens its spaces into gaps.
const keywords = { id: 'keywords', fontFamily: SANS, fontSize: pt(8), lineHeight: pt(14),
textAlign: 'left', firstLineIndent: pt(0), boldColor: col('journal') };
const chipStyles = [{ id: 'keyword', fontFamily: MONO, fontSize: em(0.88), color: col('journal'),
background: col('paper'), borderColor: col('rule'), // the border is 0.5 pt by default
borderRadius: pt(8), paddingX: em(0.55), paddingY: em(0.12), gap: em(0.45) }];
يمدّ إطار span: 'page' تحت كتلة العنوان الملخصَ على عرض الصفحة كاملًا، ويبدأ العمودان تحته. ويُبقي حشو 22 mm من كل جانب أسطره قرب 90 حرفًا. الكلمات المفتاحية شارات لا تنقسم بين سطرين أبدًا، تُسمّى كل منها عبر {style="keyword"}. ونمط فقرتها، keywords، غير مضبوط، لأن السطر المضبوط من الشارات يمطّ الفراغات بينها فجوات.
#5 · اختم بقائمة مراجع بإزاحة معلّقة
const paragraphStyles = [keywords,
{ id: 'references', fontSize: pt(8.2), lineHeight: pt(10.5), textAlign: 'left',
hangingIndent: mm(5), spaceBetween: pt(2.5) }, // ragged, so never hyphenated
{ id: 'colophon', fontFamily: SANS, fontSize: pt(7), lineHeight: pt(9.5), color: col('muted'),
textAlign: 'left', firstLineIndent: pt(0), spaceBetween: pt(3), marginTop: pt(LEAD) },
];
تطبّق كتلة :::paragraphs أسلوب الفقرة references على كل مدخل، ويُبقي hangingIndent البالغ 5 mm الرقمَ عند الهامش ويبدأ كل سطر تالٍ مزاحًا 5 mm. وتسوّي موازنة الأعمدة الشريط الأخير من المقال. في الصفحة 216 تتقاسم نهاية الاستنتاجات والملحقات الختامية والمراجع العمودين تحت الشكل 3. لا تستطيع الموازنة إلا إضافة مسافة، ولا ينقسم مرجع من سطرين، لذلك أُعيدت كتابة الملحقات الختامية أقصر بسطرين حتى انتهى العمودان على مستوى واحد.
#6 · احسب الجدول، وسمِّ الأشكال عبر MathJax
const [L, G] = [1.000, 9.812]; // the bench pendulum: length (m) and local gravity (m s^-2)
const T0 = 2 * Math.PI * Math.sqrt(L / G); // s: Eq. (1), 2.0059 s
const agm = (a, b) => [1, 2, 3].reduce(([x, y]) => [(x + y) / 2, Math.sqrt(x * y)], [a, b])[0];
const exact = (deg) => T0 / agm(1, Math.cos((deg * Math.PI) / 360)); // Eq. (6)
const runs = [[5, 2.0069], [10, 2.0096], [20, 2.0210], [30, 2.0412], [45, 2.0864],
[60, 2.1517], [75, 2.2458], [90, 2.3658]]; // amplitude (°), measured period (s): simulated
const fixed = (x, n, sign) => (sign && x >= 0 ? '+' : '') + x.toFixed(n).replace('-', '−');
const cell = (content) => ({ content, align: 'right' }); // headerRowCount marks row 0
const table = { headerRowCount: 1, columnWidths: [1.25, 1.35, 1, 1.1, 1.2], rows: [
['Amplitude', 'Measured', 'Eq. (6)', 'Over *T*~0~', 'Residual'],
...runs.map(([deg, T]) => [`${deg}°`, fixed(T, 4), fixed(exact(deg), 4),
`${fixed((exact(deg) / T0 - 1) * 100, 2)}%`, `${fixed((T / exact(deg) - 1) * 100, 3, 1)}%`]),
].map((row) => row.map(cell)) }; // *T*~0~ is plain markup: the header stays in its sans
// The figure labels are MathJax paths too: the same italic θ as the text, and vector in the PDF.
const R = (x) => Math.round(x * 100) / 100; // coordinates to 0.01 mm keep the SVG short
function tex(markup, x, y, size, anchor = 0, color = 'ink') { // anchor 0 left, .5 centre, 1 right
const r = renderMath(markup, false, 100); // paths in MathJax units: 1000 to the em
const k = size / 1000;
return `<g transform="translate(${R(x - anchor * r.viewBox.width * k)} ${R(y)}) scale(${k})" `
+ `fill="${palette[color]}">${r.paths.map((p) => `<path d="${p.d}"/>`).join('')}</g>`;
}
const PX_PER_MM = 10; // the drawings are in mm, declared to the engine at 10 px to the mm
const figure = (id, w, h, caption, altText, placement) => ({ id, typeId: 'figure', kind: 'svg',
svg: { fileId: `${id}.svg`, width: w * PX_PER_MM, height: h * PX_PER_MM }, caption, altText,
placement, createdAt: 0, updatedAt: 0 });
const resources = [ // each is placed where the text first cites it with :ref; sizes in mm
figure('strobe', 136, 70, '', 'A swinging pendulum, lit by flashes.'), // uncited: the band's
figure('geometry', 84, 60, 'The pendulum and its symbols: the length *L* from the pivot to '
+ 'the centre of the bob, the mass *m* and the amplitude, the angle between the vertical '
+ 'and either turning point of the swing.', // the caption face has no Greek: no θ here
'A bob on a rod hanging from a pivot, pulled aside by an angle.', { position: 'top' }),
{ id: 'runs', typeId: 'table', kind: 'table', table: { model: table }, createdAt: 0,
updatedAt: 0, caption: 'Measured and predicted periods of the one-metre pendulum, in seconds, '
+ 'and their excess and residual in per cent.',
note: 'Amplitudes to ±0.5°. The measurements are simulated for this example.' },
figure('period', 84, 60, 'The period against the amplitude, as a ratio to *T*~0~: Eq. (6) '
+ '(solid), the first two terms of Eq. (7) (dashed) and the measurements (dots).',
'The period grows with the amplitude, slowly, then fast; the measured points sit on the curve.'),
figure('phase', 176, 76, 'The phase plane of the pendulum: one orbit for each amplitude from '
+ '30° to 150° in steps of 30°, the 90° orbit of our widest runs in red, and the separatrix '
+ 'of a swing to 180° dashed.', 'Nested closed orbits growing into lemon shapes.',
{ position: 'top', span: 'page' }), // cited on page 3, it opens page 4 across both columns
];
تغذّي مصفوفة واحدة، runs، الجدول 1 ونقاط الشكل 2، والعمود المتوقَّع في الجدول هو المعادلة (6) محسوبة عند كل سعة. ويأخذ الجدول خطوط booktabs كما في المجلات، أي rules: 'booktabs' بالحبر: خط سميك فوقه وتحت صفه الأخير، وخط رفيع تحت صف الرأس، ولا خطوط عمودية. يستشهد النص بكل مورد عبر :ref{id="…" style="full"}، الذي يطبع “Figure 2” بالحبر العريض ويجعل المورد يطفو إلى أول موضع شاغر بعد الاستشهاد. تستعمل التعليقات وخلايا الجداول الترميز العادي ~sub~ و^sup^ (*T*~0~)، فيبقى في خطها غير المذيّل، والرموز في النص الجاري تُكتب $T_0$. وتسميات الأشكال رياضيات أيضًا: تستدعي tex() الدالة renderMath لكل تسمية وتكتب الخطوط الخارجية في SVG مسارات. والرمز θ₀ في الشكل 1 هو الحرف الذي تستعمله الصيغ، ويبقى متجهيًا في ملف PDF.
الوصفة كاملة
// ═══ Postext Cookbook · Nº 002 · Two-column paper with numbered equations ══════════
// https://postext.dev/en/cookbook/journal-article-with-maths
// Code: MIT · Text: original (CC BY 4.0) · Figures: generated in code (CC BY 4.0)
// Fonts: STIX Two Text, Schibsted Grotesk, Azeret Mono (SIL OFL 1.1) · Needs postext ≥ 1.34.0
// A research article in a fictional physics journal: a title block across the page, numbered
// sections, MathJax formulas in the text and in the figures, a table computed from the data.
import {
buildDocumentWithFonts, renderPageToCanvas, registerResourceImage, defaultResourceTypes,
initMathEngine, renderMath,
} from 'https://esm.sh/postext';
import { renderToPdf, decompressWoff2 } from 'https://esm.sh/postext-pdf';
const LANG = 'en'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'journal-article-with-maths';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
const palette = {
ink: '#141a1f', journal: '#0f4d3f', // text; the journal's green: band, heads, labels
mist: '#b9d9cc', series: '#c8442a', // type on the band; data: measurements, the red bob
tint: '#ecf3ef', rule: '#bcc9c3', // the abstract box; hairlines
muted: '#58625d', paper: '#ffffff', // running heads, affiliations, notes; white
};
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = [ // the defaults link to 'main-color': point it at the journal green
...Object.entries(palette).map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } })),
{ id: 'main-color', name: 'journal (defaults)', value: { hex: palette.journal, model: 'hex' } },
];
// A serif for the text around the formulas, a grotesque for heads and labels, a mono for metadata.
const [SERIF, SANS, MONO] = ['STIX Two Text', 'Schibsted Grotesk', 'Azeret Mono'];
const [BODY, LEAD] = [9.5, 12.6]; // pt: body size and leading, the grid both columns share
// mm: the A4 trim, the head, foot and side margins, and the gutter between the two columns
const [TRIM_W, TRIM_H, TOP, BOTTOM, M, GUTTER] = [210, 297, 22, 22, 17, 6];
const MEASURE = TRIM_W - 2 * M; // mm: the text width, which the band's type and rules align to
// #region answer: maths from a CDN: MathJax awaited before the build, equations numbered by \tag
// initMathEngine comes from https://esm.sh/postext with every other symbol: MathJax ships
// inside the package. Import from one URL only, since two URLs load two engines.
await initMathEngine(); // gotcha: math-bundle. Unawaited, formulas paint as grey boxes
const math = { // on by default: $…$ inline, $$…$$ display, and \$ for a literal dollar sign
fontSizeScale: 1.07, // TeX's x-height is 0.442 em, STIX Two Text's 0.473 em: ×1.07
marginTop: pt(LEAD), // display maths: a line above, half a line below, and the grid snap
marginBottom: pt(LEAD / 2), // then rounds the space below up to the next baseline
};
// Equation numbers are written in the Markdown: $$T_0 = 2\pi\sqrt{\frac{L}{g}} \, . \tag{1}$$
// A numbered formula spans its column, the equation centred and its number flush right.
// Formulas are MathJax paths: renderToPdf writes them as vector outlines, with no maths font.
// #endregion
يعمل ملف script.js المجمّع كما هو: الصقه في سكربت الوحدة (module) لأي صفحة، أو افتح الوصفة على CodePen. مجلد الوصفة على GitHub ↗ (يفتح في تبويب جديد)
تنويعات
#رقّم الأشكال داخل الأقسام
تَعُدّ البحوث الطويلة الأشكال لكل قسم؛ وهذا يطبع Figure 1.1 في المقدمة وTable 4.1 في النتائج.
- numberingTemplate: '{n}', resetOn: 'never',
+ numberingTemplate: '{h2}.{n}', resetOn: 'h2',#دع المحرّك يرقّم المعادلات
بوضع \label مكان كل \tag تُرقَّم المعادلات بترتيب القراءة، فإذا أُضيفت معادلة في الوسط أُعيد ترقيم ما بعدها، وتطبع \eqref{eq:small} في النص (1). وتخرج الصفحات كما هي.
-$$T_0 = 2\pi\sqrt{\frac{L}{g}} \, . \tag{1}$$
+$$T_0 = 2\pi\sqrt{\frac{L}{g}} \, . \label{eq:small}$$أخطاء شائعة
خطأ شائع
الرياضيات تحتاج إلى await initMathEngine() قبل البناء الأول
الصيغ التي تُنضَّد قبل أن يعمل محرّك الرياضيات مربعات رمادية نائبة. استورد initMathEngine من https://esm.sh/postext مع سائر الرموز وانتظرها بـ await قبل البناء الأول؛ والمستند الذي فيه رياضيات ويُبنى من دونها يطبع تحذيرًا واحدًا في وحدة التحكم. ومنذ postext 1.5 يأتي MathJax داخل حزمة postext وحدةً واحدة تجلبها initMathEngine، فالاستيراد العادي يعمل من CDN ولا حاجة إلى ?bundle (حتى 1.4 كان يجب أن يأتي كل رمز من https://esm.sh/postext?bundle). استورد من عنوان URL واحد فقط: عنوانان يحمّلان محرّكين. الرياضيات →
خطأ شائع
علامة $ المجرّدة تفتح الرياضيات: اكتب \$
علامة الدولار تفتح رياضيات داخل السطر، فسعرٌ مثل $40 يبدأ صيغة. اكتب \$40. الهروب والمحارف الحرفية →
فحص Sandbox · invalidMath
صيغة LaTeX غير صالحة
السبب. لم يتمكن MathJax من تحليل صيغة، فطُبع بدلها عنصر نائب أحمر.
الحل. صحّح شيفرة TeX، أو اكتب \$ مكان علامة دولار لم تُقصد بها الرياضيات. التوثيق →
تحذير Markdown · unclosedMath
محدِّد صيغة رياضية غير مغلق
السبب. علامة $ تفتح صيغة داخل السطر لا تُغلق أبدًا، وعادةً لأنها جزء من سعر.
الحل. اكتب \$ لعلامة دولار حرفية، أو أغلق الصيغة في السطر نفسه. التوثيق →
- النص المكتوب بعد سطر فارغ تحت صيغة العرض فقرة جديدة، وتُزاح بدايتها، لذلك تبدأ كل واحدة هنا جملةً مستقلة («Here L is…»). ولكتابة «where…» على طريقة LaTeX، اكتب النص تحت
$$الختامية مباشرة: يكمل الفقرة ويُنضَّد بلا إزاحة. - الترميز العادي
~0~يُنزل رقمه ثلث em، تحت النوازل، و^2^بعده يتبع الرمز ₀ بدل أن يقف فوقه. في النص الجاري اكتب$T_0$و$T_0^2$، واحتفظ بالترميز العادي للتعليقات وخلايا الجداول، حيث يبقى في خط التسميات. - تحقّق من أن خط التسميات يتضمّن ¹ و² و±، والحروف اليونانية إن احتاج إليها تعليق. فخط Instrument Sans، الذي جُرّب أولًا، لا يتضمّن أيًّا من الثلاثة في ملفات Fontsource الخاصة به، وخط Schibsted Grotesk لا يتضمّن الحروف اليونانية، لذلك يذكر تعليق الشكل 1 السعة بالكلمات بدل θ₀.
الحقوق
- الوصفة
- Ignacio Ferro
- النص
- نص أصلي, CC BY 4.0
- الخطوط
- STIX Two Text (SIL OFL 1.1) · Schibsted Grotesk (SIL OFL 1.1) · Azeret Mono (SIL OFL 1.1)
- الشيفرة
- MIT، مثل Postext
حرّر هذا الشرح ↗ (يفتح في تبويب جديد)مجلد الوصفة على GitHub ↗ (يفتح في تبويب جديد)


