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

دليل الوصفات · الفصل 7 · الأشكال والصور

أشكال تطفو إلى حيث تستشهد بها

فصل بعمودين فيه سبعة أشكال مرقّمة: ستة تطفو من أول :ref لها إلى أول موضع يسمح به موضعها، وواحد يقف حيث يضعه ::resource.

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

ص 28–29 · 2–3 من 4

  • نموذج باللغة الإسبانية: لا توجد طبعة عربية بعد
  • مقاس القص 200 × 250 مم
  • عمودان, فاصل 6 مم بين الأعمدة
  • Faustina 9.4/13.4
  • IBM Plex Sans Condensed
  • Montserrat
  • 4 صفحات
  • المستوى
  • Postext 1.65.0
  • أُخرجت في 172 ms
  • أسطر الشيفرة: 224

باختصار

فصل من كتاب مدرسي عن الجبال، بعمودين وسبع صور مرقّمة. يبيّن كيف تنتقل كل صورة إلى أول مكان شاغر بعد أن يذكرها النص أول مرة.

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

الفصل الثاني من Mountain Landforms، كتاب مدرسي في علم أشكال سطح الأرض على صفحة بقياس 200 × 250 مم. يتدلى شريط أزرق عليه رقم الفصل من رأس صفحة الافتتاح بجوار لوح العنوان الأزرق الجليدي؛ ويليه عمودان مضبوطان بخط Faustina. الأشكال السبعة، لوحات مولّدة بنماذج الانتشار وعليها تسميات بالشيفرة، مرقّمة بترتيب أول ذكر لها. ستة منها تطفو إلى أول موضع شاغر يسمح به موضعها، عدًّا من الفقرة التي تستشهد بها أول مرة. الشكل 2.1، auto، يقع في أسفل صفحة الافتتاح؛ و2.3 يفتتح العمود الأيمن من الصفحة 28 و2.2 يملأ أسفل تلك الصفحة؛ و2.4 و2.5 يفتتحان عمودي الصفحة 29. ويُنضَّد الشكل 2.6 حيث يضمّنه النص. أما الشكل 2.7، عنصر عائم top مستشهَد به في الصفحة 30، فكان سينتظر الصفحة 31، لكن العنصر العائم لا يغادر فصله، فيذهب إلى أسفل الصفحة 30.

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

  • كيف أضيف شكلًا بتعليق مرقّم وأحيل إليه في النص («انظر الشكل 3.2»)؟
  • كيف أتحكم في موضع الشكل: أعلى الصفحة، أو بعرض العمودين، أو هنا تمامًا، أو في الهامش؟
  • كيف أحصل على تسميتي «شكل» و«جدول» بلغة مستندي؟
  • كيف أضيف صورًا وجداول من الشيفرة (موارد) بدل ![]() في Markdown؟

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

script.js · الأسطر 252–285في الشيفرة الكاملة
// In the Markdown, :ref{id="valleys" case="lower"} prints 'fig. 2.1' and places Figure 2.1.
// Captions, credits and alt texts come from content.figures.<lang>.md.
const figure = (id, height, placement) => {
  if (!TEXTS[id]) throw new Error(`content.figures has no caption block for "${id}"`);
  const [caption, note, altText] = TEXTS[id];
  // An SVG fills the width of its slot (a column or the text block, or a fraction of
  // either), so its width and height only give its shape.
  const width = (placement.span === 'page' ? MEASURE : COLUMN) * (placement.width ?? 1);
  return { id, typeId: 'figure', kind: 'svg', caption, note, altText,
    svg: { fileId: `${id}.svg`, width, height }, placement, createdAt: 0, updatedAt: 0 };
};
// In any order: the first mention of each one in the text, a :ref or a ::resource line,
// decides its number.
const resources = [
  // Cited on the opener page: 'auto' may take that page's foot band, where 'top'
  // could only open the next page (gotcha: top-float-next-page).
  figure('valleys', 56, { position: 'auto', span: 'page' }),
  // Across both columns, but only in a foot band: the page it is cited on, if both
  // columns still have room there, else the foot of the next page.
  figure('profile', 60, { position: 'bottom', span: 'page' }),
  // A column figure that takes only a column head: the next one still empty after its
  // citation, here the right column of the same page, above the text that follows it.
  figure('cirque', 48, { position: 'top' }),
  // Cited in the same sentence, the two take the next two column heads, side by side.
  figure('abrasion', 48, { position: 'top' }),
  figure('plucking', 48, { position: 'top' }),
  // No float: set exactly where ::resource{id="roche"} stands, with the same gap above it
  // and below it.
  figure('roche', 42, { position: 'here' }),
  // A band of its own, half the text width and centred. It is cited on the chapter's last
  // page, where a 'top' float would wait for the next page; a float cannot leave its
  // chapter, so this one goes to the foot of the last page.
  figure('moraines', 50, { position: 'top', span: 'page', width: 0.5, align: 'center' }),
];

