|
Size: 4073
Comment:
|
Size: 3791
Comment:
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 3: | Line 3: |
| = LaTeX-files for large documents (version for Texstudio)= This is a description of a folder and file structure for documents of the types books, reports and similar with several chapters. The idea is that you should be able to work on one chapter at a time and still get all numbering and cross-referencing correct all the time. The proposed structure might seem complex, with several small help files and on different levels, but it's probably not possible to simplify and still be able to tex the whole book and individual chapters without having to switch between the two and edit the text. |
= LaTeX-files for large documents = This is a description of a folder and file structure for documents such as books, theses, reports and similar with several chapters. The idea is that you should be able to work on one chapter at a time and still get all numbering and cross-referencing correct all the time. The proposed structure might seem complex, with files on different levels, but it's probably not possible to simplify and still be able to tex the whole book and individual chapters without having to switch between the two and edit the text. |
| Line 6: | Line 6: |
| The book in the example is supposed to describe the capitals of Europe and hence the main folder is called {{{ Capitals, }}} and the main file {{{ Capitals/Capitals.tex. }}} | The important commands to acheive this are {{{\include{} }}}and {{{\includeonly{}}}}, which are described in [[https://en.wikibooks.org/wiki/LaTeX/Modular_Documents#Using_.5Cincludeonly|the LaTeX wikibook]] or the LaTeX book. The book in the example is supposed to describe the capitals of Europe and hence the main folder is called {{{ Capitals}}}, and the main file {{{Capitals/Capitals.tex}}}. |
| Line 10: | Line 12: |
| Note that they're not named {{{chap1}}} and {{{chap2}}}. This is so you can easily rearrange the order of the chapters without having to change names. Additionally, there are two subfolders more: one for texing the whole book, {{{EntireBook,}}} and one for title pages, forewords, Table of Contents etc., with the name {{{Frontmatter.}}} |
Note that they are not named {{{chap1}}} and {{{chap2}}}. This is so you can easily rearrange the order of the chapters without having to change names. There is also another subfolder with the name {{{Frontmatter}}}, intended for title pages, forewords, Table of Contents etc. |
| Line 17: | Line 19: |
| \documentclass{avhandling} \newcommand\topdir{..} \newcommand\thisdir{\topdir} % Will be changed in the chapters \input{includeonly} % To be explained later |
\documentclass{LTHthesis} \newcommand\thisdir{.} % Will be changed in the chapters |
| Line 22: | Line 22: |
| \bibliographystyle{LongLabels} | \addbibresource{europe.bib} % and other preamble commands \includeonly{% % The percents are important. See comments below. Frontmatter/Frontmatter, London/London, Madrid/Madrid, } |
| Line 24: | Line 31: |
| \include{\topdir/Frontmatter/Frontmatter} \include{\topdir/London/London} \include{\topdir/Madrid/Madrid} |
\include{Frontmatter/Frontmatter} \include{London/London} \include{Madrid/Madrid} |
| Line 30: | Line 37: |
| {{{Capitals/London/}}} contains at least three tex-files: | {{{Capitals/London/}}} contains at least one tex-file, {{{London.tex}}}, and possibly a subdirectory {{{figures}}}. |
| Line 32: | Line 39: |
| {{{ includeonly.tex, London.tex, Capitals.tex }}} * includeonly.tex: {{{ \includeonly{\topdir/London/London} }}} |
|
| Line 40: | Line 41: |
| \renewcommand\thisdir{\topdir/London} | \renewcommand\thisdir{London} |
| Line 43: | Line 44: |
| % Local Variables: % TeX-master: "Capitals" % End: }}} * Capitals.tex: {{{ \input{../Capitals} |
\begin{figure} \includegraphics{\figdir/ImageOfLondon} \caption{London Skyline} \end{figure} |
| Line 53: | Line 50: |
| {{{ Capitals/Madrid/ }}} contains at least three tex-files: | {{{ Capitals/Madrid/ }}} contains at least one tex-file, {{{Madrid.tex}}} and possibly a subdirectory {{{figures}}}. |
| Line 55: | Line 52: |
| {{{ includeonly.tex, Madrid.tex, Capitals.tex}}} * includeonly.tex: {{{ \includeonly{\topdir/Madrid/Madrid} }}} |
|
| Line 69: | Line 58: |
| % Local Variables: % TeX-master: "Capitals" % End: }}} * Capitals.tex: {{{ \input{../Capitals} |
|
| Line 81: | Line 62: |
| {{{ Capitals/EntireBook/ }}} should be used when you want to tex the whole book. It contains two files | == Some comments == The statement {{{\includeonly ...}}} has this special layout so that it will be easy to comment out all chapters except the one you specifically want to work with. You can then type {{{latex Capitals}}}, and only the desired chapter will be processed, but all numbering and cross-references will still be correct. |
| Line 83: | Line 65: |
| * includeonly.tex: This file should be empty. * Capitals.tex: This is like the corresponding file in the chapters. == Some comments == The purpose of all of this is so you can go to any chapter and type the command {{{latex Capitals. }}} Only this chapter will be processed, but all numbering and cross-references will still be correct. The parts {{{% Local Variables}}} above are intended for AUC-tex and are described in its manual, the chapter 'Multifile Documents'. You can tex a chapter directly from XEmacs without having to change buffer. |
Both Texmaker and Texstudio have the possibility to specify a 'Master File', in this case {{{Capitals.tex}}}, such that even if you work with {{{London.tex}}}, the build command will be for the main file, {{{Capitals.tex}}} |
| Line 93: | Line 68: |
On Unix, you can exchange the file {{{Capitals.tex}}} in the different chapters with symbolic links, but the method described here also works on Windows. |
LaTeX-files for large documents
This is a description of a folder and file structure for documents such as books, theses, reports and similar with several chapters. The idea is that you should be able to work on one chapter at a time and still get all numbering and cross-referencing correct all the time. The proposed structure might seem complex, with files on different levels, but it's probably not possible to simplify and still be able to tex the whole book and individual chapters without having to switch between the two and edit the text.
The important commands to acheive this are \include{} and \includeonly{}, which are described in the LaTeX wikibook or the LaTeX book.
The book in the example is supposed to describe the capitals of Europe and hence the main folder is called Capitals, and the main file Capitals/Capitals.tex.
There are two chapters so far, and therefore two sub-folders, which are named Madrid and London. Note that they are not named chap1 and chap2. This is so you can easily rearrange the order of the chapters without having to change names. There is also another subfolder with the name Frontmatter, intended for title pages, forewords, Table of Contents etc. Additional comments come after the descriptions of the files.
Capitals/ contains a tex-file, Capitals.tex.
- Capitals.tex:
\documentclass{LTHthesis}
\newcommand\thisdir{.} % Will be changed in the chapters
\newcommand\figdir{\thisdir/figures} % See comment below
\addbibresource{europe.bib} % and other preamble commands
\includeonly{% % The percents are important. See comments below.
Frontmatter/Frontmatter,
London/London,
Madrid/Madrid,
}
\begin{document}
\include{Frontmatter/Frontmatter}
\include{London/London}
\include{Madrid/Madrid}
\end{document}Capitals/London/ contains at least one tex-file, London.tex, and possibly a subdirectory figures.
- London.tex:
\renewcommand\thisdir{London} \chapter{London, the City that Lost an Empire} \label{chap:London} This chapter contains a thorough description of London. \begin{figure} \includegraphics{\figdir/ImageOfLondon} \caption{London Skyline} \end{figure}
Capitals/Madrid/ contains at least one tex-file, Madrid.tex and possibly a subdirectory figures.
- Madrid.tex:
\renewcommand\thisdir{\topdir/Madrid} \chapter{Madrid, where the Diagonals Cross} \label{chap:Madrid} This chapter contains a thorough and exhaustive description of Madrid.
Capitals/Frontmatter/ looks the same as in the other chapters, but is used for title pages, Table of Contents etc.
Some comments
The statement \includeonly ... has this special layout so that it will be easy to comment out all chapters except the one you specifically want to work with. You can then type latex Capitals, and only the desired chapter will be processed, but all numbering and cross-references will still be correct.
Both Texmaker and Texstudio have the possibility to specify a 'Master File', in this case Capitals.tex, such that even if you work with London.tex, the build command will be for the main file, Capitals.tex
\figdir as defined in Capitals.tex above presumes that each chapter has a subfolder with the name figures, where the figures for each respective chapter are located. There are other possible layouts and you can change the definiton of \figdir to fit.