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

دليل الوصفات · الفصل 10 · الإخراج والدمج

منصّة لتجربة إعدادات العارض Folio

نموذج يضم كل إعدادات config.folio يقود عارض postext-folio واحدًا عبر setAppearance: الورق والتجليد والغلافان والمكتب والإضاءة والميل تتغيّر في مكانها.

في هذه الصفحة
المستوى
متوسط
Postext
اختُبرت مع Postext 1.65.0
تتطلب ≥ 1.26.0
الترخيص
حُدّثت في 11 أكتوبر 2026
الشيفرة MIT · النص CC BY 4.0
  • نموذج باللغة الإنجليزية: لا توجد طبعة عربية بعد
  • مقاس القص 110 × 160 مم
  • عمود واحد
  • Source Serif 4 9.3/12.4
  • Outfit
  • 10 صفحات
  • المستوى
  • Postext 1.57.1
  • أُخرجت في 51 ms
  • أسطر الشيفرة: 144

باختصار

كتاب جيب صغير معروض بالأبعاد الثلاثة بجانب لوحة من أدوات التحكم. غيّر الورق أو التجليد أو المكتب أو الإضاءة فيتغيّر الكتاب فورًا، دون أن يُنضَّد من جديد.

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

Six Knots كتاب جيب من عشر صفحات بقياس قص 110 × 160 mm، مفتوح في Folio بجانب لوحة تضم كل إعدادات config.folio. اختر نوع ورق فتتغيّر الأوراق لونًا وسطحًا وصلابة؛ وبدّل التجليد من غلاف ورقي إلى غلاف مقوّى فتنمو علبة حول كتلة الصفحات؛ واختر العلبة بدل الغلافين المطبوعين، وخامة من القماش أو الجلد، ومكتبًا، وإضاءة، وميلًا. يُنضَّد الكتاب مرة واحدة. ويصل كل تغيير إلى العارض عبر setAppearance، فلا يتحرّك أي سطر ولا تُرسم أي صفحة من جديد، وتظهر الإعدادات تحت النموذج كودًا جاهزًا للصق في config.folio.

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

  • كيف أعاين تجليد الكتاب وغلافه وورقه وإضاءته قبل إرساله إلى الطباعة؟
  • كيف أعرض مستندي كتابًا ثلاثي الأبعاد يقلّب القارئ صفحاته بيده؟

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

script.js · الأسطر 196–220في الشيفرة الكاملة
const book = createFolioFromDocument(document.getElementById('folio'), doc, {
  // The look starts from doc.config.folio; setAppearance replaces it on every change.
  appearance: { textureBaseUrl: 'https://postext.dev/folio/textures' },
  onChange: ({ pages }) => kitStatus(`${doc.pages.length} pages · open at `
    + pages.map((i) => i + 1).join('–')),
});
function update() {
  const folio = folioOf();
  // Only the appearance changes: the pages keep their paintings, nothing is laid out again.
  book.setAppearance({ folio });
  show('grammage-out', `${folio.paper.grammage} g/m²`);
  show('intensity-out', folio.lighting.intensity.toFixed(2));
  show('tilt-out', `${folio.tilt}°`);
  document.getElementById('folio-json').textContent = `folio: ${JSON.stringify(folio, null, 2)}`;
}
form.addEventListener('input', update);
// A stock sets its own weight: picking one moves the weight slider to the stock's.
const WEIGHTS = { uncoated: 90, bookWove: 80, coatedMatte: 115, coatedSilk: 115,
  coatedGloss: 115, bible: 40, newsprint: 48, cardStock: 250 };
form.elements['paper.type'].addEventListener('change', (event) => {
  form.elements['paper.grammage'].value = WEIGHTS[event.target.value];
  update();
});
document.getElementById('reset-view').addEventListener('click', () => book.resetView());
update();

المكونات

الخطوط
Source Serif 4, Outfit (SIL OFL 1.1)
الأصول
لا شيء: كل صورة مرسومة بالشيفرة

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

#1 · سمِّ الحقول بأسماء الإعدادات