المكونات

تستخدم أيضًا
أنماط الفقرات
الخطوط
Faustina, Montserrat, IBM Plex Sans Condensed (SIL OFL 1.1)
الأصول
  • abrasion-1080.jpg
  • cirque-1080.jpg
  • moraines-1080.jpg
  • plucking-1080.jpg
  • profile-1400.jpg
  • roche-1080.jpg
  • valleys-1536.jpg
  • Figure 2.1: a V-shaped river valley and a U-shaped glacial valley (Generated With Diffusion Models, أصلي)
  • Figure 2.2: long profile of a valley glacier (Generated With Diffusion Models, أصلي)
  • Figure 2.3: a glacial cirque in section (Generated With Diffusion Models, أصلي)
  • Figure 2.4: abrasion at the base of the ice (Generated With Diffusion Models, أصلي)
  • Figure 2.5: plucking on a rock step (Generated With Diffusion Models, أصلي)
  • Figure 2.6: a roche moutonnée (Generated With Diffusion Models, أصلي)
  • Figure 2.7: lateral, medial and terminal moraines in plan (Generated With Diffusion Models, أصلي)

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

#1 · لوحة ألوان واحدة للصفحات والأشكال

script.js · الأسطر 19–36في الشيفرة الكاملة
const palette = {
  ink: '#1b2227', // text: a cold near-black
  glacier: '#34729a', // the accent: kicker, ribbon, caption labels, references, folios, water
  ice: '#e3f1f8', // the opener slab
  rock: '#5b5a57', // bedrock in the drawings
  moss: '#7d8f4e', // valley floors and pines
  rule: '#c6d3db', // the hairline under the running heads
  muted: '#5d6a72', // running heads, credit notes, the colophon
  paper: '#ffffff',
};
// A linked colour carries its hex and the palette entry it follows.
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = [
  ...Object.entries(palette).map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } })),
  // The engine's defaults link to 'main-color' (#295aa3): pointing it at the accent keeps
  // that second blue off the page.
  { id: 'main-color', name: 'glacier (defaults)', value: { hex: palette.glacier, model: 'hex' } },
];

كل لون في الإعداد مربوط بأحد هذه المداخل، وقد وُلّدت اللوحات بالرمادي الأردوازي والأزرق الجليدي والطحلبي نفسها، فتجلس الأشكال في ألوان الصفحة. لكن اللوحة تحتفظ بألوانها: قيمة جديدة لـglacier تغيّر الشريط واللوح والتسميات، لا الجليد في الأشكال. واللون المميِّز داكن بما يكفي للحروف الصغيرة: 5.2:1 على الأبيض لتسميات التعليقات والاستشهادات، و4.5:1 على لوح الجليد للعنوان التمهيدي. كل شكل ملف SVG يضمّن لوحته عنوان بيانات JPEG وينضّد تسمياته فوقها نصًّا بهالة بيضاء رفيعة، فتبقى حادة وتتبع لغة الطبعة. والتسميات تحدّد خط IBM Plex Sans Condensed في ملف SVG نفسه، ودالة loadSvg في العُدّة تضمّن الوزنين اللذين تستعملهما عبر inlineSvgFonts في المحرّك، لأن ملف SVG المعروض صورةً لا يصل وحده إلى خطوط الصفحة.

