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

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

رسالة فيزيائية يمتد شكل بياناتها أعلى الصفحة

رسالة اكتشاف GW150914 مُعادة التنضيد في عمودين: الإشارة مرسومة من بيانات مفتوحة في الصفحة 1، واستشهادات مرقّمة بصيغة [1]، ومعادلات مرقّمة، والجدول I.

في هذه الصفحة
  • نموذج باللغة الإنجليزية: لا توجد طبعة عربية بعد
  • مقاس القص 215.9 × 279.4 مم
  • عمودان, فاصل 7 مم بين الأعمدة
  • Gelasio 9.3/12.4
  • Albert Sans
  • 5 صفحات
  • المستوى
  • Postext 1.65.0
  • أُخرجت في 209 ms
  • أسطر الشيفرة: 189

باختصار

رسالة عام 2016 التي أعلنت أول رصد لموجات الجاذبية، مختصرةً ومنضّدة من جديد على قطع الرسالة الأمريكي. إشارة الكاشفين مرسومة من البيانات العامة وتمتد عبر الصفحة 1، والمراجع مرقّمة بين قوسين معقوفين.

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

خمس صفحات من الرسالة التي أعلنت أول رصد لموجات الجاذبية، Observation of Gravitational Waves from a Binary Black Hole Merger (Abbott et al., 2016)، مختصرةً ومنضّدة من جديد على قطع الرسالة الأمريكي في عمودين. تبدأ الصفحة 1 بالدليل: الانفعال الذي سُجّل في Hanford وLivingston، مرسومًا من جديد من ملفات البيانات المفتوحة لمركز العلوم المفتوحة لموجات الجاذبية (GWOSC)، يمتد عبر العمودين تحت العنوان. وتحته توقيع التعاون مع حاشيته، والملخص بعرض الصفحة، ثم النص، والاستشهادات مرقّمة [1,2] و[25–27] كما تطبعها مجلات APS. كتلة الزقزقة هي المعادلة (1). ويضع الجدول I أخطاءه غير المتماثلة رمزين علويًا وسفليًا متراكبين، مكتوبين صيغًا رياضية في الخلايا، وتطبع التعليقات صيغ الرسالة نفسها. ضع ملف BibTeX وملفات بياناتك مكانها، فينضّد السكربت نفسه رسالتك.

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

  • كيف أنضّد رسالة فيزيائية: توقيع تعاون بحثي، والملخص على عرض العمودين، وشكل بيانات ممتد في أعلى الصفحة؟
  • كيف أتحكم في موضع الشكل: أعلى الصفحة، أو بعرض العمودين، أو هنا تمامًا، أو في الهامش؟
  • كيف أنضد الرياضيات (مضمّنة، ومعروضة، ومعادلات) وأبقيها متجهية في ملف PDF؟
  • كيف أعيد تنضيد ورقة بحثية مفتوحة الوصول من arXiv أو PubMed Central بـPostext، مع استشهاداتها وأشكالها وسطر ترخيصها؟

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

script.js · الأسطر 32–60في الشيفرة الكاملة
// [@key] numbers works by first citation. APS journals print [1,2] and [2–4] in one pair of
// brackets and list "A. Einstein, Sitzungsber. K. Preuss. Akad. Wiss. 1, 688 (1916).": no
// title, volume bold. No APS style is bundled: four edits turn the IEEE file into one.
registerCitationEngine(createCiteprocEngine({ styles: STYLES, locales: LOCALES }));
const ARTICLE = '<group delimiter=" "><text variable="container-title"/><text '
  + 'variable="volume" font-weight="bold" suffix=","/><text variable="page"/><date '
  + 'variable="issued" prefix="(" suffix=")"><date-part name="year"/></date></group>';
const BOOK = '<group delimiter=" "><group delimiter=", "><choose><if type="chapter"><text '
  + 'variable="container-title" prefix="in " font-style="italic"/></if><else><text variable='
  + '"title" font-style="italic"/></else></choose><names variable="editor" prefix="edited by ">'
  + '<name and="text" initialize-with=". "/></names><text variable="collection-title"/><text '
  + 'variable="volume" prefix="Vol. "/></group><group prefix="(" suffix=")" delimiter=", ">'
  + '<text variable="publisher"/><text variable="publisher-place"/><date variable="issued">'
  + '<date-part name="year"/></date></group></group><text variable="page" prefix="pp. "/>';
