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

دليل الوصفات · الفصل 8 · الجداول

برنامج مؤتمر بجدول مواعيد مدمج الخلايا

برنامج ليومين في جداول مواعيد: تمدّ mergeCells الجلسة العامة على القاعات الثلاث وورشة العمل على فترتين، وتأخذ كل محاضرة لون مسارها.

في هذه الصفحة
  • نموذج باللغة الإنجليزية: لا توجد طبعة عربية بعد
  • مقاس القص 170 × 240 مم
  • عمودان, فاصل 6 مم بين الأعمدة
  • Schibsted Grotesk 9.4/13
  • Chivo Mono
  • Unbounded
  • 6 صفحات
  • المستوى
  • Postext 1.65.0
  • أُخرجت في 131 ms
  • أسطر الشيفرة: 214

باختصار

البرنامج المطبوع لمؤتمر من يومين عن الطباعة وفن الحروف. يسمح جدول مواعيده بأن تمتد محاضرة واحدة على كل القاعات أو على فترتين زمنيتين، ولكل موضوع لونه.

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

البرنامج المطبوع لمؤتمر متخيَّل عن فن الحروف في جيرونا، مكتوب بالكتالونية. يرسم الغلاف الحرف الكبير ela geminada، أي L·L، ثلاث وحدات ملونة على أرضية بلون الحبر. يبدأ كل يوم على شريط بلون الحبر عمقه 76 mm، ويوم الشهر فيه رقم بحجم 144 pt. جدول الخميس جدول بيانات. المحاضرة الافتتاحية تملأ خلية واحدة بلون الحبر على القاعات الثلاث، وكل ورشة عمل تأخذ فترتين زمنيتين. أقسام اليوم تتصدّر صفوفها على عرض الجدول كله، وكل محاضرة مربع بلون مسارها، تشرحه عينات الألوان في التعليق. الجدول أطول من الصفحة، فيملأ الصفحة 3 وينتهي في الصفحة 4 تحت صف عناوينه المكرّر. أما جدول الجمعة الأقصر فيتسع كاملًا في أسفل صفحة افتتاحه.

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

  • كيف أصنع جدولًا فيه صفوف رأس، وخلايا مدمجة، وعروض أعمدة، ومحاذاة لكل خلية؟
  • كيف أقسّم جدولًا طويلًا عبر الصفحات مع تكرار الرأس وعلامة «تابع»؟
  • كيف أضيف عيّنات لونية دليلية إلى النص أو التعليقات أو ملاحظات الجداول؟
  • كيف أحصل على تسميتي «شكل» و«جدول» بلغة مستندي؟
  • كيف أصمم صفحة افتتاح فصل فيها شريط لوني ممتد حتى النزف ورقم فصل كبير والعنوان؟

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

script.js · الأسطر 32–65في الشيفرة الكاملة
const ROOMS = ['Sala Gran', 'Sala de les Premses', 'Aula Taller'];
const TRACKS = { T: 'tipo', D: 'digital', E: 'edicio', '*': 'ink' }; // '*': a plenary
const at = (row, c) => ({ row, col: c });
const span = (r0, c0, r1, c1) => ({ start: at(r0, c0), end: at(r1, c1) });
const lines = (code, text) => text.split(' / ').map((line, i) => { // title, then speaker
  const run = i === 0 ? `**${line}**` : line;
  return code === '*' ? chip(run, 'blanc') : run; // paper-white type on the ink fill
}).join('\n'); // a line break in a cell starts a new paragraph
function schedule(text) { // '11.15 | T Title / Speaker | ^' · a bare line: a part of the day
  let m = { headerRowCount: 1, columnWidths: [12, 42, 42, 42], // weights of the 138 mm measure
    rows: [['Hora', ...ROOMS].map((room) => ({ content: room.toUpperCase(), isHeader: true }))] };
  for (const line of text.trim().split('\n')) {
    const [time, ...slots] = line.split(' | ');
    const r = m.rows.push(['', ...ROOMS].map(() => ({ content: '' }))) - 1; // four empty cells
    if (!slots.length) { // one cell across the table; a split keeps it with the rows it heads
      m = setCellContent(m, at(r, 0), chip(time.toUpperCase(), 'franja'));
      m = mergeCells(m, span(r, 0, r, 3));
      continue;
    }
    m = setCellContent(m, at(r, 0), chip(time, 'hora'));
    slots.forEach((slot, i) => {
      if (slot === '^') { // the session above runs on: one cell down both rows, centred in them
        m = mergeCells(m, span(r - 1, i + 1, r, i + 1));
        m = setAlignment(m, at(r - 1, i + 1), 'left', 'middle');
        return;
      }
      const [, code = '', body = slot] = /^([TDE*]) (.+)$/.exec(slot) ?? [];
      m = setCellContent(m, at(r, i + 1), lines(code, body));
      m = setCellBackground(m, at(r, i + 1), col(TRACKS[code] ?? 'pause'));
    });
    if (slots.length === 1) m = mergeCells(m, span(r, 1, r, 3)); // the same for all three rooms
  }
  return m; // mergeCells marks the covered cells hiddenBy (gotcha: merged-cells-hiddenby)
}

