Перейти до вмісту

Проєкти з кількох файлів

Тримайте преамбулу й \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 відносно іншої папки.Не підтримується: пропускається з повідомленням.

Невеликий проєкт

Типовий проєкт має головний файл і папку з розділами:

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

Головний файл містить клас, преамбулу й тіло документа та підключає решту:

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

LaTeX
\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}
Зверстано в Scissor LaTeX: Два файли розділів, об'єднані в один документ
Сторінка 2

Як знаходяться назви файлів

  • Шляхи задаються відносно верхньої папки проєкту, так само як у 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.