ملف جذر واحد، العديد من الفصول

تصبح الأطروحة الموجودة في ملف 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 صفحة جديدة قبل المادة، وهو ما يناسب الفصول، ويكتب ملف .aux منفصل لكل ملف مضمن، وهو ما يجعل التجميع الانتقائي ممكنًا. \input عبارة عن لصق نصي عادي: لا يوجد فاصل صفحات، ولا يوجد .aux منفصل، ويمكن دمجه داخل إدخال آخر. وهذا يجعل \input الأداة المناسبة للأجزاء الأصغر من الفصل، مثل جدول كبير محفوظ في ملف خاص به أو [ملف وحدات الماكرو] مشترك (/learn/custom-commands/). إحدى القواعد الهيكلية التي يجب تذكرها هي أنه لا يمكن تضمين \include داخل ملف مضمن، بينما يمكن استخدام \input في أي مكان.

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

\includeonly{chapters/methods}

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

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