const aps = STYLES.ieee
  .replace('<citation>', '<citation collapse="citation-number">') // [2–4], not [2], [3], [4]
  .replace(/<layout delimiter=", ">\s*<group prefix="\[" suffix="\]" delimiter=", ">/,
    '<layout prefix="[" suffix="]" delimiter=","><group delimiter=", ">') // [1,2]
  .replace('et-al-min="7"', 'et-al-min="11"') // ten authors are listed, as in the letter
  .replace(/<bibliography[\s\S]*<\/bibliography>/, '<bibliography second-field-align="flush">'
    + '<layout suffix="."><text variable="citation-number" prefix="[" suffix="]"/><text '
    + 'macro="author"/><choose><if type="manuscript"><text variable="note" prefix=" "/></if>'
    + `<else><group prefix=", " delimiter=", "><choose><if type="article-journal">${ARTICLE}`
    + `</if><else-if type="book chapter" match="any">${BOOK}</else-if><else><text variable=`
    + '"URL"/><text variable="note"/></else></choose></group></else></choose></layout>'
    + '</bibliography>');
const citations = { style: 'custom', customStyle: aps, link: true,
  bibliography: { fontSize: em(0.84), lineHeight: pt(9.5), entrySpacing: pt(0.4),
    labelWidth: mm(6.2) } }; // the [64] column: turnovers line up after the widest label

المكونات

الخطوط
Gelasio, Albert Sans (SIL OFL 1.1)
الأصول
لا شيء: كل صورة مرسومة بالشيفرة

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

#1 · استشهادات فيزيائية مرقّمة من أسلوب IEEE

الشيفرة هي الجواب المختصر أعلاه. لا تضم postext-citeproc أسلوب APS، وأقرب الأساليب المضمّنة إليه ieee: ترقيم بترتيب الاستشهاد، وأرقام بين قوسين معقوفين، والأحرف الأولى قبل اسم العائلة. وتسدّ أربعة استبدالات نصية في STYLES.ieee الفرق. يضم collapse="citation-number" الأرقام المتتالية ([25–27])، ويطبع زوج واحد من الأقواس على layout الصيغة [1,2]، ويرتفع et-al-min إلى أحد عشر فتبقى قائمة من عشرة مؤلفين كاملة، وتطبع كتلة <bibliography> جديدة المرجع كما تطبعه Physical Review: اسم المجلة والمجلد بالأسود العريض والصفحة والسنة، مثل Phys. Rev. Lett. 74, 3515 (1995). وتأتي المراجع الثلاثة والأربعون في كتلة :::references{format=bibtex} مستقلة؛ والاسم المكتوب بين قوسين معقوصين مزدوجين مثل {{J. Aasi et al.}} يُطبع كما هو، وبهذه الطريقة تستشهد الرسالة بقوائم المؤلفين الطويلة جدًا لتعاونها. انظر الاستشهادات وقائمة المراجع.

#2 · الشكل 1 تحت العنوان، عبر العمودين

script.js · الأسطر 64–89في الشيفرة الكاملة
const text = (id, content, family, size, extra) => ({ kind: 'text', id, content, align: 'left',
  fontFamily: family, fontSize: pt(size), color: col('ink'), overflow: 'wrap', ...extra });
const at = (to, edge, x, y, width) => ({ anchor: { to, edge }, offset: { x: mm(x), y: mm(y) },
  ...(width && { size: { width: mm(width), height: 'auto' } }) });
const caps = (size) => ({ fontWeight: 700, letterSpacing: pt(size * 0.2),
  textTransform: 'uppercase', color: col('accent') });
const letter = { id: 'letter', numbered: false, span: 'page', marginBottom: pt(0),
  advancedDesign: { enabled: true, minHeight: mm(21), slot: { elements: [
    text('kicker', '{attr.kicker}', SANS, 7.5, { ...caps(7.5),
      placement: at('container', 'top-left', 0, 2, MEASURE) }),
    text('title', '{titleText}', SANS, 23, { fontWeight: 700, lineHeight: 1.08,
      placement: at('#kicker', 'below', 0, 2.2, MEASURE) }),
  ] } } };