المكونات

الخطوط
Schibsted Grotesk, Unbounded, Chivo Mono (SIL OFL 1.1)
الأصول
لا شيء: كل صورة مرسومة بالشيفرة

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

#1 · حوّل كل سطر من البرنامج إلى صف

الشيفرة هي الجواب المختصر أعلاه. كل يوم نص عادي في ملف محتوى، سطر لكل فترة زمنية: | تفصل بين القاعات، والحرف يحدّد المسار، و* تعلّم جلسة عامة على تعبئة بلون الحبر، و/ تبدأ كل سطر بعد العنوان، و^ تكمل جلسة الفترة التي فوقها. mergeCells تصنع كل امتداد. السطر الذي فيه جلسة واحدة، كالجلسة العامة أو الاستراحة، يأخذ أعمدة القاعات الثلاثة. وورشة العمل تأخذ خليتها والخلية التي تحتها، وقسم اليوم (MATÍ، TARDA)، المكتوب سطرًا بلا |، يأخذ الأعمدة الأربعة. الخلايا التي يغطيها الدمج تبقى في الجدول، معلَّمة بـhiddenBy، لأن عمود الخلية هو موقعها في الصف (بناء نماذج الجداول). يجعل headerRowCount: 1 أسماء القاعات صفَّ العناوين. قيم columnWidths أوزان نسبية، و12 + 3 × 42 مجموعها عرض السطر البالغ 138 mm، فعرض عمود الساعة 12 mm وكل قاعة 42 mm. ويضع setAlignment(…, 'left', 'middle') كل ورشة عمل في الوسط عموديًا في صفّيها.

#2 · دع الخميس يمتد واحفظ الجمعة كاملًا

script.js · الأسطر 69–80في الشيفرة الكاملة
// The built-in types in Catalan, Figura and Taula; a grid's caption goes above it.
const resourceTypes = defaultResourceTypes('ca').map((type) => ({ ...type,
  ...(type.id === 'table' && { captionStyle: { position: 'above' } }),
  numberingTemplate: '{n}', resetOn: 'never' })); // Taula 1, Taula 2: one count, not per day
const SPLIT = { overflow: 'split', // the default; the other values are 'clip' and 'hide'
  // The engine's own Catalan strings are '(cont.)' and 'Continua': these spell them out.
  continuedSuffix: '(continuació)', // after the caption of every part but the first
  continuesMarker: 'Continua a la pàgina següent' }; // under every part but the last
// Thursday is cited on page 2 and placed at the top, so it opens page 3 (gotcha:
// top-float-next-page) and splits; Friday goes whole to the foot of the page that cites it.
const PLACE = { dijous: { position: 'top', span: 'page' },
  divendres: { position: 'bottom', span: 'page' } };

