پروژه‌های چندفایلی

مقدمهٔ سند و \begin{document} را در main.tex نگه دارید و فایل‌های دیگر را با \input{chapters/intro} یا \include{chapters/intro} وارد کنید؛ Scissor LaTeX پیش از حروف‌چینی آن‌ها را در یک سند به هم می‌پیوندد.

چرا یک سند را تقسیم کنیم

کار روی یک پایان‌نامه یا گزارش طولانی به‌صورت تکه‌تکه آسان‌تر است: یک فایل برای هر فصل، یکی برای مقدمهٔ سند، یکی برای پیوست. LaTeX برای این کار دو دستور دارد و هر دو در Scissor LaTeX کار می‌کنند.

یک پروژهٔ کوچک

یک پروژهٔ معمولی یک فایل اصلی و یک پوشه از فصل‌ها دارد:

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 خودش هر فصل را در صفحهٔ تازه‌ای شروع می‌کند.

دو فایل فصل، به‌هم‌پیوسته در یک سند

LaTeXکپیباز کردن در ویرایشگر (در زبانه‌ای تازه باز می‌شود)

\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. بقیهٔ سند همچنان حروف‌چینی می‌شود.
• فایلی که خودش را، مستقیم یا از طریق فایل‌های دیگر، وارد کند با یک پیام کنار گذاشته می‌شود، و تودرتویی پس از ۲۴ سطح متوقف می‌شود.

subfiles و \includeonly

بستهٔ subfiles اجازه می‌دهد هر فصل به‌تنهایی کامپایل شود. Scissor LaTeX دنبال \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}

برای کار روی یک فصل در هر بار، خط‌های \include دیگر را با % به توضیح تبدیل کنید. \includeonly پذیرفته می‌شود اما اثری ندارد: هر فایل واردشده حروف‌چینی می‌شود. همین برای \lstinputlisting و \inputminted هم صدق می‌کند که با همان پیام نادیده گرفته می‌شوند (فهرست‌های کد را ببینید).

فایل‌های دیگر پروژه

تصویرها، فایل‌های .bib و فایل‌های داده می‌توانند در هر پوشه‌ای باشند؛ با مسیرشان از پوشهٔ بالایی به آن‌ها ارجاع دهید، مانند \includegraphics{figures/plot.png}. همهٔ فایل‌های .bib پروژه برای استنادها به کار می‌روند، هر نامی که \bibliography ببرد (کتاب‌نامه‌ها را ببینید). برای آوردن یک پروژهٔ کامل از یک نصب TeX، پروژه‌ها و فایل‌ها را ببینید.

تفاوت‌ها با یک نصب TeX

راهنماهای بسته‌های مرتبط در CTAN هستند: subfiles و import.

هر مثال این صفحه هنگام ساخت سایت با Scissor LaTeX حروف‌چینی می‌شود. آخرین به‌روزرسانی: 2026-11-07.