#2 · سمِّ الأشكال بلغة القارئ

script.js · الأسطر 47–56في الشيفرة الكاملة
const captions = () => ({
  // The built-in types take their names from the locale: 'Figure 2.3' and 'fig. 2.3' with
  // 'en-us', 'Figura 2.3' with 'es', numbered {h1}.{n} per chapter. It sets hyphenation too.
  locale: t({ en: 'en-us', es: 'es' }),
  captionStyle: { // the text colour follows bodyText; the note is 0.85 × the caption size
    fontFamily: LABEL, fontSize: pt(8.3), gap: mm(2.2),
    labelColor: col('glacier'), descriptionItalic: true, // the label is bold by default
    note: { color: col('muted'), gap: mm(0.6) }, // the credit line
  },
});

يسمّي locale الأنواع المضمَّنة بلغة المستند: فالتعليقات تقرأ Figure 2.3 هنا وFigura 2.3 في الطبعة الإسبانية، حيث يختار 'es' نفسه أنماط تقسيم الكلمات الإسبانية. ثم يأخذ كل استشهاد الصيغة التي تحتاجها جملته: case="lower" لـ*(fig. 2.1)، ومع style="full" لـ(figure 2.2)*؛ وstyle="number" بعد صيغة الجمع (figures 2.4 and 2.5)؛ وtext="…" لعبارة مثل the chapter’s first figure، التي لا تطبع رقمًا. تلك العبارة تحيل إلى شكل وُضع من قبل؛ ولو كانت أول ذكر له لظلت ترقّمه وتضعه.

#3 · شريط ولوح من جليد لصفحة الافتتاح

script.js · الأسطر 60–110في الشيفرة الكاملة
const at = (to, edge, x, y, width, height) => ({ anchor: { to, edge },
  offset: { x: mm(x), y: mm(y) },
  ...(width && { size: { width: mm(width), height: height ? mm(height) : 'auto' } }) });
const text = (id, content, family, size, color, placement, extra) => ({ kind: 'text', id,
  content, fontFamily: family, fontSize: pt(size), color: col(color), placement,
  align: 'left', ...extra });
const caps = (size) => ({ fontWeight: 600, textTransform: 'uppercase',
  letterSpacing: pt(size * 0.18) }); // capitals tracked 0.18 em
const [SLAB, RIBBON, RIBBON_END] = [64, 30, 70]; // mm: slab height; ribbon width and length
const [TEXT_X, KICKER_Y] = [RIBBON + 8, 10]; // mm: the opener texts start 8 mm right of the ribbon
const [TITLE_W, LEAD_W] = [118, 112]; // mm: the title's measure, and a shorter standfirst
const opener = {
  enabled: true,
  // At least 5 mm under the slab; the reserve then rounds up to whole 13.4 pt grid lines,
  // so here 69 mm becomes 15 lines (70.9 mm) and the text starts about 7 mm under the slab.
  minHeight: mm(SLAB + 5),
  slot: { elements: [
    { kind: 'box', id: 'slab', style: { backgroundColor: col('ice') }, // runs off the fore-edge
      placement: at('container', 'top-left', 0, 0, MEASURE + OUTER, SLAB) },
    { kind: 'box', id: 'ribbon', style: { backgroundColor: col('glacier') }, // hangs from the head
      placement: at('page', 'top-left', INNER, 0, RIBBON, RIBBON_END) },
    text('numeral', '{chapterNumber}', DISPLAY, 80, 'paper', // an 80 pt line box is 28 mm tall:
      at('page', 'top-left', INNER, RIBBON_END - 31, RIBBON), // it ends 3 mm above the foot
      { fontWeight: 800, lineHeight: 1, align: 'center' }),
    text('kicker', t({ en: 'Chapter {chapterNumber} · {attr.topic}',
      es: 'Capítulo {chapterNumber} · {attr.topic}' }), LABEL, 8.5, 'glacier',
    at('container', 'top-left', TEXT_X, KICKER_Y), caps(8.5)),
    text('title', '{titleText}', DISPLAY, 27, 'ink', at('#kicker', 'below', 0, 2.6, TITLE_W),
      { fontWeight: 800, lineHeight: 1.06 }),
    text('lead', '{attr.lead}', TEXT, 10.6, 'ink', at('#title', 'below', 0, 4.2, LEAD_W),
      { italic: true, lineHeight: 1.38, hyphenate: true }),
  ] },
};
const HAIRLINE = TOP - 5; // mm from the top edge: the rule under the running heads
const HEAD_Y = HAIRLINE - 4.4; // the running heads' line box, 4.4 mm above the hairline
const head = (id, content, parity, edge, x, extra) => text(id, content, LABEL, 7.6, 'muted',
  at('page', edge, x, HEAD_Y), { ...caps(7.6), parity, pages: 'body', ...extra });
const folio = (id, parity, edge, x, extra) => text(id, '{pageNumber}', DISPLAY, 8.5, 'glacier',
  at('page', edge, x, HEAD_Y), { fontWeight: 800, parity, pages: 'body', ...extra });
const header = { elements: [ // outer corners, over a hairline; never on the opener
  folio('verso-folio', 'even', 'top-left', OUTER),
  head('verso-title', '{title}', 'even', 'top-left', OUTER + 8),
  head('recto-title', '{chapterTitle}', 'odd', 'top-right', -(OUTER + 8), { align: 'right' }),
  folio('recto-folio', 'odd', 'top-right', -OUTER, { align: 'right' }),
  { kind: 'rule', id: 'hairline', pages: 'body', direction: 'horizontal', color: col('rule'),
    thickness: pt(0.5), placement: { ...at('container', 'top-left', 0, HAIRLINE),
      size: { width: 'fill', height: 'auto' } } },
] };
const footer = { elements: [ // the drop folio: on the opener only, centred 9 mm under the text
  text('drop-folio', '{pageNumber}', DISPLAY, 8.5, 'glacier', at('container', 'top', 0, 9),
    { fontWeight: 800, align: 'center', pages: 'opener' })] };

صفحة الافتتاح إطاران وأربعة نصوص: شريط يتدلى من الرأس وفي أسفله رقم الفصل، ولوح جليد يمتد إلى ما وراء الحافة الخارجية، والعنوان التمهيدي من السمة topic للعنوان، ثم العنوان والمقدمة متسلسلين تحته. يحجز minHeight اللوح و5 مم على الأقل تحته، مقرّبةً صعودًا إلى أسطر شبكة كاملة (نحو 7 مم هنا)، فيظل الشكل 2.1 يتسع في الشريط السفلي من الصفحة نفسها. وتجلس الترويسات في الزوايا الخارجية فوق خط رفيع بلون rule، ويُبعدها pages: 'body' عن صفحة الافتتاح، التي تأخذ بدلًا منها رقم صفحة في الذيل.

#4 · توقّف عند معرّف مجهول أو شكل غير مستشهَد به

