[Tex/LaTex] Problem using \includeonly

compilingcross-referencingexternal filesincludesubfiles

I have a problem using the \includeonly command. I have a large document and I wanted to split it up into sections- each section would be in its own file and I would compile only the current chapter that I am working on. The ideal case (please suggest if you know how to do this) would be to have the full document appear in the produced PDF, but only the current section's contents be updated as I do the compilations (such that it does not take a long time to compile everything). Anyhow, I have the following document structure:

\documentclass[twocolumn]{article}

\usepackage{newclude}

\includeonly{11_bayesiandecisionmaking}

\begin{document}

\include*{01_introduction}
\include*{02_probability1}
\include*{03_probability2}
\include*{04_statistics}
\include*{05_RS_FOSM}

\include*{11_bayesiandecisionmaking}

\end{document}

I was promised that using \include the references to equations in other files that are not cited in \includeonly (e.g. 02_probability1) would be maintained so I should not get the (??) missing reference symbols. However, this is what is happening to me right now – only 11_bayesiandecisionmaking contents appear in the compiled PDF and all references to other files that are not "included" are missing (I get (??)). Do you know how to fix this? Even better, do you know how to include all of the chapters in the final PDF but only compile selectively, e.g. only 11_bayesiandecisionmaking? Thanks for helping!

Best Answer

The first run must see all included files to get the aux files of each included one:

\documentclass[twocolumn]{article}
%\includeonly{11_bayesiandecisionmaking}
\begin{document}

\include{01_introduction}
\include{02_probability1}
\include{03_probability2}
\include{04_statistics}
\include{05_RS_FOSM}

\include{11_bayesiandecisionmaking}

\end{document}

Now you can enable the \includeonly. Then it can load all existing aux files.

Related Solutions

[Tex/LaTex] TeXworks: Compile only current document with \includeonly

It isn't exactly what I was asking for, but I does the job quite well for me. It uses Lua to determine the file that was changed last (so usually the file I am currently editing) and writes \includeonly{file} to the preamble.

includeonlylastmodified.lua

require "lfs"

function mtimesort(a,b)
   return lfs.attributes(a..'.tex',"modification")



main.tex:

\documentclass{article}

\directlua{
   files = {'part1','part2'}
   dofile('includeonlylastmodified.lua')
}

\begin{document}
\include{part1}
\include{part2}
\end{document}

[Tex/LaTex] subimport and includeonly

Here's the outline of a structure I've grown over the years.

Each chapter has a well named directory containing contents.tex and any other needed files for that chapter.

In my preamble, macros.tex:

% placeholders for commands often renewed
\newcommand{\here}{here}
\newcommand{\mychaptername}{whatever}

In the main driver, book.tex:

\include{macros}

%%-%%
%\includeonly{
%Preface/contents,
%FermiProblems/contents,
% ...
%}
%
\begin{document}

\renewcommand{\here}{Preface}
\renewcommand{\mychaptername}{Preface}
\include{\here/contents}

\renewcommand{\here}{FermiProblems}
\renewcommand{\mychaptername}{Calculating on the Back of an Envelope}
\include{\here/contents}

 % and so on ...

Then, in a typical contents.tex

% FermiProblems/contents.tex
%
\chapter{\mychaptername}
\label{\here}
% ...
\includegraphics[width=40mm]{\here/fermi_stamp.jpg}
% ...
\begin{mytikz}
\input{\here/carbonfootprint}
\end{mytikz}
% ...

Remembering to use \here for files referenced from contents.tex takes care of finding those files in the current directory.

Since there are only a dozen or so chapters and they change infrequently, cutting and pasting the three line block of code for each chapter is easier than writing a macro to do the job.

I've found this structure to be pretty robust. There's a lot more in my preamble, and adding even some complex functionality (writing selected material to other files for later compilation) can be managed from one place.

For a large project you're just beginning, I recommend wrapping some standard LaTeX constructs (e.g. the mytikz environment above) with your own macros, so that you can change their behavior later with less wizardry and hence fewer questions on this site.

Edit: To compile just one chapter, use the following driver in the chapter directory.

\documentclass[pdftex,12pt]{book}

\input{../macros}

\begin{document}
\renewcommand{\here}{.}
\renewcommand{\mychaptername}{Test}
\include{\here/contents}
\end{document}

Best Answer

Related Solutions

[Tex/LaTex] TeXworks: Compile only current document with \includeonly

[Tex/LaTex] subimport and includeonly

Related Question