const box = { padding: { top: mm(2.6), right: mm(12), bottom: mm(2.4), left: mm(12) },
  background: col('tint'), marginTop: pt(0), marginBottom: pt(LEAD), span: 'page',
  body: { fontSize: pt(9.3), lineHeight: pt(12.6), firstLineIndent: pt(0) } };
// ::resource{id="fig1"} right under the title, placed { position: 'here', span: 'page' }:
// it spans both columns on page 1, where a float could only follow its citation.
const paragraphStyles = [
  { id: 'byline', fontFamily: SANS, fontSize: pt(10), lineHeight: pt(12.6), fontWeight: 600,
    textAlign: 'center', firstLineIndent: pt(0) },
  { id: 'dates', fontFamily: SANS, fontSize: pt(7.6), lineHeight: pt(12.6), textAlign: 'center',
    color: col('muted'), firstLineIndent: pt(0) },
  { id: 'colophon', fontFamily: SANS, fontSize: pt(7), lineHeight: pt(9.4), color: col('muted'),
    textAlign: 'left', firstLineIndent: pt(0), marginTop: pt(LEAD) },
];

لا يقع العنصر العائم فوق السطر الذي يستشهد به، والنص يستشهد بالشكل 1 أول مرة في القسم II، فلو كان عائمًا لما بلغ الصفحة 1. لذلك تضعه الرسالة هناك مباشرة: يأتي ::resource{id="fig1"} بعد العنوان مباشرة، وموضعه { position: 'here', span: 'page' } يمدّه عبر العمودين في تلك النقطة، ويتابع العمودان تحته. ثم يأتي التوقيع والملخص في إطار بعرض الصفحة، front، تُوسّط كتل :::paragraphs فيه التوقيع وتنضّد التواريخ بحجم صغير. وترسل علامة الحاشية بعد et al. نصها إلى أسفل العمود الأول، حيث تطبع مجلات APS ملاحظة المؤلفين، ويرقّم footnotes.numberFormat: 'lower-alpha' الحواشي بالحروف فلا تُقرأ أرقام مراجع. انظر التضمين في كتلة والحواشي السفلية.

#3 · الجدول I وفي خلاياه صيغ رياضية

script.js · الأسطر 346–354في الشيفرة الكاملة
// A cell sets $…$ in the line, at the table's size: the errors stack over and under the value.
const VALUES = [['Primary black hole mass', '$36^{+5}_{-4}\\,M_\\odot$'],
  ['Secondary black hole mass', '$29^{+4}_{-4}\\,M_\\odot$'],
  ['Final black hole mass', '$62^{+4}_{-4}\\,M_\\odot$'],
  ['Final black hole spin', '$0.67^{+0.05}_{-0.07}$'],
  ['Luminosity distance', '$410^{+160}_{-180}$ Mpc'],
  ['Source redshift $z$', '$0.09^{+0.03}_{-0.04}$']];
const table = { model: { columnWidths: [1.3, 1], rows: VALUES.map(([label, value]) =>
  [{ content: label, verticalAlign: 'middle' }, { content: value }]) } };

منذ postext 1.19 تنضّد الخلية $…$ كما ينضّده النص، فتُكتب كل قيمة بلغة TeX، مثل $36^{+5}_{-4}\,M_\odot$، ويتراكب خطآها فوق الرقم وتحته مصغّرين على قدر سطر الخلية؛ أما ^+5^~−4~ في Markdown فيطبعهما واحدًا بعد الآخر. وتقبل التعليقات والملاحظات الصيغ نفسها: يكتب الشكل 2 $R_S = 2GM/c^2$ ويكتب الشكل 4 $5.1\sigma$، بحروف MathJax التي فيها اليونانية الغائبة عن خطّي النص، ويحفظها ملف PDF مسارات متجهة. وتطبع أنواع الموارد FIG. 1 وTABLE I في التعليقات وFig. 1 وTable I في النص: ببادئة captionPrefix، وبـcounterFormat: 'upper-roman' للجداول. انظر الصيغ الرياضية.

#4 · أشكال مرسومة من البيانات المفتوحة

script.js · الأسطر 17–22في الشيفرة الكاملة
const palette = { ink: '#171a21', accent: '#25578a', tint: '#eef2f6', rule: '#b7c0ca',
  muted: '#5a636e', paper: '#ffffff' };
const data = { hanford: '#cf5f24', livingston: palette.accent, purple: '#74519c' }; // figures
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = Object.entries({ ...palette, 'main-color': palette.accent })
  .map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));