script.js · الأسطر 289–310في الشيفرة الكاملة
// The build lists every :ref and ::resource to an id no resource has in doc.contentWarnings
// (kind 'unknownResourceId'); each prints '?' on the page. A figure nobody names is never
// placed and raises no warning, so the pen reads the mentions with the engine's own parser;
// an embed needs double quotes (gotcha: resource-double-quotes).
function checkFigures(doc) {
  const [named, embedded] = [new Set(), new Set()];
  for (const block of parseMarkdown(markdown)) {
    if (block.type === 'resourceBlock' && block.resourceId) {
      named.add(block.resourceId);
      embedded.add(block.resourceId);
    }
    for (const span of block.spans) if (span.ref?.resourceId) named.add(span.ref.resourceId);
  }
  const unknown = (doc.contentWarnings ?? []).filter((w) => w.kind === 'unknownResourceId');
  const problems = [
    ...new Set(unknown.map((w) => `unknown id "${w.resourceId}"`)),
    ...resources.filter((r) => !named.has(r.id)).map((r) => `"${r.id}" is never cited`),
    ...resources.filter((r) => r.placement.position === 'here' && !embedded.has(r.id))
      .map((r) => `"${r.id}" is placed 'here' but no ::resource line embeds it`),
  ];
  if (problems.length) throw new Error(`Figures: ${problems.join('; ')}`);
}

يطبع :ref أو ::resource إلى معرّف ليس لأي مورد علامة «?» ولا يضع شيئًا؛ ويسجّل البناء كل واحد منها في doc.contentWarnings بالنوع unknownResourceId، مع المعرّف وموضعه في النص المصدر. أما الشكل الذي لا يذكره أحد فلا يوضع أبدًا ولا يصدر عنه تحذير، لذلك يقرأ الفحص Markdown بـparseMarkdown، محلّل المحرّك نفسه، ويقابل مواضع الذكر بالأشكال. فيتحوّل المعرّف المجهول، والشكل غير المستشهَد به، والشكل here الذي بلا سطر ::resource، إلى خطأ واحد قبل عرض الصفحات.

#5 · ابدأ العدّ من حيث وصل الكتاب

script.js · الأسطر 417–429في الشيفرة الكاملة
for (const { id, svg: { fileId, width, height } } of resources) { // each under its svg.fileId
  const art = await dataUrl(PAINTINGS[id]);
  await loadSvg(fileId, svg(width, height, `<image href="${art}" width="${n2(width)}" `
    + `height="${n2(height)}" preserveAspectRatio="none"/>${DRAWINGS[id](width, height)}`));
}
// One chapter came before: figures number 2.1, 2.2… and the folios start at 27.
const continuation = { pageNumbering: { startAt: 27 }, // odd, to match the recto of page 1
  headings: { h1: 1, h2: 0, h3: 0, h4: 0, h5: 0, h6: 0 } }; // the next # is chapter 2
const doc = await buildDocumentWithFonts({ markdown, resources, continuation }, config(),
  { ...kitFonts(FONTS), text: words });
checkFigures(doc); // a wrong id stops here, and the viewer's bar says why
showPages(doc, { title: t({ en: 'Figures that float to where you cite them',
  es: 'Figuras que flotan hasta donde las citas' }) });

هذا هو الفصل الثاني من كتاب أطول، فيسجّل الاستمرار فصلًا واحدًا قبله: الأشكال المرقّمة {h1}.{n} تبدأ من 2.1، وأرقام الصفحات من 27. في الصفحة 28 يقف الشكل 2.3 فوق الشكل 2.2، الذي له الرقم الأصغر لأن النص يستشهد به أولًا. وعلامة ![]() في Markdown تُحذف، فكل شكل مورد يُسجَّل ملف SVG الخاص به تحت svg.fileId الخاص به قبل البناء. وكل موضع ينتج عن مكان الاستشهاد بالشكل: auto للشكل 2.1، لأن اللوح يملأ رأس صفحة الافتتاح؛ وbottom للمقطع الطولي، الذي ما زال يستطيع أخذ أسفل الصفحة التي تستشهد به؛ وtop لأشكال الأعمدة، التي تفتتح رؤوس الأعمدة الشاغرة التالية؛ وtop للشكل 2.7 أيضًا، الذي ينتهي في أسفل الصفحة 30 لأن العنصر العائم يبقى داخل فصله.

الوصفة كاملة