script.js · الأسطر 72–86في الشيفرة الكاملة
const form = document.getElementById('controls');
const hex = (value) => ({ hex: value, model: 'hex' });
function folioOf() { // 'paper.grammage' → { paper: { grammage } }, typed by the input
  const folio = {};
  for (const el of form.elements) {
    if (!el.name || el.type === 'button' || el.tagName === 'OUTPUT') continue;
    const value = el.type === 'checkbox' ? el.checked : el.type === 'range' ? Number(el.value)
      : el.type === 'color' ? hex(el.value) : el.value;
    const [group, key] = el.name.split('.');
    if (key) (folio[group] ??= {})[key] = value;
    else folio[group] = value;
  }
  return folio;
}
const show = (name, value) => { form.elements[name].value = value; };

لكل حقل في النموذج اسمُ مساره في config.folio (paper.grammage وbinding.cover وlighting.environment)، فتحوّل حلقة واحدة النموذج إلى الكائن الذي يأخذه العارض: أرقام من المنزلقات، وقيم منطقية من مربعات الاختيار، ولون { hex, model } من أداة اختيار اللون. والكائن نفسه هو config.folio الخاص بالمستند حين يبنيه المثال، فيفتح Sandbox الكتاب كما يبدأ النموذج.

#2 · غلافان يقلّبهما العارض لوحين

script.js · الأسطر 40–61في الشيفرة الكاملة
const field = { kind: 'box', id: 'field', style: { backgroundColor: col('brick') },
  placement: { ...at('bleed', 'top-left'), size: { width: 'fill', height: mm(TRIM_H) } } };
const flush = { numbered: false, span: 'page', footer: { elements: [] },
  margins: { top: mm(0), bottom: mm(0), left: mm(0), right: mm(0) } };
const cover = (id, title, extra = {}) => ({ id, ...flush, ...extra, advancedDesign: {
  enabled: true, minHeight: mm(TRIM_H), slot: { elements: [field, ...title] } } });
const headingStyles = [
  cover('cover', [
    text('title', '{titleText}', { fontFamily: SANS, fontWeight: 700, fontSize: pt(40),
      lineHeight: 0.92, color: col('cream') },
    { ...at('page', 'top-left', INNER, 30), size: { width: mm(80) } }),
    text('strap', '{attr.strap}', { fontFamily: 'Source Serif 4', italic: true,
      fontSize: pt(11), lineHeight: 1.3, color: col('cream') },
    { ...at('#title', 'below', 0, 6), size: { width: mm(72) } }),
    text('author', '{author}', caps(7, col('cream')), at('page', 'bottom-left', INNER, -16)),
  ]),
  cover('back', [
    text('strap', '{attr.strap}', { fontFamily: 'Source Serif 4', italic: true,
      fontSize: pt(11), lineHeight: 1.3, color: col('cream'), align: 'center' },
    { ...at('page', 'center', 0, 0), size: { width: mm(76) } }),
  ], { breakBefore: { enabled: true, parity: 'even' } }), // the back: always a verso
];

مع binding.cover: 'pages' تكون الصفحة الأولى اللوح الأمامي والأخيرة اللوح الخلفي، إذا وقعت على صفحة زوجية. يبدأ أسلوب عنوان الغلاف الخلفي على صفحة زوجية، فينتهي الكتاب دائمًا على صفحة زوجية ويُقلَّب الغلافان كلاهما. وإذا بدّلت النموذج إلى A case round the pages (علبة حول الصفحات) قُلِّبت الصفحتان نفساهما ورقتين عاديتين داخل علبة من القماش.

#3 · أعِد تنسيق الكتاب في مكانه

الشيفرة هي الجواب المختصر أعلاه. تستبدل setAppearance({ folio }) إعدادات المستند وتعيد رسم المشهد: سماكة الورق وصلابته، والعلبة، وخرائط المكتب، والإضاءة. تحتفظ الصفحات برسومها، فيظهر التغيير في الرسم التالي للمشهد. لكل نوع ورق وزنه الخاص، ولهذا يحرّك اختيار نوع منزلقَ الوزن؛ وتعيد resetView() الكاميرا إلى مكانها بعد أن يدير القارئ الكتاب بالسحب بالزر الأيمن.

الوصفة كاملة

Sandbox
// ═══ Postext Cookbook · Nº 103 · A bench for the Folio viewer's settings ═══════════════
// https://postext.dev/en/cookbook/folio-settings-bench
// Code: MIT · Text: original (CC BY 4.0) · Pictures: none
// Fonts: Source Serif 4, Outfit (SIL OFL 1.1) · Needs postext ≥ 1.26.0
//
// A pocket book of knots, laid out once and opened in postext-folio next to a form of every
// folio setting: paper, binding, covers, desk, light and tilt. Each change goes to the viewer
// with setAppearance, so the book is redrawn in place and no page is laid out or painted
// again. The settings as code sit under the form, ready to paste into config.folio.
import { buildDocumentWithFonts, renderPageToCanvas } from 'https://esm.sh/postext';
import { createFolioFromDocument } from 'https://esm.sh/postext-folio';