يُحال إلى جدول الخميس في الصفحة 2 ويوضع في رأس صفحة. العنصر العائم لا يصعد أبدًا فوق إحالته، فيفتتح الجدول الصفحة 3. وهو أطول من الصفحة، فيقطعه overflow: 'split' بين صفّين، لا داخل خلية مدمجة أبدًا (الجداول الأطول من الصفحة). تنتهي الصفحة 3 بصف 17.30 والعلامة تحته. وتكرر الصفحة 4 صف العناوين والتعليق كاملًا، بما فيه مفتاح العينات، متبوعًا بـ(continuació)، ولا تُطبع الملاحظة إلا تحت هذا الجزء الأخير. يذهب جدول الجمعة إلى أسفل صفحة ويتسع تحت النص الذي يحيل إليه في الصفحة 5. تسمّي defaultResourceTypes('ca') الأنواع بالكتالونية، Figura وTaula. وعبارتا المحرّك الكتالونيتان للجدول المقسوم هما (cont.) وContinua، ونمط الجدول يكتبهما كاملتين. ويعدّ numberingTemplate: '{n}' مع resetOn: 'never' الجدولين في سلسلة واحدة، Taula 1 وTaula 2.

#3 · قطّع التعبئات إلى مربعات

script.js · الأسطر 84–93في الشيفرة الكاملة
const tableStyle = { ...SPLIT, borderColor: col('paper'), borderWidth: pt(1.6), // grid rules
  headerBackground: col('ink'), headerColor: col('paper'), headerFontFamily: LABEL,
  headerFontSize: pt(7.5), bodyFontSize: pt(8.2),
  cellPadding: mm(1.5) };
const bare = (id, extra) => ({ id, backgroundEnabled: false, borderWidth: pt(0),
  paddingX: pt(0), ...extra }); // a chip that only changes the face, the size or the colour
const chipStyles = [bare('blanc', { color: col('paper') }), // the plenary's type, on ink
  bare('hora', { fontFamily: LABEL, fontSize: em(0.96), bold: true }),
  bare('franja', { fontFamily: LABEL, fontSize: em(0.92), bold: true, color: col('accent') }),
  bare('sala')]; // keeps each room of the plan's note on one line

تمنح setCellBackground في الجواب المختصر كل جلسة لون مسارها من لوحة الألوان، وتقطّع خطوط الشبكة بعرض 1.6 pt بلون الورق التعبئاتِ إلى مربعات تفصلها ممرات بيضاء (نمط الجداول). للجدول لون نص واحد لخلايا متنه، فحروف الجلسة العامة البيضاء شارة يضبط نمطها اللون ويوقف تعبئة الشارة وحدّها وحشوتها الجانبية. والأوقات وأقسام اليوم شارات أيضًا، بخط Chivo Mono (أنماط الشارات). الشارة لا تنكسر بين الأسطر أبدًا؛ وعنوان الجلسة العامة وسطر متحدثها يتسع كل منهما في سطر واحد من الخلية الممتدة على القاعات الثلاث. وفي ملاحظة المخطط تترك شارة sala النص كما هو وتبقي رقم كل قاعة واسمها على سطر واحد، كما تفعل مسافة غير قابلة للكسر بين كلماته.

#4 · افتتح كل يوم على شريط

script.js · الأسطر 97–121في الشيفرة الكاملة
const BAND = 76, STRIP = 8, AIR = 7; // mm: band from the trim, its strip of modules, air below
const text = (id, content, family, size, color, placement, extra) => ({ kind: 'text', id,
  content, fontFamily: family, fontSize: pt(size), color: col(color), placement, align: 'left',
  overflow: 'wrap', ...extra }); // a long line wraps, in the running heads too
const pin = (to, edge, x, y, size) => ({ anchor: { to, edge }, offset: { x: mm(x), y: mm(y) },
  ...(size && { size }) });
const caps = (size) => ({ fontWeight: 500, textTransform: 'uppercase',
  letterSpacing: pt(size * 0.18) });
const NUMERAL = 144; // pt
// mm: Unbounded 800's 1 at 144 pt starts its ink 0.76 mm into its box, the date's first capital
// at 8 pt 0.1 to 0.2 mm into its own (P 0.19, S 0.09): 0.6 mm to the left lines up the two inks
const BEARING = 0.6;
const BASELINE = 0.8; // a design line's baseline sits 0.8 down its box (lineHeight 1)
const opener = { enabled: true, minHeight: mm(BAND - PAGE.top + AIR), slot: { elements: [
  { kind: 'box', id: 'band', style: { backgroundColor: col('ink') },
    placement: pin('bleed', 'top-left', 0, 0, { width: 'fill', height: mm(BAND) }) },
  { kind: 'image', id: 'strip', resourceId: 'strip', placement: pin('page', 'top-left', 0,
    BAND - STRIP, { width: mm(PAGE.w), height: mm(STRIP) }) }, // on the band's foot
  text('date', '{attr.date}', LABEL, 8, 'edicio', pin('container', 'top-left', 0, 0), caps(8)),
  text('numeral', '{attr.day}', DISPLAY, NUMERAL, 'paper', pin('#date', 'below', -BEARING, 1),
    { fontWeight: 800, lineHeight: 1 }), // a 144 pt line box
  text('title', '{titleText}', DISPLAY, 26, 'paper', // its baseline level with the numeral's
    pin('#numeral', 'right-of', 5, BASELINE * (NUMERAL - 26) * PT),
    { fontWeight: 700, lineHeight: 1 }),
] } };