Sandbox
// ═══ Postext Cookbook · Nº 009 · Figures that float to where you cite them ═════════
// https://postext.dev/en/cookbook/figures-float-where-cited
// Code: MIT · Text: original (CC BY 4.0) · Figures: diffusion models, labels in code
// Fonts: Faustina, Montserrat, IBM Plex Sans Condensed (SIL OFL 1.1) · Needs postext ≥ 1.25.0
//
// Chapter 2 of a geomorphology textbook. Six of its seven figures float, each to the first
// free slot its placement allows, counting from the paragraph that first cites it. Figure 2.6
// is set where ::resource embeds it. The figures are numbered in order of first mention.
import {
  buildDocumentWithFonts, prepareFonts, renderPageToCanvas, registerResourceImage,
  inlineSvgFonts, parseMarkdown,
} from 'https://esm.sh/postext';

const LANG = 'es'; // @lang: the language of the sample document ('es' | 'en')
const RECIPE = 'figures-float-where-cited';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: eight named colours; the paintings were made to match them
const palette = {
  ink: '#1b2227', // text: a cold near-black
  glacier: '#34729a', // the accent: kicker, ribbon, caption labels, references, folios, water
  ice: '#e3f1f8', // the opener slab
  rock: '#5b5a57', // bedrock in the drawings
  moss: '#7d8f4e', // valley floors and pines
  rule: '#c6d3db', // the hairline under the running heads
  muted: '#5d6a72', // running heads, credit notes, the colophon
  paper: '#ffffff',
};
// A linked colour carries its hex and the palette entry it follows.
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = [
  ...Object.entries(palette).map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } })),
  // The engine's defaults link to 'main-color' (#295aa3): pointing it at the accent keeps
  // that second blue off the page.
  { id: 'main-color', name: 'glacier (defaults)', value: { hex: palette.glacier, model: 'hex' } },
];
// #endregion
const TEXT = 'Faustina'; // one family each for text, display and labels
const DISPLAY = 'Montserrat';
const LABEL = 'IBM Plex Sans Condensed';
const LEAD = 13.4; // body leading in pt: the grid every float band snaps to
const [PAGE_W, PAGE_H, TOP, BOTTOM, INNER, OUTER, GUTTER] = [200, 250, 22, 20, 18, 14, 6]; // mm
const MEASURE = PAGE_W - INNER - OUTER; // 168 mm: the text block, and a page-wide figure
const COLUMN = (MEASURE - GUTTER) / 2; // 81 mm: a column, and a column figure

