Projek dengan beberapa fail

Simpan mukadimah dan \begin{document} dalam main.tex dan masukkan fail lain dengan \input{chapters/intro} atau \include{chapters/intro}; Scissor LaTeX menggabungkannya menjadi satu dokumen sebelum mengatur huruf.

Mengapa memecahkan dokumen

Tesis atau laporan panjang lebih mudah diusahakan secara berbahagian: satu fail bagi setiap bab, satu untuk mukadimah, satu untuk lampiran. LaTeX mempunyai dua arahan untuk ini, dan kedua-duanya berfungsi dalam Scissor LaTeX.

Projek kecil

Projek biasa mempunyai fail utama dan satu folder bab:

main.tex
preamble.tex
chapters/intro.tex
chapters/method.tex
refs.bib

Fail utama memuatkan kelas, mukadimah dan isi dokumen, serta memasukkan selebihnya:

\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}

Setiap fail bab hanya memuatkan bahagian teksnya, tanpa mukadimah dan tanpa \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 menggantikan setiap \input dan \include dengan teks fail itu dan mengatur huruf hasilnya sebagai satu dokumen. Label, rujukan dan petikan berfungsi merentasi fail, kerana bagi pengatur huruf semuanya ialah satu teks.

Rupa dokumen yang digabungkan

Inilah yang diatur huruf oleh editor apabila main.tex memasukkan dua fail bab dengan \input: teks kedua-dua fail, mengikut urutan. (Contoh ini ditulis sebagai satu fail supaya ia boleh dipaparkan di sini.) Dalam report atau book, \chapter memulakan setiap bab pada halaman baharu dengan sendirinya.

Dua fail bab, digabungkan menjadi satu dokumen

LaTeXSalinBuka dalam editor (dibuka dalam tab baharu)

\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}

Cara nama fail ditemui

• Laluan adalah relatif kepada folder teratas projek, sama seperti laluan relatif kepada folder fail utama dalam LaTeX, juga di dalam fail bersarang.
• Sambungan .tex boleh ditinggalkan: \input{chapters/intro} menemui chapters/intro.tex.
• Tanda petik di sekeliling nama, seperti dalam \input{"my file"}, dibuang.
• Fail yang tiada disenaraikan sebagai ralat dalam tab Masalah, bersama baris \input itu. Bahagian lain dokumen masih diatur huruf.
• Fail yang memasukkan dirinya sendiri, secara terus atau melalui fail lain, ditinggalkan dengan mesej, dan penyarangan berhenti selepas 24 aras.

subfiles dan \includeonly

Pakej subfiles membolehkan setiap bab dikompil sendiri. Scissor LaTeX tidak mengikut \subfile: arahan itu dilangkau dan tab Masalah menyatakan bahawa satu fail tidak dimasukkan.

\documentclass{article}
\usepackage{subfiles}
\begin{document}
The chapter below is not included:
\subfile{chapters/intro}
Replace it with an \verb|\input| line.
\end{document}

Untuk mengusahakan satu bab pada satu masa, jadikan baris \include yang lain sebagai ulasan dengan %. \includeonly diterima tetapi tidak berkesan: setiap fail yang dimasukkan diatur huruf. Begitu juga dengan \lstinputlisting dan \inputminted, yang dilangkau dengan mesej yang sama (lihat Senarai kod).

Fail lain dalam projek

Imej, fail .bib dan fail data boleh berada dalam mana-mana folder; rujuk kepadanya dengan laluannya dari folder teratas, seperti \includegraphics{figures/plot.png}. Semua fail .bib dalam projek digunakan untuk petikan, tidak kira apa yang dinamakan oleh \bibliography (lihat Bibliografi). Untuk membawa seluruh projek dari pemasangan TeX, lihat Projek dan fail.

Apa yang berbeza daripada pemasangan TeX

Manual pakej yang berkaitan terdapat di CTAN: subfiles dan import.

Setiap contoh di halaman ini disusun atur oleh Scissor LaTeX semasa laman dibina. Kali terakhir dikemas kini 2026-11-07.