تصميم عنوان المستوى الأول يرسم الشريط: صندوق عمقه 76 mm من حافة النزف، وعلى حافته السفلى شريط الوحدات. يأتي التاريخ من السمة date في العنوان، والرقم من day. يبدأ حبر الرقم 1 في خط Unbounded 800 بحجم 144 pt على بعد 0.76 mm داخل مستطيله، ويبدأ أول حرف كبير في التاريخ على بعد 0.1 إلى 0.2 mm داخل مستطيله، فيتحرك الرقم 0.6 mm إلى اليسار، ويبدأ حبر التاريخ والرقم والنص على مسافة 0.2 mm بعضها من بعض. يقف اسم اليوم إلى يمين الرقم، منخفضًا بمقدار BASELINE × (144 − 26) pt ليلتقي خطا الأساس، لأن نص التصميم الذي lineHeight: 1 فيه يقع خط أساسه على 0.8 من ارتفاع مستطيله. يحجز minHeight الصفحة حتى 7 mm تحت الشريط، وتقرّب شبكة خطوط الأساس الحجز إلى 14 سطرًا، فيبدأ أول مستطيل سطر من النص على بعد 10.2 mm تحت الشريط. ومع AIR = 0 يحدد مستطيل الرقم نفسه، الذي يتجاوز أسفل الشريط، الارتفاعَ بدلًا من ذلك، ويبدأ النص على بعد 5.6 mm تحت الشريط.

#5 · أزِح الأسطر التالية في نبذات المتحدثين

script.js · الأسطر 125–129في الشيفرة الكاملة
const paragraphStyles = [
  { id: 'bio', hangingIndent: mm(4) }, // the name at the column edge, the lines under it 4 mm in
  { id: 'colophon', fontFamily: LABEL, fontSize: pt(7.4), lineHeight: pt(LEAD * 0.75),
    textAlign: 'left', color: col('muted'), firstLineIndent: pt(0), marginTop: pt(LEAD) },
];

كل متحدث فقرة واحدة من كتلة :::paragraphs{style="bio"}. يبدأ الاسم العريض عند حافة العمود، وتنزاح الأسطر تحته 4 mm إلى الداخل، فتصطف الأسماء على طول العمود كما في الفهرس (أنماط الفقرات).

الوصفة كاملة

Sandbox
// ═══ Postext Cookbook · Nº 053 · Conference programme with a merged schedule grid ═══════
// https://postext.dev/en/cookbook/conference-programme
// Code: MIT · Text: original, in Catalan (CC BY 4.0) · Drawings: generated in code (CC BY 4.0)
// Fonts: Schibsted Grotesk, Unbounded, Chivo Mono (SIL OFL 1.1) · Needs postext ≥ 1.25.0
import {
  buildDocumentWithFonts, prepareFonts, renderPageToCanvas, registerResourceImage,
  defaultResourceTypes, mergeCells, setCellContent, setCellBackground, setAlignment,
} from 'https://esm.sh/postext';

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

// ─── 1 · Design ─────────────────────────────────────────────────────────────
const palette = {
  ink: '#1d1b24', paper: '#ffffff', // a violet near-black; type on the ink fills
  tipo: '#b09cf2', digital: '#4fc7bb', edicio: '#f4b43a', // the three tracks: fills and swatches
  pause: '#ecebf1', // registration, breaks and meals
  accent: '#6a3ed3', // kickers, caption labels, the parts of the day
  muted: '#67636f', // running heads and notes
};
// Each 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, 'main-color': palette.accent }) // defaults' id
  .map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