// #region captions: the type name in the document's language; bold label, italic description
const captions = () => ({
  // The built-in types take their names from the locale: 'Figure 2.3' and 'fig. 2.3' with

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

تنويعات

#رقّم الأشكال بلا رقم الفصل

احذف الفصل من الأرقام فتُطبع الأشكال من 1 إلى 7؛ ولعدٍّ واحد عبر كتاب كامل، أخرج الفصول بـbuildBundle أو مرّر إلى كل فصل continuationAfter() الخاص بالفصل الذي قبله.

-  inlineSvgFonts, parseMarkdown,
+  inlineSvgFonts, parseMarkdown, defaultResourceTypes,
@@
   locale: t({ en: 'en-us', es: 'es' }),
+  resourceTypes: defaultResourceTypes(LANG).map((type) => ({ ...type,
+    numberingTemplate: '{n}', resetOn: 'never' })),

#ضع التعليقات فوق الشكل على شريط

ينتقل التعليق فوق الشكل إلى شريط بالأزرق الجليدي من لوحة الألوان، ويبقى سطر المصدر تحت الشكل؛ أعد ضبط النص، لأن الطبعتين كلتيهما تمتدان عندئذٍ إلى صفحة خامسة.

   captionStyle: { // the text colour follows bodyText; the note is 0.85 × the caption size
+    position: 'above', backgroundEnabled: true, background: col('ice'),
     fontFamily: LABEL, fontSize: pt(8.3), gap: mm(2.2),

#ضع شكلًا في الهامش

صفحة العمود والنصف تخصّص للأشكال وتعليقاتها قناة خارجية لا يدخلها النص أبدًا: انظر الكتاب المدرسي بعمود في الهامش.

#عوّم الجداول بالطريقة نفسها

الجداول موارد أيضًا، يُستشهد بها وتوضع بالقواعد نفسها، والطويل منها ينقسم عبر الصفحات: انظر نشرة المواصفات الفنية.

أخطاء شائعة

خطأ شائع

العنصر العائم 'top' يذهب إلى الصفحة التالية لإحالته ما لم يُسمح له بتصدر صفحة الإحالة

افتراضيًا لا يصعد العنصر العائم أبدًا فوق الإحالة إليه، فالعنصر العائم 'top' الممتد بعرض الصفحة والمُحال إليه في الصفحة N يفتتح الصفحة N+1. اضبط placement.citingPage: true على المورد أو على defaultPlacement لنوعه (أو layout.floatsAtCitingPage للكتاب كله، منذ postext 1.25) فيتصدر الصفحة N بدلًا من ذلك، وينزل النص الذي فوق الإحالة تحته، إذا اتسع له المكان في حدود layout.maxTopFraction وبقي سطر الإحالة في تلك الصفحة. ولا يتصدر أبدًا الصفحة الأولى من فصل ولا صفحة بعد فاصل قسري: فهناك يظل يفتتح الصفحة التالية، ويمكن للموضع 'auto' أو 'bottom' أن يشغل أسفل صفحة الإحالة. موضع الأشكال →

خطأ شائع

::resource{id="…"} لا يقبل إلا علامتي الاقتباس المزدوجتين

لا يُتعرَّف على التضمين الكتلي إلا بالصيغة ::resource{id="…"} بعلامتي اقتباس مزدوجتين؛ وأي صيغة أخرى تبقى في النص سطرًا ظاهرًا. أشكال في هذا الموضع بالضبط →

خطأ شائع

لا <marker> ولا مرشِّحات في رسوم SVG (وإلا البديل النقطي)

لا يبقى شكل SVG متّجهيًا في PDF إلا إذا خلا من <marker> والمرشِّحات والأقنعة؛ وإلا عاد إلى صورة نقطية، والمرشِّحات المتداخلة بعمق قد تجعله فارغًا في Chrome. ارسم رؤوس الأسهم مسارات. الأشكال والجداول بوصفها موارد →

فحص Sandbox · unknownResourceId

مورد غير معروف

السبب. :ref أو ::resource يذكر معرّفًا لا يملكه أي مورد؛ فتطبع الإحالة "?" ولا يوضع شيء.

الحل. صحّح المعرّف (بعلامات اقتباس مزدوجة فقط) أو أضف المورد. التوثيق →

الحقوق

الوصفة
Ignacio Ferro
النص
نص أصلي, CC BY 4.0
الصور
  • Figure 2.1: a V-shaped river valley and a U-shaped glacial valley · Generated With Diffusion Models · أصلي
  • Figure 2.2: long profile of a valley glacier · Generated With Diffusion Models · أصلي
  • Figure 2.3: a glacial cirque in section · Generated With Diffusion Models · أصلي
  • Figure 2.4: abrasion at the base of the ice · Generated With Diffusion Models · أصلي
  • Figure 2.5: plucking on a rock step · Generated With Diffusion Models · أصلي
  • Figure 2.6: a roche moutonnée · Generated With Diffusion Models · أصلي
  • Figure 2.7: lateral, medial and terminal moraines in plan · Generated With Diffusion Models · أصلي
الخطوط
Faustina (SIL OFL 1.1) · Montserrat (SIL OFL 1.1) · IBM Plex Sans Condensed (SIL OFL 1.1)
الشيفرة
MIT، مثل Postext
Sandbox