بنية المستند: الخلاصة والتحديات

ملخص

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

أهداف التعلم

إعادة بناء ترتيب قرارات الوحدة وآلياتها، مع تعيين المبدأ الذي يستند إليه كلٌّ منها.
شرح كيف يتوقّف الترقيم وجدول المحتويات والإحالات والترجمة الجزئية على الملفات المساعدة.
التمييز بين ما أرسته الوحدة وما لم تفعل إلا أن أشارت إليه وستفصّله الوحدات التالية.
تشخيص مستندات مقسّمة على عدة ملفات تفشل، أو تُترجَم بأرقام كاذبة، مع ترتيب التصحيحات.
تخطيط صنف أطروحة وصفحتها وأجزائها وإحالاتها وملفاتها انطلاقًا من اللوائح التي يجب أن تستوفيها.

ما حقّقته الوحدة

قصدت الوحدة أن تعطي المستند معمارًا تبقى أرقامه وجدول محتوياته وإحالاته صادقة عبر كل تغييراته. وقد تحقّق هذا القصد بالاستناد إلى ما عدّته المقدمة معلومًا من الوحدات السابقة: تمريرات الترجمة، والفصل بين الديباجة ومتن المستند، والترميز المنطقي. وبذلك يمكن أن يُقرأ الطريق المقطوع سلسلةً واحدة من خمسة أجزاء.

أصناف المستندات والصفحة

أرسى درس أصناف المستندات والصفحة أن الصنف يقرّر أيّ التقسيمات موجود، وماذا يفعل \maketitle، وهل يوجد ملخص، وهل تتميّز الصفحات الزوجية من الفردية؛ واستنتج من ذلك معيارًا للاختيار بين article وreport وbook بحسب البنية والطباعة، وعرض أصناف KOMA-Script، مع الخيار es-noquoting الذي يقتضيه جمعها مع الإسبانية في إصدار TeX Live المستعمل في هذه الأمثلة. واستعرض خيارات الصنف، وشرح لماذا تتوقّف الهوامش على طول السطر وكيف تُضبط بحزمة geometry، وختم بأنماط الصفحة، التي تفرضها بعض أوامر الصنف من تلقاء نفسها.

الأقسام وجدول المحتويات والملاحق

نضّد درس الأقسام وجدول المحتويات والملاحق بيانات العنوان والملخص، ورتّب مستويات التقسيم، وأرسى أن عدّادين مستقلّين، secnumdepth وtocdepth، يقرّران ما يُرقَّم وما يدخل جدول المحتويات. وشرح أن جدول المحتويات يُنضَّد بما سجّلته التمريرة السابقة، دون تنبيه حين يتقادم؛ وأن \appendix يغيّر ترقيم ما يليه؛ وأن للكتاب ثلاثة أجزاء، بترقيمين للصفحات، وليس ترتيبها أمرًا لا يُبالى به.

الإحالات المتقاطعة

أرسى درس الإحالات المتقاطعة المبدأ الذي تتوقّف عليه كل إحالة: الوسم يسجّل آخر رقم أُسند قبله، داخل بيئته. واستنتج منه أين يوضع الوسم في كل عنصر، ولماذا يحيل وسمٌ قبل التسمية التوضيحية لشكل إلى القسم، ولماذا لا يكون لقسم بلا رقم رقمٌ خاص به يُحال إليه. وبيّن أن ترجمةً واحدة بعد تعديلٍ تطبع الأرقام السابقة في هيئة صحيحة تمامًا، وعرض حزمة hyperref، التي يجب أن تُحمَّل في آخر الحزم، وحزمة cleveref، التي تأتي بعدها والتي تكتب الأسماء بالإنجليزية ما لم يعرّف \crefname الأسماء العربية.

المستندات الطويلة

وزّع درس المستندات الطويلة المستند على ملف رئيسي وقطع بلا ديباجة. وميّز بين \input، وهو استبدال حرفي، و\include، الذي يفتح صفحة ويكتب ملفًا مساعدًا خاصًّا به ويقبل \includeonly، الذي يتوقّف ترقيمه على الملفات المساعدة لترجمة كاملة سابقة. وأرسى أن المسارات تُكتب انطلاقًا من مجلد الملف الرئيسي، وأن المستند الأم يُعيَّن في Texmaker، واستعرض الأخطاء الخاصة بالمستندات المقسّمة، ومنها خطآن صامتان: القطعة التي لا يجدها \include، والقطعة ذات الديباجة، التي يُنهي \end{document} الخاص بها الأطروحة.