تُرسم الأشكال الأربعة بالشيفرة من ملفات البيانات التي نشرها GWOSC مع الرسالة بترخيص CC BY 4.0. يحتفظ كل منحنى بعينة من كل ثماني عينات، أي 430 نقطة لمدة 0.21 ثانية في الشكل 1، وتُخزّن كل نقطة بحرف واحد من base-64 لتغيّرها عن النقطة السابقة، فتبقى المنحنيات الخمسة دون 3 كيلوبايت داخل السكربت. وصف البواقي هو البيانات ناقص الموجة، كما في الأصل. Hanford بالبرتقالي وLivingston بالأزرق في كل الأشكال، ويكتفي النص بحبر الصفحة ولون أزرق واحد. والتسميات مسارات MathJax بخطه غير المذيّل (\textsf)، فيُنضَّد الأسّ أو الرمز على المحور كما تُنضَّد معادلات النص، ويحتفظ ملف PDF بكل خط وتسمية متجهًا.

الوصفة كاملة

Sandbox
// ═══ Postext Cookbook · Nº 140 · A physics letter with a data figure across the top ═══
// https://postext.dev/en/cookbook/physics-letter-two-columns
// Code: MIT · Text: Abbott et al., PRL 116, 061102 (CC BY 3.0) · Data: GWOSC (CC BY 4.0)
// Fonts: Gelasio, Albert Sans (SIL OFL 1.1) · Needs postext ≥ 1.34.0
import {
  buildDocumentWithFonts, renderPageToCanvas, registerResourceImage, registerCitationEngine,
  defaultResourceTypes, initMathEngine, renderMath,
} 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 = 'physics-letter-two-columns';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: ink and one blue for the text; the detectors' colours for the data
const palette = { ink: '#171a21', accent: '#25578a', tint: '#eef2f6', rule: '#b7c0ca',
  muted: '#5a636e', paper: '#ffffff' };
const data = { hanford: '#cf5f24', livingston: palette.accent, purple: '#74519c' }; // figures
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = Object.entries({ ...palette, 'main-color': palette.accent })
  .map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
// #endregion
const [SERIF, SANS] = ['Gelasio', 'Albert Sans'];
// mm: US Letter, head, foot and side margins, gutter; then the measure and one column
const [TRIM_W, TRIM_H, TOP, BOTTOM, SIDE, GUTTER] = [215.9, 279.4, 21, 21, 16, 7];
const MEASURE = TRIM_W - 2 * SIDE;
const COLUMN = (MEASURE - GUTTER) / 2;
const [BODY, LEAD] = [9.3, 12.4]; // pt: a letter journal's density, two columns of 88 mm

// #region answer: physics citations [1] and [2–4], from the bundled IEEE style
// [@key] numbers works by first citation. APS journals print [1,2] and [2–4] in one pair of
// brackets and list "A. Einstein, Sitzungsber. K. Preuss. Akad. Wiss. 1, 688 (1916).": no
// title, volume bold. No APS style is bundled: four edits turn the IEEE file into one.
registerCitationEngine(createCiteprocEngine({ styles: STYLES, locales: LOCALES }));
const ARTICLE = '<group delimiter=" "><text variable="container-title"/><text '
  + 'variable="volume" font-weight="bold" suffix=","/><text variable="page"/><date '
  + 'variable="issued" prefix="(" suffix=")"><date-part name="year"/></date></group>';
const BOOK = '<group delimiter=" "><group delimiter=", "><choose><if type="chapter"><text '
  + 'variable="container-title" prefix="in " font-style="italic"/></if><else><text variable='
  + '"title" font-style="italic"/></else></choose><names variable="editor" prefix="edited by ">'
  + '<name and="text" initialize-with=". "/></names><text variable="collection-title"/><text '
  + 'variable="volume" prefix="Vol. "/></group><group prefix="(" suffix=")" delimiter=", ">'
  + '<text variable="publisher"/><text variable="publisher-place"/><date variable="issued">'
  + '<date-part name="year"/></date></group></group><text variable="page" prefix="pp. "/>';
const aps = STYLES.ieee
  .replace('<citation>', '<citation collapse="citation-number">') // [2–4], not [2], [3], [4]
  .replace(/<layout delimiter=", ">\s*<group prefix="\[" suffix="\]" delimiter=", ">/,

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

تنويعات

#استعمل أسلوب IEEE المضمّن كما هو

من دون الاستبدالات يصبح النص [2], [3], [4] والقائمة A. Einstein, “title”, journal….

-const citations = { style: 'custom', customStyle: aps, link: true,
+const citations = { style: 'ieee', link: true,

#أرقام مرفوعة كما في Nature

يضع أسلوب Nature أرقامًا مرفوعة ويذكر عناوين الأعمال، وهو مضمّن.

-const citations = { style: 'custom', customStyle: aps, link: true,
+const citations = { style: 'nature', link: true,

#نضّدها على قطع A4

غيّر القطع؛ فتتبعه مساحة النص والأعمدة وكل الأشكال.

-const [TRIM_W, TRIM_H, TOP, BOTTOM, SIDE, GUTTER] = [215.9, 279.4, 21, 21, 16, 7];
+const [TRIM_W, TRIM_H, TOP, BOTTOM, SIDE, GUTTER] = [210, 297, 22, 22, 15, 7];

أخطاء شائعة

خطأ شائع

الرياضيات تحتاج إلى await initMathEngine() قبل البناء الأول

الصيغ التي تُنضَّد قبل أن يعمل محرّك الرياضيات مربعات رمادية نائبة. استورد initMathEngine من https://esm.sh/postext مع سائر الرموز وانتظرها بـ await قبل البناء الأول؛ والمستند الذي فيه رياضيات ويُبنى من دونها يطبع تحذيرًا واحدًا في وحدة التحكم. ومنذ postext 1.5 يأتي MathJax داخل حزمة postext وحدةً واحدة تجلبها initMathEngine، فالاستيراد العادي يعمل من CDN ولا حاجة إلى ?bundle (حتى 1.4 كان يجب أن يأتي كل رمز من https://esm.sh/postext?bundle). استورد من عنوان URL واحد فقط: عنوانان يحمّلان محرّكين. الرياضيات →

  • حتى postext 1.18 كان المورد 'here' الذي له span: 'page' يُنضّد بعرض عمود واحد في تدفق من عمودين، وكان $ في تعليق أو خلية يُطبع كما كُتب. ثبّت الإصدار 1.19 أو أحدث.
  • الحرف اليوناني أو ⊙ أو ≃ المكتوب حرفًا في تعليق أو خلية يقع على خط النظام في الشاشة ويغيب عن ملف PDF، الذي لا يضمّن إلا الملفات اللاتينية لكل خط. اكتبه صيغةً، مثل $\sigma$ أو $M_\odot$، وارسمه في الأشكال.
  • قائمة من مئات المؤلفين لا مكان لها في ملف BibTeX. اكتب الاسم كما تطبعه المجلة، بين قوسين معقوصين مزدوجين: author={{B. Abbott et al.}}.
  • احتفظ بسطر ترخيص البحث وسطر ترخيص البيانات. هنا تذكر حاشيةٌ وبيانُ النشر ما حُذف، وتذكر ملاحظة كل تعليق البيانات وما يتركه الشكل المعاد رسمه.

الحقوق

الوصفة
Ignacio Ferro
النص
  • Text: B. P. Abbott et al. (LIGO Scientific Collaboration and Virgo Collaboration), “Observation of Gravitational Waves from a Binary Black Hole Merger”, Phys. Rev. Lett. 116, 061102 (2016), doi:10.1103/PhysRevLett.116.061102. Abridged from the published letter (Sections IV and VII, parts of Sections I, III, V and VI and most of the acknowledgments cut; sections and references renumbered); figures redrawn; figure captions shortened. Licence: CC BY 3.0, https://creativecommons.org/licenses/by/3.0/ · LIGO Scientific Collaboration and Virgo Collaboration · CC BY 3.0
  • Data for Figures 1, 2 and 4: the GW150914 data files released by the Gravitational Wave Open Science Center (gwosc.org), a service of the LIGO Scientific Collaboration, the Virgo Collaboration and KAGRA; redrawn in code · LIGO Scientific Collaboration and Virgo Collaboration, GWOSC · CC BY 4.0
الخطوط
Gelasio (SIL OFL 1.1) · Albert Sans (SIL OFL 1.1)
الشيفرة
MIT، مثل Postext
SandboxPDF