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

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

ملخص

يعلّم هذا الدرس كيف يُقسَّم مستند طويل على عدة ملفات دون أن يكفّ عن أن يكون مستندًا واحدًا. فهو يشرح لماذا يحسن تقسيم أطروحة أو كتاب أو مجلد جماعي؛ ويميّز بين \input، الذي يُدرج ملفًا كأن نصه مكتوب في موضعه، و\include، الذي يصفّ فصلًا في صفحات خاصة به ومع ملف مساعد خاص به؛ ويبيّن كيف يترجم \includeonly بعض الفصول فقط مع الحفاظ على الترقيم والإحالات، وبأي شرط يتحقق ذلك؛ ويقترح تنظيمًا للمجلدات ولأسماء الملفات؛ ويعلّم كيف يُعيَّن في Texmaker المستند الأم وكيف نترجم دائمًا انطلاقًا من الملف الرئيسي؛ ويعرض حزمة subfiles لترجمة فصل على حدة؛ ويبسط بنية أطروحة حالةً كاملة؛ ويستعرض أكثر الأخطاء شيوعًا برسائلها الحقيقية.

أهداف التعلم

  1. أن نقرّر، لكل جزء من مستند طويل، أيُدرج بـ \input أم بـ \include، بحسب أثر كل منهما في الصفحات وفي الملفات المساعدة.
  2. أن نتنبأ بالأرقام والصفحات والإحالات التي ينتجها \includeonly، وأن نشرح على أي ترجمة سابقة يتوقف الحفاظ عليها.
  3. أن ننظّم مشروعًا في ملف رئيسي ومجلدات، بمسارات منسوبة إلى الملف الرئيسي وبأسماء ملفات لا تسبّب مشكلات.
  4. أن نضبط Texmaker ليترجم المستند الأم من أي ملف في المشروع، وأن نعدّ بحزمة subfiles فصولًا تُترجم وحدها أيضًا.
  5. أن نتعرّف في ملف السجل على الأخطاء الخاصة بالمستندات المقسّمة، وأن نميّز ما يوقف الترجمة مما يتركها تنتهي بنتيجة ناقصة.

لماذا نقسّم المستند

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

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

ولإدراج جزء أمران، \input و\include، والفرق بينهما ليس فرقًا في الأسلوب: فكلٌّ منهما يفعل بالصفحات وبالملفات المساعدة شيئًا مختلفًا.