الماكروهات والديباجة الخاصة

جعل درس الماكروهات والديباجة الخاصة الترميز المنطقي منهجًا: \newcommand بوسائط وبوسيط اختياري، والحماية التي تمنع إعادة تعريف اسم مشغول، والمسافة التي تضيع بعد أمر بلا وسائط، و\NewDocumentCommand، والبيئات الخاصة، التي لا توجد وسائطها إلا في شيفرة الفتح، والديباجة المنقولة إلى ملف أو إلى حزمة، لا ينبغي أن تفرض الصنف ولا اللغة ولا موضع hyperref.

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

دعامات السلسلة

Aالتمريرات. يسجّل المحرّك في الملفات المساعدة الأرقام والعناوين والصفحات في تمريرة، ويستعملها في التمريرة التالية. يُرسى في الوحدة الأولى. يُقبل دون برهان في هذه الوحدة.
Bالديباجة والمتن. الديباجة تضبط الإعدادات وتحمّل الحزم، والمتن ينضّد؛ وما لا يفعل إلا أن يعرّف أو يحفظ يجوز أن يكون في كليهما. يُرسى في الوحدة الأولى. يُقبل دون برهان في هذه الوحدة.
Cالمضمون والشكل. يصرّح المؤلف بماهية كل شيء، وقرارٌ يُتّخذ في موضع آخر يحدّد كيف يبدو. يُرسى في الوحدات السابقة. يُقبل دون برهان في هذه الوحدة.
Dالصنف يقرّر. صنف المستند يقرّر أيّ التقسيمات موجود، وما الذي ينضّده العنوان، وهل يوجد ملخص، وكيف تُوزَّع الصفحات، وأيّ نمط تفرضه أوامره. تثبت في: 1. ثلاثة أصناف قياسية.
Eما يسجّله الوسم. الوسم يسجّل آخر رقم أُسند قبله، داخل بيئته، دون أن يعلم بماذا هو مرتبط. تثبت في: 11. الوسوم والإحالات.
Fترتيب التحميل. تُحمَّل الحزم بالترتيب الذي تُقرأ به، وقد تنقض حزمةٌ لاحقة ما فعلته حزمة سابقة: hyperref في الآخر، وcleveref بعدها. تثبت في: 13. الروابط.
Gالملف الرئيسي. يُترجَم الملف الرئيسي دائمًا؛ والقطع أجزاء من متنه، بلا ديباجة، وتُكتب مساراتها انطلاقًا من مجلد الرئيسي. تثبت في: 16. الأمر include.

المقطع 1 أصناف المستندات والصفحة
- اختيار الصنف بحسب بنية المستند وطباعته.
- التصريح بخيارات الصنف والتنبّؤ بأثرها.
- ضبط الهوامش بحزمة geometry دون إطالة السطر إطالة مفرطة.
- التنبّؤ بأنماط الصفحة والترويسات والتذييلات وتغييرها.
1. ثلاثة أصناف قياسية. ليس في article فصول؛ وفي report فصول، مع عنوان وملخص في صفحات خاصة بهما؛ وbook يطبع على الوجهين وليس فيه ملخص.
  تستند إلى: B (الديباجة والمتن). يُبرهن في: أصناف المستندات والصفحة.
2. KOMA-Script. تقابل scrartcl وscrreprt وscrbook الأصناف القياسية بقرارات أوروبية؛ ومع babel بالإسبانية تقتضي، في هذا الإصدار، الخيار es-noquoting.
  تستعمل: 1. ثلاثة أصناف قياسية. تستند إلى: C (المضمون والشكل). يُبرهن في: أصناف المستندات والصفحة.
3. خيارات الصنف. الورق، وحجم الخط، والوجه الواحد أو الوجهان، وصفحة العنوان، وبداية الفصول، والمسودة، يُصرَّح بها في السطر الأول.
  تستعمل: 1. ثلاثة أصناف قياسية. تستند إلى: D (الصنف يقرّر). يُبرهن في: أصناف المستندات والصفحة.
4. الهوامش. تحسب geometry الصفحة من مقاسات قليلة؛ وعرض صندوق النص يحدّد طول السطر، وهو ما يعانيه القارئ.
  تستعمل: 3. خيارات الصنف. تستند إلى: B (الديباجة والمتن). يُبرهن في: أصناف المستندات والصفحة.
