ملف جذر واحد وفصول متعددة

الفرق بين include وinput، وincludeonly، وكتابة فصل واحد في كل مرة.

ملف جذر واحد وفصول متعددة

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

الملف الجذر

% main.tex
\documentclass{report}
\begin{document}
\include{chapters/intro}
\include{chapters/methods}
\include{chapters/results}
\end{document}

الملف main.tex هو الملف الوحيد الذي تجمّعه. يسمّي كل أمر \include ملفًا آخر دون امتداد .tex، مع استخدام الشرطة المائلة الأمامية على كل المنصات، ويسحب محتواه عند تلك النقطة. أما ملفات الفصول نفسها فلا تحوي سوى المحتوى، وتبدأ عادةً بـ \chapter{...}. وليس فيها \documentclass ولا بيئة document خاصة بها، لأنها أجزاء من هذا المستند لا مستندات قائمة بذاتها.

الفرق بين include وinput

يتصرف أمرا التضمين بطريقتين مختلفتين، وهذه الاختلافات تحدد أيهما تستخدم وأين. يبدأ \include صفحة جديدة قبل المادة، وهذا يناسب الفصول، ويكتب ملف .aux منفصلًا لكل ملف مضمَّن، وهذا ما يجعل التجميع الانتقائي ممكنًا. أما \input فلصق نصي بسيط: بلا فاصل صفحة ولا ملف .aux منفصل، ويمكن تضمينه داخل \input آخر. وهذا يجعل \input الأداة المناسبة للأجزاء الأصغر من فصل، مثل جدول كبير محفوظ في ملف خاص به أو ملف أوامر الماكرو المشترك. وثمة قاعدة بنيوية تذكّرها: لا يمكن تضمين \include داخل ملف مضمَّن، بينما يمكن استخدام \input في أي مكان.

كتابة فصل واحد في كل مرة

\includeonly{chapters/methods}

عند وضعه في الديباجة، يخبر \includeonly برنامج LaTeX بمعالجة الملفات المذكورة فقط، مع الاستمرار في قراءة بيانات .aux المحفوظة لكل الملفات الأخرى. فيصبح التجميع أسرع بكثير، ولأن تسميات الفصول الأخرى وعدد صفحاتها تُعاد قراءتها من ملفات .aux الخاصة بها، تبقى الإحالات المرجعية والترقيم في الفصل الذي تكتبه صحيحة. وهذا النصف الثاني هو سبب تفضيل هذه الطريقة على تعليق أسطر \include، لأن التعليق ينسى الفصول الأخرى تمامًا ويحوّل كل \ref يشير إليها إلى ??.

علّق السطر \includeonly عند البناء الكامل، وشغّل دائمًا تجميعًا كاملًا قبل مشاركة ملف PDF، لأن بيانات .aux القديمة قد تتخلف عن التعديلات التي أُجريت في الفصول المستبعدة. ولمعرفة أي ملفات المجلد الناتج هي ملفاتك وأيها يُنشأ تلقائيًا، راجع الملفات في مشروع حقيقي.

العودة إلى المستندات الطويلة