const LANG = 'en'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'folio-settings-bench';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: brick red for the covers and the knot numbers, a warm ink for the text
const palette = {
  ink: '#24211f',
  brick: '#9a3b2e', // the cover field, kickers and folios
  cream: '#f6efe2', // type on the covers
  muted: '#6f6860',
};
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' } })),
  { id: 'main-color', name: 'accent (defaults)', value: { hex: palette.brick, model: 'hex' } },
];
// #endregion
const [TRIM_W, TRIM_H, TOP, BOTTOM, INNER, OUTER] = [110, 160, 15, 17, 14, 12]; // mm: a pocket
const LEAD = 12.4; // pt
const SANS = 'Outfit';
const at = (to, edge, x = 0, y = 0) => ({ anchor: { to, edge }, offset: { x: mm(x), y: mm(y) } });
const text = (id, content, look, placement) => ({ kind: 'text', id, content, overflow: 'wrap',
  align: 'left', placement, ...look });
const caps = (size, color) => ({ fontFamily: SANS, fontSize: pt(size), fontWeight: 600,
  letterSpacing: pt(size * 0.16), textTransform: 'uppercase', color });

// #region covers: a full-page colour field on page 1 and on the last page
const field = { kind: 'box', id: 'field', style: { backgroundColor: col('brick') },
  placement: { ...at('bleed', 'top-left'), size: { width: 'fill', height: mm(TRIM_H) } } };
const flush = { numbered: false, span: 'page', footer: { elements: [] },
  margins: { top: mm(0), bottom: mm(0), left: mm(0), right: mm(0) } };
const cover = (id, title, extra = {}) => ({ id, ...flush, ...extra, advancedDesign: {
  enabled: true, minHeight: mm(TRIM_H), slot: { elements: [field, ...title] } } });
const headingStyles = [
  cover('cover', [
    text('title', '{titleText}', { fontFamily: SANS, fontWeight: 700, fontSize: pt(40),

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

تنويعات

#ابدأ من غلاف مقوّى في علبة من القماش

غيّر القيم الافتراضية للنموذج في index.html؛ ويتبعها المستند وSandbox.

-        <option value="hardcover">Hardcover</option><option value="paperback" selected>Paperback</option>
+        <option value="hardcover" selected>Hardcover</option><option value="paperback">Paperback</option>

#كتاب واحد، ومظهره في الإعدادات

تكتب وصفة كتاب على المكتب الإعدادات نفسها مرة واحدة في config.folio، بلا نموذج، وتضع كرّاسة عيّنات الورق ورقًا مختلفًا على كل ورقة.

أخطاء شائعة

خطأ شائع

يأخذ عارض Folio مقاس حاويته

يضع createFolioFromDocument الكتاب داخل العنصر الذي تعطيه إياه، مع الأزرار وعدد الصفحات في هوامشه. والعنصر الذي لا ارتفاع له (div فارغ في التدفق العادي) لا يعرض شيئًا: أعطه ارتفاعًا في CSS. عارض الكتاب ثلاثي الأبعاد (Folio) →

خطأ شائع

cover: 'pages' يحتاج إلى عدد زوجي من الصفحات للغلاف الخلفي

حين يُضبط binding.cover على 'pages' تنقلب الصفحة الأولى غلافًا أماميًا، ولا تنقلب الصفحة الأخيرة غلافًا خلفيًا إلا إذا وقعت في صفحة زوجية. فالعدد الفردي من الصفحات يترك الكتاب بغلاف أمامي بلا غلاف خلفي: أكمله إلى عدد زوجي أو احتفظ بالغلاف الصلب. الورق والتجليد والمكتب والإضاءة (Folio) →

الحقوق

الوصفة
Ignacio Ferro
النص
نص أصلي, CC BY 4.0
الخطوط
Source Serif 4 (SIL OFL 1.1) · Outfit (SIL OFL 1.1)
الشيفرة
MIT، مثل Postext
Sandbox