5. أنماط الصفحة. النمط يقرّر الترويسات والتذييلات؛ و\maketitle و\chapter يفرضان على صفحتهما النمط plain، وتؤلّف fancyhdr أو scrlayer-scrpage أنماطًا خاصة.
  تستعمل: 1. ثلاثة أصناف قياسية, 4. الهوامش. تستند إلى: D (الصنف يقرّر). يُبرهن في: أصناف المستندات والصفحة.
المقطع 2 الأقسام وجدول المحتويات والملاحق
- تنضيد العنوان والملخص بحسب الصنف.
- اختيار مستوى التقسيم والتنبّؤ بالترقيم وبجدول المحتويات.
- إنتاج جدول المحتويات والقوائم، مع معرفة التمريرة التي تتوقّف عليها.
- ترتيب الملاحق وأجزاء الكتاب.
1. العنوان والملخص. \title و\author و\date تحفظ، و\maketitle ينضّد؛ والبيئة abstract موجودة في article وreport، لا في book.
  تستعمل: 1. ثلاثة أصناف قياسية. تستند إلى: D (الصنف يقرّر), B (الديباجة والمتن). يُبرهن في: الأقسام وجدول المحتويات والملاحق.
2. مستويات التقسيم. سبعة مستويات، من الجزء إلى الفقرة الفرعية؛ والفصل لا يوجد إلا في report وbook، ولا يُختار التسلسل بحسب حجم العنوان.
  تستعمل: 1. ثلاثة أصناف قياسية. تستند إلى: D (الصنف يقرّر). يُبرهن في: الأقسام وجدول المحتويات والملاحق.
3. الترقيم وجدول المحتويات. يقرّر secnumdepth أيّ المستويات يُرقَّم، وtocdepth أيّها يدخل جدول المحتويات؛ والصيغة ذات النجمة لا ترقّم ولا تستهلك رقمًا.
  تستعمل: 7. مستويات التقسيم. تستند إلى: C (المضمون والشكل). يُبرهن في: الأقسام وجدول المحتويات والملاحق.
4. جدول المحتويات والقوائم. ينضّد جدول المحتويات ما سجّلته التمريرة السابقة في الملف .toc، ولا ينبّه حين يتقادم.
  تستعمل: 7. مستويات التقسيم, 8. الترقيم وجدول المحتويات. تستند إلى: A (التمريرات). يُبرهن في: الأقسام وجدول المحتويات والملاحق.
5. الملاحق وأجزاء الكتاب. \appendix يغيّر ترقيم ما يليه؛ وفي book، للصفحات التمهيدية ومتن الكتاب والصفحات الختامية ترقيمان، وتأتي الملاحق قبل \backmatter.
  تستعمل: 7. مستويات التقسيم, 5. أنماط الصفحة. تستند إلى: D (الصنف يقرّر). يُبرهن في: الأقسام وجدول المحتويات والملاحق.
المقطع 3 الإحالات المتقاطعة
- وضع الوسوم وتسميتها.
- توقّع ما تطبعه الإحالة بعد تمريرة واحدة أو تمريرتين.
- تحميل hyperref وcleveref بترتيبهما.
- الإحالة بالاسم والرقم، أو بالعنوان.
1. الوسوم والإحالات. \label يعلّم موضعًا، و\ref و\pageref يكتبان رقمه وصفحته، بتمريرتين.
  تستعمل: 7. مستويات التقسيم. تستند إلى: A (التمريرات). يُبرهن في: الإحالات المتقاطعة.
2. أين يوضع الوسم. بعد الأمر الذي يُسند الرقم وداخل البيئة نفسها: بعد \section، وبعد \caption؛ مع بادئة تقول ما الذي يدلّ عليه.
  تستعمل: 11. الوسوم والإحالات. تستند إلى: E (ما يسجّله الوسم). يُبرهن في: الإحالات المتقاطعة.
3. الروابط. تحوّل hyperref الإحالات وجدول المحتويات والحواشي إلى روابط، والأقسام إلى علامات مرجعية، وتُحمَّل في آخر الحزم.
  تستعمل: 11. الوسوم والإحالات, 9. جدول المحتويات والقوائم. تستند إلى: B (الديباجة والمتن). يُبرهن في: الإحالات المتقاطعة.
4. إحالات بالاسم. تكتب cleveref الاسم والرقم؛ وبلا أسماء عربية تكتب الإنجليزية («section»)، وتُعرَّف العربية بالأمر \crefname؛ وتحيل nameref بالعنوان.
  تستعمل: 13. الروابط, 12. أين يوضع الوسم. تستند إلى: E (ما يسجّله الوسم), F (ترتيب التحميل). يُبرهن في: الإحالات المتقاطعة.
