مشاريع من عدة ملفات
احتفظ بالتمهيد و\begin{document} في main.tex واستدعِ الملفات الأخرى باستخدام \input{chapters/intro} أو \include{chapters/intro}؛ يدمجها Scissor LaTeX في مستند واحد قبل أن ينضّده.
لماذا تقسّم المستند
العمل على أطروحة أو تقرير طويل أسهل حين يكون على أجزاء: ملف لكل فصل، وملف للتمهيد، وملف للملحق. في LaTeX أمران لهذا الغرض، وكلاهما يعمل في Scissor LaTeX.
| الأمر | ما الذي يفعله | في Scissor LaTeX |
|---|---|---|
\input{file} | يضع نص الملف هنا تمامًا، كأنك كتبته بنفسك. | يعمل، في التمهيد أيضًا وبشكل متداخل. |
\include{file} | يبدأ صفحة جديدة، ويضع نص الملف هنا، ثم ينهي الصفحة. | يعمل. فواصل الصفحات المتتالية تصبح فاصلًا واحدًا، فلا تظهر صفحات فارغة. |
\includeonly{a,b} | يستبعد كل \include غير موجود في القائمة. | يُتجاهل: تُضمَّن كل الملفات. |
\subfile{file} (subfiles) | مثل \input، لملفات تُترجم وحدها أيضًا. | غير مدعوم: يُتخطّى مع رسالة. استخدم \input. |
\import{dir/}{file} (import) | \input نسبةً إلى مجلد آخر. | غير مدعوم: يُتخطّى مع رسالة. |
مشروع صغير
يحتوي المشروع النموذجي على ملف رئيسي ومجلد للفصول:
main.tex
preamble.tex
chapters/intro.tex
chapters/method.tex
refs.bibيحتوي الملف الرئيسي على الصنف والتمهيد ومتن المستند، ويستدعي الباقي:
\documentclass{report}
\input{preamble}
\title{Rainfall at Two Sites}
\author{Erika Mustermann}
\begin{document}
\maketitle
\input{chapters/intro}
\input{chapters/method}
\bibliographystyle{plain}
\bibliography{refs}
\end{document}ويحتوي كل ملف فصل على جزئه من النص فقط، بلا تمهيد وبلا \begin{document}:
\chapter{Introduction}
\label{chap:intro}
Rain gauges were read every morning for 44 days.
The method is described in Chapter~\ref{chap:method}.يستبدل Scissor LaTeX كل \input و\include بنص الملف وينضّد النتيجة مستندًا واحدًا. وتعمل التسميات والإحالات والاستشهادات عبر الملفات، لأن النص كله بالنسبة إلى المنضِّد نص واحد.
كيف يبدو المستند المدمج
هذا ما ينضّده المحرر حين يستدعي main.tex ملفي فصلين باستخدام \input: نص الملفين بالترتيب. (كُتب المثال ملفًا واحدًا ليمكن عرضه هنا.) وفي report أو book يبدأ \chapter كل فصل في صفحة جديدة من تلقاء نفسه.
ملفا فصلين مدمجان في مستند واحد
\documentclass{report}
\begin{document}
\chapter{Introduction}
\label{chap:intro}
Rain gauges were read every morning for 44 days.
The method is described in Chapter~\ref{chap:method}.
\chapter{Method}
\label{chap:method}
Each gauge was emptied after reading, as noted in
Chapter~\ref{chap:intro}.
\end{document}
كيف تُعثر أسماء الملفات
- المسارات نسبية إلى المجلد الأعلى للمشروع، كما هي نسبية إلى مجلد الملف الرئيسي في LaTeX، حتى داخل الملفات المتداخلة.
- يمكن حذف الامتداد
.tex: يجد\input{chapters/intro}الملفchapters/intro.tex. - تُزال علامات الاقتباس حول الاسم، كما في
\input{"my file"}. - يُدرج الملف المفقود خطأً في تبويب المشكلات، مع سطر
\input. ويُنضَّد باقي المستند مع ذلك. - الملف الذي يضمّن نفسه، مباشرةً أو عبر ملفات أخرى، يُستبعد مع رسالة، ويتوقف التداخل بعد 24 مستوى.
حزمة subfiles والأمر \includeonly
تتيح حزمة subfiles ترجمة كل فصل وحده. لا يتبع Scissor LaTeX الأمر \subfile: يُتخطّى الأمر ويذكر تبويب المشكلات أن ملفًا لم يُضمَّن.
الأمر \subfile لا يُتبَع
\documentclass{article}
\usepackage{subfiles}
\begin{document}
The chapter below is not included:
\subfile{chapters/intro}
Replace it with an \verb|\input| line.
\end{document}تبويب المشكلات: 1 included file is not part of this conversion
للعمل على فصل واحد في كل مرة، علّق على أسطر \include الأخرى باستخدام %. يُقبل \includeonly لكن لا أثر له: يُنضَّد كل ملف مضمَّن. والأمر نفسه ينطبق على \lstinputlisting و\inputminted، اللذين يُتخطّيان مع الرسالة نفسها (انظر قوائم الشيفرة).
ملفات أخرى في المشروع
يمكن أن توجد الصور وملفات .bib وملفات البيانات في أي مجلد؛ أشِر إليها بمسارها من المجلد الأعلى، مثل \includegraphics{figures/plot.png}. وتُستخدم كل ملفات .bib في المشروع للاستشهادات، أيًّا كان ما يسمّيه \bibliography (انظر قوائم المراجع). ولجلب مشروع كامل من تثبيت TeX، انظر المشاريع والملفات.
ما الذي يختلف عن تثبيت TeX
أدلة الحزم ذات الصلة متاحة على CTAN: subfiles وimport.
أسئلة وأجوبة
ما الفرق بين \input و\include؟
يلصق \input نص الملف في مكانه. أما \include فيبدأ أيضًا صفحة جديدة وينهيها حوله، ويعمل في تثبيت TeX مع \includeonly. في Scissor LaTeX يصلح كلاهما للفصول؛ ويُتجاهل \includeonly، فيُنضَّد كل \include.
لماذا لا يُعثر على ملف \input الخاص بي؟
تحقق من المسار انطلاقًا من المجلد الأعلى للمشروع ومن التهجئة، بما في ذلك الحروف الكبيرة. يعرض تبويب المشكلات الاسم الذي بحث عنه وسطر \input.
هل تعمل حزمة subfiles في Scissor LaTeX؟
لا. استبدل \subfile{...} بـ \input{...}؛ وعندها لا تحتاج ملفات الفصول إلى تمهيد خاص بها.
كل مثال في هذه الصفحة ينضّده Scissor LaTeX عند بناء الموقع. آخر تحديث: 2026-11-07.