const [TEXT, DISPLAY, LABEL] = ['Schibsted Grotesk', 'Unbounded', 'Chivo Mono'];
const PAGE = { w: 170, h: 240, top: 22, bottom: 20, inner: 17, outer: 15 }; // mm, mirrored
const LEAD = 13; // pt: the body's leading and baseline grid
const PT = 25.4 / 72; // mm in a point
const chip = (text, style) => `:chip[${text}]{style="${style}"}`;

// #region answer: a day's schedule as a table with merged cells, track fills and a head row
const ROOMS = ['Sala Gran', 'Sala de les Premses', 'Aula Taller'];
const TRACKS = { T: 'tipo', D: 'digital', E: 'edicio', '*': 'ink' }; // '*': a plenary
const at = (row, c) => ({ row, col: c });
const span = (r0, c0, r1, c1) => ({ start: at(r0, c0), end: at(r1, c1) });
const lines = (code, text) => text.split(' / ').map((line, i) => { // title, then speaker
  const run = i === 0 ? `**${line}**` : line;
  return code === '*' ? chip(run, 'blanc') : run; // paper-white type on the ink fill
}).join('\n'); // a line break in a cell starts a new paragraph
function schedule(text) { // '11.15 | T Title / Speaker | ^' · a bare line: a part of the day
  let m = { headerRowCount: 1, columnWidths: [12, 42, 42, 42], // weights of the 138 mm measure
    rows: [['Hora', ...ROOMS].map((room) => ({ content: room.toUpperCase(), isHeader: true }))] };
  for (const line of text.trim().split('\n')) {
    const [time, ...slots] = line.split(' | ');
    const r = m.rows.push(['', ...ROOMS].map(() => ({ content: '' }))) - 1; // four empty cells
    if (!slots.length) { // one cell across the table; a split keeps it with the rows it heads
      m = setCellContent(m, at(r, 0), chip(time.toUpperCase(), 'franja'));
      m = mergeCells(m, span(r, 0, r, 3));

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

تنويعات

#دوّر زوايا الجدول

الجدول المقسوم يدوّر الزاويتين العلويتين لجزئه الأول، في الصفحة 3، والزاويتين السفليتين لجزئه الأخير، في الصفحة 4، حيث لا تظهر إلا اليمنى لأن عمود الساعة بلا تعبئة.

-  cellPadding: mm(1.5) };
+  cellPadding: mm(1.5), borderRadius: mm(2.5) };

#رقّم جدول كل يوم وحده

العدّ لكل عنوان من المستوى الأول، كما تفعل الأنواع المدمجة، يُنتج Taula 1.1 وTaula 2.1 ويحوّل المخطط إلى Figura 2.1؛ ونمط الغلاف غير مرقّم، فالخميس هو العنوان 1.

-  numberingTemplate: '{n}', resetOn: 'never' })); // Taula 1, Taula 2: one count, not per day
+  numberingTemplate: '{h1}.{n}', resetOn: 'h1' })); // Taula 1.1, Taula 2.1: per day

أخطاء شائعة

خطأ شائع

الخلايا المدمجة تحتاج إلى خلايا نائبة hiddenBy: استخدم mergeCells

تُوزَّع الخلايا بحسب موضعها في مصفوفة الصف، فالخلية المدمجة تحتاج إلى خلايا نائبة معلَّمة بـ hiddenBy حيث تمتد؛ وحذفها، كما يفعل HTML، يزيح كل الأعمدة التالية. ابنِ الدمج بـ mergeCells. ومنذ postext 1.5 يُبلَّغ عن الجدول غير المنتظم الشبكة في doc.contentWarnings تحت raggedTableGrid، ويعلّم parseTSV(text, { headerRows }) صفوف الترويسة. جداول من البيانات →

خطأ شائع

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

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

الحقوق

الوصفة
Ignacio Ferro
النص
  • The programme’s Catalan text, both schedules included, written for this recipe, and the cover, band and floor-plan drawings, generated in code · Ignacio Ferro · CC BY 4.0
الخطوط
Schibsted Grotesk (SIL OFL 1.1) · Unbounded (SIL OFL 1.1) · Chivo Mono (SIL OFL 1.1)
الشيفرة
MIT، مثل Postext
Sandbox