المقطع 4 المستندات الطويلة
- الاختيار بين \input و\include لكل قطعة.
- التنبّؤ بما يحفظه \includeonly.
- تنظيم المجلدات وتعيين المستند الأم.
- التعرّف إلى أخطاء المستندات المقسّمة، الصاخبة منها والصامتة.
1. الأمر input. يُدرج \input ملفًا كأن نصه مكتوب في موضعه، دون قطع الصفحة ولا إنشاء ملفات مساعدة.
  تستند إلى: B (الديباجة والمتن). يُبرهن في: المستندات الطويلة.
2. الأمر include. يفتح \include صفحةً قبله وبعده، ويكتب ملفًا مساعدًا خاصًّا لكل قطعة، ولا يجوز تداخله.
  تستعمل: 15. الأمر input, 7. مستويات التقسيم. تستند إلى: A (التمريرات). يُبرهن في: المستندات الطويلة.
3. الترجمة الجزئية. ينضّد \includeonly القطع المختارة وحدها ويرقّم الباقي بملفاتها المساعدة، التي يجب أن تأتي من ترجمة كاملة لاحقة لآخر تعديل لها.
  تستعمل: 16. الأمر include, 11. الوسوم والإحالات. تستند إلى: A (التمريرات). يُبرهن في: المستندات الطويلة.
4. المجلدات والمستند الأم. ملف رئيسي في الجذر، وقطع في مجلدات، ومسارات انطلاقًا من الرئيسي، وأسماء بسيطة، والرئيسي في Texmaker مستندًا أمًّا.
  تستعمل: 16. الأمر include. تستند إلى: G (الملف الرئيسي). يُبرهن في: المستندات الطويلة.
5. أخطاء المستندات المقسّمة. \input بلا ملف يوقف الترجمة؛ و\include بلا ملف لا يفعل إلا أن يسجّل «No file»؛ والقطعة ذات الديباجة تُنهي الأطروحة عند \end{document} الخاص بها.
  تستعمل: 16. الأمر include, 18. المجلدات والمستند الأم. تستند إلى: G (الملف الرئيسي), B (الديباجة والمتن). يُبرهن في: المستندات الطويلة.
المقطع 5 الماكروهات والديباجة الخاصة
- تعريف أوامر بوسائط وبوسيط اختياري.
- التمييز بين التعريف وإعادة التعريف والتوفير، وتجنّب المسافة الضائعة.
- تعريف بيئات خاصة.
- جمع الديباجة في ملف أو في حزمة.
1. الأوامر الخاصة. يعرّف \newcommand أمرًا بما يصل إلى تسعة وسائط، أوّلها اختياري بقيمته الافتراضية؛ وهو يسمّي وظيفة تتكرّر.
  تستند إلى: C (المضمون والشكل). يُبرهن في: الماكروهات والديباجة الخاصة.
2. الأسماء المشغولة والمسافات. يرفض \newcommand اسمًا موجودًا، ويرفض \renewcommand اسمًا غير موجود؛ والأمر الذي بلا وسائط يستهلك المسافة التي تليه.
  تستعمل: 20. الأوامر الخاصة. تستند إلى: B (الديباجة والمتن). يُبرهن في: الماكروهات والديباجة الخاصة.
3. البيئات الخاصة. يعرّف \newenvironment الفتح والإغلاق؛ ووسائطه لا توجد إلا في الفتح، و\NewDocumentEnvironment يقبلها في الإغلاق أيضًا.
  تستعمل: 20. الأوامر الخاصة. تستند إلى: C (المضمون والشكل). يُبرهن في: الماكروهات والديباجة الخاصة.
4. الديباجة الخاصة. تُنقل الديباجة إلى ملف يُقرأ بـ \input أو إلى حزمة .sty، لا تفرض الصنف ولا اللغة ولا موضع hyperref.
  تستعمل: 20. الأوامر الخاصة, 21. الأسماء المشغولة والمسافات, 15. الأمر input, 13. الروابط. تستند إلى: F (ترتيب التحميل), C (المضمون والشكل). يُبرهن في: الماكروهات والديباجة الخاصة.

نحو الرياضيات. تتوقّف السلسلة حيث يكتمل المعمار ويبقى ملؤه: المعادلات والمبرهنات المرقّمة، التي سيُحال إليها بوسوم هذه الوحدة، هي موضوع الوحدة التالية.