انتقل إلى المحتوى
Topos Uranos
العربية

الخطوات الأولى: الخلاصة والتحديات

ملخص

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

أهداف التعلم

  1. إعادة بناء ترتيب مفاهيم الوحدة وإجراءاتها، مع تحديد المبدأ الذي يستند إليه كلٌّ منها.
  2. شرح العلاقة بين قواعد قراءة الملف المصدري وتشريحه ورسائل ملف السجل.
  3. التمييز بين ما أرسته الوحدة وما اكتفت بالإشارة إليه مما ستطوّره الوحدات التالية.
  4. تشخيص مستندات تفشل لأسباب عدّة في آن واحد، وترتيب التصحيحات وفق ملف السجل.
  5. تخطيط ديباجة المستند ومتنه انطلاقًا من وصف ما يجب أن يتضمّنه.

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

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

ما LaTeX

انطلق درس ما LaTeX من التنضيد الطباعي، أي مجموع القرارات التي ترتّب كل حرف وكل سطر وكل صفحة، ومن المتطلّبات الخاصة بالنصوص الأكاديمية. واستنتج منها جدوى لغة ترميز، يصرّح فيها المؤلف بماهية كل شيء ويقرّر صنف المستند كيف يبدو: الفصل بين المضمون والشكل، الذي يتكرّر في الوحدة كلها. ثم ميّز بين المحرّكات الثلاثة واختار LuaLaTeX، الذي يقرأ Unicode ويحمّل خطوط النظام؛ وحدّد القواعد الثلاث التي يقرأ بها المحرّك الملف المصدري (المسافات المتكرّرة تُحسب واحدة، والسطر الفارغ ينهي الفقرة، وعلامة النسبة المئوية تبدأ تعليقًا)، ووصف دورة الكتابة والترجمة والقراءة، مع ملف السجل والملف المساعد اللذين تخلّفهما كل ترجمة.

بيئة العمل

حوّل درس بيئة العمل ذلك الوصف إلى تثبيت: توزيعة، TeX Live أو MiKTeX أو MacTeX، مع مدير حزمها؛ وTexmaker، مضبوطًا ليترجم بـLuaLaTeX ويحفظ بترميز UTF-8 ويزامن الملف المصدري مع PDF؛ وOverleaf، الذي ينبغي تغيير مترجمه الافتراضي في كل مشروع. وأرسى كذلك قاعدة مجلد لكل مشروع، والتمييز بين ما يكتبه المؤلف وما تعيد الترجمة توليده، والأسباب الثلاثة التي قد تجعل ملف PDF لا يتغيّر: خطأ جسيم يمنع كتابته، وعارض يقفله أو لا يعيد تحميله، وترجمة ملف آخر.

تشريح المستند

شرح درس تشريح المستند قطعةً قطعة ما كان المستند الأدنى يقدّمه وصفةً جاهزة. فالديباجة تضبط والمتن ينضّد، لأن الضبط يُغلق عند الوصول إلى \begin{document}. وتنقسم الأوامر إلى كلمات تحكّم، ينتهي اسمها عند أول محرف ليس حرفًا وتبتلع المسافة التالية، ورموز تحكّم لا تبتلعها؛ وتتلقّى وسائط إلزامية بين حاصرتين ووسائط اختيارية بين قوسين معقوفين، ولبعضها صيغة بنجمة. والتصريحات تسري حتى نهاية المجموعة التي تحتويها، والبيئات، وهي مجموعات، يجب أن تُغلق بعكس ترتيب فتحها. والمحارف المحجوزة العشرة تفعل شيئًا بدل أن تُطبع، ولكلٍّ منها طريقته في الطباعة. وتُتمّ الحزمُ والصنفُ، بخياراتها، البنيةَ.

