Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Modular LaTeX Documents. #26

Open
Hsins opened this issue Jul 31, 2021 · 3 comments
Open

Modular LaTeX Documents. #26

Hsins opened this issue Jul 31, 2021 · 3 comments
Assignees

Comments

@Hsins
Copy link
Contributor

Hsins commented Jul 31, 2021

As the work grows, the *.tex file can become unwieldy and confusing, especially we're writing a full-length book. It's the good practice to split the file into several files.

LaTeX makes this very easy with the commands \input{filename} and \include{filename}. A template for the modular latex document can be set up as follows structure:

.
├── back
│   ├── appendix-*.tex
│   ├── references.bib
│   └── ...
├── contents
│   ├── chapter-*.tex
│   └── ...
├── figures
│   ├── chapter-*
│   │   ├── *.[png/jpg/pdf]
│   │   └── ...
│   └── ...
├── main.tex
├── README.md
├── [style.tex]
├── [template.cls]
├── ...
├── LICENSE
├── Makefile
└── README.md

References

@Hsins
Copy link
Contributor Author

Hsins commented Aug 1, 2021

I've split the files following the structure above and connect it with Overleaf here (only connected to my forked repo). If @jserv has no problem with it then I'll commit and make a pull request for this.

Besides, why do you use the documentclass book but use \section{} instead of \chapter{}? Is there any concern?

@jserv
Copy link
Contributor

jserv commented Aug 1, 2021

Besides, why do you use the documentclass book but use \section{} insteaf of \chapter{}? Is there any concern?

The TeX script was converted from Org mode for Emacs, and you can figure out some kludge.

@jserv
Copy link
Contributor

jserv commented Aug 1, 2021

Due to historical reasons, LKMPG was poor at its documentation organization. That is, the sections/chapters were tattered from the perspective of a complete programming guide. Before the modularization, it would be better if we can revise the existing materials and amalgamate parts of the sections. Recently, I have been preparing.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants