التدوين الموسيقي

الموسيقى نص في الكتاب، ومظهرها إعداد.

المدوّنة في Postext تُكتب تدوينًا ولا تُرسم. تحمل كتلةٌ محاطة في الفصل الموسيقى بإحدى أربع صيغ نصية، فينقشها المحرك بمكتبة Verovio، مكتبة النقش التابعة لـ Music Encoding Initiative. تُنقش المدوّنة بعرض عمودها وتُقطَّع إلى أسطر موسيقية، أي الأسطر التي يتبعها القارئ من اليسار إلى اليمين. ويوضع كل سطر كتلةً مستقلة، فالمدوّنة الأطول مما بقي من الصفحة تكمل في أعلى العمود التالي، ولا تنقطع أبدًا داخل سطر. حجم المدرج والخط الموسيقي وأرقام المازورات والتباعد تأتي من قسم scoreStyle في الإعدادات، فيتغير مظهر الكتاب كله بتغيير إعداد واحد.

الموسيقى اختيارية: المستند الذي لا كتل تدوين فيه يُصفّ كما كان، ولا يُحمَّل الناقش (نحو 3.7 ميغابايت) إلا في الكتب التي فيها موسيقى.

#الصيغ

الكتلة ```xml تبقى قائمة شيفرة. وكتلة التدوين التي تحمل {listing} تبقى قائمة شيفرة أيضًا، لعرض مصدر لحن في درس تعليمي.

#مدوّنة داخل النص

القفلة التامة تنتهي على درجة الأساس في الصوت الأعلى:
 
```humdrum {alt="جملة كورال في صول الكبير تنتهي بقفلة تامة"}
**kern	**kern	**kern	**kern
*clefF4	*clefGv2	*clefG2	*clefG2
*k[f#]	*k[f#]	*k[f#]	*k[f#]
*M4/4	*M4/4	*M4/4	*M4/4
4GG	4B	4d	4b
4D	4d	4f#	4a
=	=	=	=
1GG	1B	1d	1g
==	==	==	==
*-	*-	*-	*-
```
 
أما نصف القفلة فتقف على الدرجة الخامسة.

لحن بكلماته، بصيغة ABC:

```abc
X:1
T:Evening hymn
M:3/4
L:1/4
K:F
c | A2 B | c2 A | G2 F | E2 c | A2 B | c2 A | G2 E | F2 |]
w: Now the day is o-ver, night is draw-ing nigh, sha-dows of the eve-ning steal a-cross the sky.
```

للكتلة خاصيتان:

• alt="…": ما المدوّنة، لقارئات الشاشة وملف PDF الموسوم وEPUB. إن لم تُذكر قُرئ العنوان واسم المؤلف المكتوبان في التدوين (T: وC: في ABC، و<work-title> و<creator type="composer"> في MusicXML). العنوان لا يُطبع، فاكتبه في النص أو في تعليق.
• style="…": نمط مدوّنة مسمّى في الكتاب (scoreStyles)، كنمط بمدرج أصغر لأمثلة داخل إطار.

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

#أمثلة موسيقية مرقّمة

المثال الموسيقي الذي يحيل إليه النص («انظر المثال ٣-٢») مورد من نوع score، يُصفّ كالشكل: مرقّم، وله تعليق، عائم أو في موضعه، ويُحال إليه بـ :ref.

{
  "id": "ex-cadence",
  "typeId": "example",
  "kind": "score",
  "caption": "قفلة تامة في صول الكبير",
  "score": { "format": "musicxml", "source": "<?xml version=\"1.0\"?>…", "styleId": "small" }
}

القفلة في :ref{id="ex-cadence"} تختم الجملة.
 
::resource{id="ex-cadence"}

المورد من النوع example يُرقَّم بنوع مثال المضمَّن في Postext، بلغة المستند: Example وEjemplo وExemple وNotenbeispiel وEsempio وExemplo و谱例 و譜例 ومثال. ويُضاف هذا النوع إلى أنواع الموارد في الكتاب حين يستعمله مورد؛ عرّف نوعًا خاصًا إن أردت اسمًا آخر. وفي الحزمة (preset.json) يمكن أن يشير المورد إلى ملف تدوين بدل أن يحمل نصه:

{ "id": "ex-cadence", "typeId": "example", "kind": "score", "file": "resources/ex-cadence.musicxml" }

الملف المنتهي بـ .abc أو .musicxml أو .mei أو .krn يُقرأ مدوّنةً أيًّا كانت قيمة kind. ويقرأ سطر الأوامر الملفات نفسها من مجلد --resources أمثلةً موسيقية، وتنشئ لوحة الموارد في Sandbox مثالًا من جديد › مدوّنة جديدة أو من ملف يُسقَط فيها.

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

#مظهر المدوّنة

كل المدوّنات تتبع scoreStyle، والنمط المسمّى فوقه لا يغيّر إلا ما يحدده:

const config: PostextConfig = {
  scoreStyle: {
    staffSize: { value: 5.5, unit: 'mm' },
    musicFont: 'Leland',
    barNumbers: 'system',
    minSystemsAtBreak: 2,
  },
  scoreStyles: [
    { id: 'small', name: 'أمثلة صغيرة', staffSize: { value: 4.5, unit: 'mm' }, barNumbers: 'none' },
  ],
};

• حجم المدرج: ارتفاع الخطوط الخمسة. الكتب المدرسية من ٦ إلى ٧ مم، والكتب الجامعية وكتب التعليم من ٥ إلى ٦ مم، والأمثلة داخل النص من ٤ إلى ٥ مم.
• الخط الموسيقي: Bravura (مظهر النقش التقليدي)، وLeland (أخفّ)، وPetaluma (يشبه الكتابة اليدوية)، وLeipzig وGootville.
• خط النص: كلمات الغناء وعلامات السرعة والأداء، بخط النص الأساسي ما لم يُحدَّد غيره. الكلمة الأعرض بهذا الخط منها بخط Times الذي يقيس به الناقش تُصفّ أصغر، فلا تتراكب المقاطع أبدًا.
• التباعد وأرقام المازورات والمسافة بين الأسطر والهوامش والحبر.
• أسطر تبقى معًا (minSystemsAtBreak): أقل عدد من الأسطر تتركه المدوّنة أسفل العمود أو تنقله إلى التالي. مع القيمة ٢ لا يبقى سطر وحده أبدًا، والمدوّنة التي تقل عن أربعة أسطر تنتقل كاملة.

كل الحقول بأنواعها وقيمها الافتراضية في الإعدادات › نمط المدوّنة الموسيقية. ويحررها Sandbox في التصميم › الأشكال والجداول › المدوّنات الموسيقية وأنماط المدوّنات.

#في كل المخرجات

• Canvas وHTML: يُرسم كل سطر مسارات متجهية ونصًّا بحبر المدوّنة، ويسمّي عارض HTML المدوّنة بنصها البديل.
• PDF: رسوم متجهية، والنص بخطوط الكتاب المضمّنة. وفي PDF الموسوم كل مدوّنة Figure بنصها البديل.
• EPUB: يعرض EPUB القابل لإعادة التدفق الأسطرَ SVG مضمّنًا بعرض عمود القراءة، ويُقرأ صورةً واحدة؛ أما EPUB ذو التخطيط الثابت فيحتفظ بالصفحات المطبوعة.
• Word: يحتفظ المستند المصدَّر بكتلة التدوين كما كُتبت، كقائمة الشيفرة، فتعود المدوّنة حين يُستورد المستند من جديد.

#العمل مع دار نشر موسيقية

يصفّ Postext الكتاب حول الموسيقى، ويبقى برنامج التدوين حيث تُكتب الموسيقى.

1. انقش الموسيقى أو صحّحها في Dorico أو Sibelius أو Finale أو MuseScore، وصدّر كل مثال بصيغة MusicXML (.musicxml، غير مضغوط).
2. ضع الملفات بين موارد الكتاب بالنوع example. ويمكن كتابة الأمثلة القصيرة ذات الصوت الواحد بصيغة ABC في الفصل مباشرة.
3. قِس حجم المدرج واضبط الخط الموسيقي لأسلوب الدار في scoreStyle؛ وأمثلة الإطارات والهوامش تأخذ نمطًا مسمّى.
4. صُفّ الكتاب وراجع فواصل الصفحات. عدد المازورات في السطر يتوقف على عرض العمود وحجم المدرج والتباعد.

وتتبع مهارة postext-port الخطوات نفسها حين تنقل كتابًا دراسيًا في الموسيقى أو كتاب تعليم أو كتاب أغانٍ.

#الحدود

• تُملأ الأسطر حتى عرض العمود: فواصل الأسطر المكتوبة في التدوين لا تُحترم بعد.
• قارئ ABC يقرأ صوتًا واحدًا.
• ملف MusicXML المضغوط (.mxl) يجب فكّه أولًا.
• الطبعة الكاملة لمدوّنة (مدوّنة أوركسترا، والأجزاء المنفصلة، وقلب الصفحات المخطط مازورةً بمازورة) عمل برنامج تدوين لا برنامج صفّ كتب.