الترجمة وتصحيح الأخطاء

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

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

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

  • Aالملفات والمجلدات. التعامل المعتاد مع الملفات والمجلدات في الحاسوب: إنشاؤها وتسميتها والعثور عليها ونسخها وتمييزها بامتداداتها. يُفترض أنه معلوم منذ المقدمة. يُقبل دون برهان في هذه الوحدة.
  • Bالمضمون والشكل. يصرّح المؤلف بماهية كل شيء، ويقرّر صنف المستند والديباجة كيف يبدو. تثبت في: 2. لغة الترميز.
  • CUnicode والخطوط. يقرأ LuaLaTeX الملف المصدري بـUnicode، محفوظًا بترميز UTF-8، ويحمّل خطوط النظام؛ والمحرف الذي لا يحتويه الخط لا يوقف الترجمة، لكنه يغيب عن PDF. تثبت في: 3. المحرّكات وLuaLaTeX.
  • Dملف السجل. تدوّن كل ترجمة في ملف السجل ما فعلته، بأخطائها وتحذيراتها؛ وهو أول ما يُقرأ حين يفشل شيء. تثبت في: 5. الملف المصدري والترجمة وPDF.
  • Eالمجموعات والنطاق. يسري التصريح حتى نهاية المجموعة التي تحتويه؛ والحاصرتان والبيئات تفتح مجموعات يجب أن تُغلق بعكس ترتيب فتحها. تثبت في: 12. المجموعات والبيئات.
  • Fالمحارف المحجوزة. عشرة محارف تفعل شيئًا بدل أن تُطبع؛ فإذا كُتبت كما هي في النص أحدثت خطأً أو أثرًا لا يُلحظ. تثبت في: 13. المحارف المحجوزة.
  • Gالخطأ الأول. ليتعافى المحرّك من خطأ يخمّن، وقد تولّد تخميناته أخطاءً جديدة؛ ولا يطابق الملفَّ المصدري يقينًا إلا الأول. تثبت في: 16. قراءة الخطأ.

  1. المقطع 1 ما LaTeX

    • شرح ماهية التنضيد الطباعي ولماذا تقتضيه النصوص الأكاديمية.
    • فصل المضمون عن الشكل بواسطة لغة ترميز.
    • اختيار المحرّك بحسب اللغات والكتابات والخطوط، وتعليل اختيار LuaLaTeX.
    • التنبّؤ بما ينتجه ملف مصدري وفق قواعد المسافات والفقرات والتعليقات.

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

      يُبرهن في: ما هو LaTeX؟.

    2. لغة الترميز. في LaTeX، وهو مجموعة من الماكروهات مكتوبة فوق TeX، يرمّز المؤلف المضمون في ملف نصّي بسيط، ويُستمدّ الشكل من الصنف والديباجة.

      تستعمل: 1. التنضيد الطباعي. يُبرهن في: ما هو LaTeX؟.

    3. المحرّكات وLuaLaTeX. يفهم pdfLaTeX وXeLaTeX وLuaLaTeX اللغة نفسها، لكن الأخيرين وحدهما يقرآن Unicode ويحمّلان خطوط النظام؛ والمقرر يستعمل LuaLaTeX.

      تستعمل: 2. لغة الترميز. يُبرهن في: ما هو LaTeX؟.

    4. المسافات والفقرات والتعليقات. المسافات المتعدّدة تُحسب واحدة، وفاصل السطر يُحسب مسافة؛ والسطر الفارغ ينهي الفقرة؛ وعلامة النسبة المئوية تجعل بقية السطر تعليقًا، مع فاصله.

      تستعمل: 2. لغة الترميز. يُبرهن في: ما هو LaTeX؟.

    5. الملف المصدري والترجمة وPDF. يُكتب الملف المصدري، ويترجمه المحرّك، ويُقرأ PDF؛ وبجانبه يبقى ملف السجل والملف المساعد.

      تستعمل: 3. المحرّكات وLuaLaTeX. تستند إلى: A (الملفات والمجلدات). يُبرهن في: ما هو LaTeX؟.

  2. المقطع 2 بيئة العمل

    • اختيار توزيعة ونوع تثبيت بحسب النظام والمساحة والاتصال.
    • ضبط Texmaker وOverleaf للترجمة بـLuaLaTeX.
    • تنظيم كل مشروع في مجلده وتقرير الملفات التي تُحفظ.
    • شرح لماذا قد لا يتغيّر ملف PDF بعد تصحيح.

    1. التوزيعة والحزم. تجمع التوزيعة المحرّكات والحزم والخطوط ومديرًا يثبّت ما ينقص: TeX Live أو MiKTeX أو MacTeX، كاملة أو أساسية.

      تستعمل: 3. المحرّكات وLuaLaTeX. تستند إلى: A (الملفات والمجلدات). يُبرهن في: بيئة العمل.

    2. Texmaker وOverleaf. يُضبط Texmaker ليترجم بـLuaLaTeX ويحفظ بترميز UTF-8 ويزامن الملف المصدري مع PDF؛ وفي Overleaf يُختار LuaLaTeX في كل مشروع.

      تستعمل: 5. الملف المصدري والترجمة وPDF, 6. التوزيعة والحزم. تستند إلى: C (Unicode والخطوط). يُبرهن في: بيئة العمل.

    3. المجلد والملفات المساعدة. لكل مستند مجلده؛ يُحفظ ما كتبه المؤلف أو أضافه، ويمكن حذف الملفات المساعدة التي تعيد الترجمة توليدها.

      تستعمل: 5. الملف المصدري والترجمة وPDF, 7. Texmaker وOverleaf. تستند إلى: A (الملفات والمجلدات). يُبرهن في: بيئة العمل.

    4. ملف PDF الذي لا يتغيّر. إذا لم يتغيّر PDF، فإما أن الترجمة لم تكتبه، وإما أن العارض يقفله أو لا يعيد تحميله، وإما أن ملفًا آخر قد تُرجم؛ ويحسم ذلك ملف السجل ووقت PDF.

      تستعمل: 8. المجلد والملفات المساعدة, 7. Texmaker وOverleaf. تستند إلى: D (ملف السجل). يُبرهن في: بيئة العمل.

  3. المقطع 3 تشريح المستند

    • التمييز بين الديباجة والمتن وتقرير موضع كل أمر.
    • تعرّف أجزاء الأمر والتنبّؤ بموضع انتهاء اسمه.
    • التنبّؤ بنطاق التصريحات وتداخل البيئات تداخلًا صحيحًا.
    • طباعة المحارف المحجوزة العشرة وشرح ما تفعله بلا حماية.

    1. الديباجة والمتن. تحمّل الديباجة الحزم وتتّخذ القرارات دون أن تنضّد شيئًا؛ والمتن هو الموضع الوحيد الذي يُنضَّد فيه؛ وما يعرّف أو يحفظ فحسب يجوز في الموضعين، والأفضل في الديباجة.

      تستعمل: 5. الملف المصدري والترجمة وPDF. تستند إلى: B (المضمون والشكل). يُبرهن في: تشريح المستند.

    2. الأوامر. كلمة التحكّم تنتهي عند أول محرف ليس حرفًا وتبتلع المسافة التالية؛ ورمز التحكّم محرف واحد ولا يبتلعها؛ والوسائط تُكتب بين حاصرتين أو بين قوسين معقوفين.

      تستعمل: 4. المسافات والفقرات والتعليقات. يُبرهن في: تشريح المستند.

    3. المجموعات والبيئات. يسري التصريح حتى نهاية مجموعته؛ والبيئات مجموعات، وما فُتح منها داخل أخرى يُغلق قبلها.

      تستعمل: 11. الأوامر. تستند إلى: B (المضمون والشكل). يُبرهن في: تشريح المستند.

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

      تستعمل: 11. الأوامر, 4. المسافات والفقرات والتعليقات. يُبرهن في: تشريح المستند.

    5. الحزم والصنف. توسّع الحزم ما يعرف LaTeX فعله ولا تُحمَّل إلا في الديباجة؛ والصنف، بخياراته، يحدّد الشكل العام للمستند.

      تستعمل: 10. الديباجة والمتن, 6. التوزيعة والحزم. تستند إلى: B (المضمون والشكل). يُبرهن في: تشريح المستند.

  4. المقطع 4 الترجمة وتصحيح الأخطاء

    • شرح حاجة الإحالات والفهرس إلى تمريرة أخرى، والترجمة بـlatexmk.
    • قراءة خطأ في ملف السجل: رسالته وسطره وموضع اكتشافه.
    • ربط أكثر الأخطاء شيوعًا بأسبابها المحتملة.
    • تحديد السبب الحقيقي لخطأ باستراتيجية منظّمة، وتقرير أيّ التحذيرات يستحق العناية.

    1. التمريرات وlatexmk. في كل تمريرة يدوّن المحرّك في الملفات المساعدة أرقامًا وعناوين تستعملها التمريرة التالية؛ ويكرّر latexmk التمريرات حتى لا يتغيّر شيء.

      تستعمل: 8. المجلد والملفات المساعدة. تستند إلى: D (ملف السجل). يُبرهن في: الترجمة وتصحيح الأخطاء.

    2. قراءة الخطأ. يُعرف الخطأ بسطر علامة التعجّب؛ والسطر الذي يبدأ بـ l. يعطي رقم سطر الملف المصدري، مقسومًا إلى ما قُرئ وما بقي.

      تستعمل: 9. ملف PDF الذي لا يتغيّر, 11. الأوامر. تستند إلى: D (ملف السجل). يُبرهن في: الترجمة وتصحيح الأخطاء.

    3. الأخطاء الشائعة. أوامر أو بيئات غير معرَّفة، وصيغ لم تُفتح، وحاصرات لا تتطابق، وملفات مفقودة، ونص في الديباجة: كل رسالة تفضح مخالفة قاعدة من قواعد تشريح الملف المصدري.

      تستعمل: 16. قراءة الخطأ, 10. الديباجة والمتن, 12. المجموعات والبيئات, 13. المحارف المحجوزة, 14. الحزم والصنف. تستند إلى: E (المجموعات والنطاق), F (المحارف المحجوزة). يُبرهن في: الترجمة وتصحيح الأخطاء.

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

      تستعمل: 17. الأخطاء الشائعة, 4. المسافات والفقرات والتعليقات, 8. المجلد والملفات المساعدة. تستند إلى: D (ملف السجل), E (المجموعات والنطاق), G (الخطأ الأول). يُبرهن في: الترجمة وتصحيح الأخطاء.

    5. التحذيرات. لا توقف التحذيرات الترجمة، لكن بعضها يقتضي التصرّف: إحالات غير معرَّفة، وطلبات إعادة الترجمة، وأسطر تبرز عن الهامش، ومحارف مفقودة.

      تستعمل: 15. التمريرات وlatexmk, 16. قراءة الخطأ. تستند إلى: C (Unicode والخطوط), D (ملف السجل). يُبرهن في: الترجمة وتصحيح الأخطاء.

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