I am working on a multi-chaptered document, tied together with a main tex file that pulls the chapters in via \include. To build the entire document, in its current draft form, can take upwards of 15-20 minutes, depending on the machine I am working on. I am wondering if there is a way that I could choose to typeset only one specific chapter at a time without having to restructure my whole setup. Any ideas?

  • 1
    Use \includeonly in the preamble. Done! – xport Jan 6 '11 at 16:31
  • 15-20 minutes!? That seems like an awfully long time. What's in this book? – Seamus Jan 6 '11 at 16:37
  • 1
    Hah, about 7 gazillion figures. It seems to bog down most when I include the image-heavy chapters. – Matthew Ryan Dillon Jan 6 '11 at 17:01
  • 4
    @mrdillion: you do not need to insert all the figures every time! If only text chnages are important use draft as optional argument for the documentclass or alternatively as option for \includegraphics for single big images and change it in a final run to final or simply delete the draft option. – user2478 Jan 6 '11 at 17:06
  • 1
    @Seamus: The Metafun manual used to take 10-15 minutes to compile with pdftex. But most of the time was spent in generating metapost figures. With luatex, it takes around 3 minutes. – Aditya Mar 28 '11 at 22:17

If you are using \include for your chapters, then you can use \includeonly to include just specific chapters.


\includeonly{Chap2} % will cause just Chap 2 to be included

  • 2
    or altenatively also \excludeonly which needs the package of the same name. – user2478 Jan 6 '11 at 16:37

Include all chapters in the body using \include macro (to make cross references work properly) and specify the chapter to be rendered using \includeonly in the preamble.

Cross references will still work properly even thought you just render only one chapter.

  • 4
    You have to run at least one time all chapters to create the auxiliary files. – user2478 Jan 6 '11 at 16:40

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.