175 lines
3.6 KiB
Markdown
175 lines
3.6 KiB
Markdown
|
# LaTeX Book Template Build
|
||
|
This `BUILD.md` document is about how to build the documentation,
|
||
|
not about how to build a ground station.
|
||
|
|
||
|
The *LaTeX Book Template* is written in LaTeX
|
||
|
which generates a final PDF for viewing or printing.
|
||
|
|
||
|
|
||
|
# Install
|
||
|
|
||
|
* Requires LaTeX. Note, LaTeX is in the `texlive` packages in Debian
|
||
|
and is relatively huge (1 gig+ install).
|
||
|
|
||
|
* Minted syntax highlighting requires python3-pygments to be installed.
|
||
|
|
||
|
* Requires more packages than just below. XXX
|
||
|
|
||
|
Install dependencies in Debian:
|
||
|
|
||
|
```
|
||
|
sudo apt update
|
||
|
sudo apt install texlive-latex-recommended texlive-xetex \
|
||
|
texlive-humanities texlive-pstricks \
|
||
|
python3-pygments \
|
||
|
fonts-gemunu-libre fonts-linuxlibertine fonts-stix \
|
||
|
biber git
|
||
|
```
|
||
|
|
||
|
Get source code:
|
||
|
|
||
|
```
|
||
|
git clone https://spacecruft.org/spacecruft/LaTeXBookTemplate
|
||
|
cd LaTeXBookTemplate/
|
||
|
```
|
||
|
|
||
|
|
||
|
# Build
|
||
|
Run the build script to make a PDF:
|
||
|
|
||
|
```
|
||
|
make
|
||
|
```
|
||
|
|
||
|
To just make a cover:
|
||
|
|
||
|
```
|
||
|
make cover
|
||
|
```
|
||
|
|
||
|
To clean:
|
||
|
|
||
|
```
|
||
|
make clean
|
||
|
```
|
||
|
|
||
|
|
||
|
# View
|
||
|
Use a PDF viewer to read the document, such as:
|
||
|
|
||
|
```
|
||
|
evince LaTeXBookTemplate.pdf
|
||
|
```
|
||
|
|
||
|
|
||
|
# Book Parts
|
||
|
The book source has many features in the LaTeX code.
|
||
|
It includes all parts generally used in non-fiction books.
|
||
|
Unused parts can be easily disabled.
|
||
|
|
||
|
## Front Matter
|
||
|
* Half Title.
|
||
|
* Frontispiece.
|
||
|
* Title page.
|
||
|
* Copyright page.
|
||
|
* Dedication.
|
||
|
* Epigraph.
|
||
|
* Table of Contents.
|
||
|
* List of Figures.
|
||
|
* List of Tables.
|
||
|
* Foreward.
|
||
|
* Preface.
|
||
|
* Acknowledgements.
|
||
|
* Introduction.
|
||
|
* Prologue.
|
||
|
|
||
|
## Body Matter
|
||
|
* Chapters.
|
||
|
* Sections.
|
||
|
* Subsections.
|
||
|
* Subsubsections...
|
||
|
|
||
|
## Back Matter
|
||
|
* Appendix.
|
||
|
* Glossary.
|
||
|
* Bibliography.
|
||
|
* Index.
|
||
|
* Colophon.
|
||
|
|
||
|
|
||
|
# Features
|
||
|
Features in the LaTeX code.
|
||
|
|
||
|
* Makefile for "easy" LaTeX processing.
|
||
|
* Auto-generated Table of Contents, List of Figures, Index, etc.
|
||
|
* Syntax highlighting of computer source code.
|
||
|
* BibLaTeX bibliographic system using external `jabref` application for managing
|
||
|
entries.
|
||
|
* Footnotes.
|
||
|
* Glossary and acronym processing.
|
||
|
* "Crown Quarto/Crown 4vo" size (7.44 x 9.68", 18.90 x 24.58cm) in use at
|
||
|
large printing houses (e.g. Lulu/Lightning Source).
|
||
|
* Microtyping with OTF fonts.
|
||
|
* Internal hyperlinks from Table of Contents.
|
||
|
* Internal hyperlinks to footnotes.
|
||
|
* Internal hyperlinks to glossary.
|
||
|
* Internel hyperlinks from index.
|
||
|
* External hyperlinks from references and other URLs.
|
||
|
* Generated ISBN bar code on Half Title page.
|
||
|
* Generated date stamp on Copyright page.
|
||
|
* Use of roman in front matter then arabic page numerals for the body.
|
||
|
* Generation of graphics, diagrams, flow charts, etc., within document.
|
||
|
* Custom colors.
|
||
|
* Custom fonts.
|
||
|
* Custom page style.
|
||
|
* Custom chapter style.
|
||
|
* Unicode UTF-8 (entirely?).
|
||
|
* PDF titling.
|
||
|
* Figures.
|
||
|
* Tables.
|
||
|
* Lists.
|
||
|
* Graphics.
|
||
|
* Labels.
|
||
|
* Internal citations.
|
||
|
* External citations.
|
||
|
|
||
|
|
||
|
# BibTeX
|
||
|
If `kbibtex` seg faults, perhaps:
|
||
|
|
||
|
```
|
||
|
rm -f -r .local/share/kbibtex .cache/kbibtex/ .config/kbibtexrc
|
||
|
```
|
||
|
|
||
|
Use `jabref`.
|
||
|
|
||
|
# Setup for New Book
|
||
|
|
||
|
```
|
||
|
sed -i -e 's/LaTeX Book Template/Muh New Book/g' BUILD.md Makefile README.md src/*.tex src/*.gst src/Makefile
|
||
|
|
||
|
sed -i -e 's/LaTexBookTemplate/MuhNewBook/g' .gitignore BUILD.md Makefile README.md src/*.tex src/*.gst src/Makefile
|
||
|
|
||
|
for i in src/*LaTexBookTemplate* ; do mv $i `echo $i | sed -e 's/LaTeXBookTemplate/MuhNewBook/g'` ; done
|
||
|
```
|
||
|
|
||
|
|
||
|
# Commercial Printing
|
||
|
Book is formatted for publishing at large printing houses (or basements).
|
||
|
HOWTO: set up and print with Lulu.
|
||
|
|
||
|
|
||
|
# License
|
||
|
LaTeX Book Template
|
||
|
|
||
|
by Jeff Moe
|
||
|
|
||
|
Copyright © 2022, Jeff Moe
|
||
|
|
||
|
Permission is granted to copy, distribute and/or modify this document under
|
||
|
the terms of the Creative Commons Attribution 4.0 International Public License
|
||
|
(CC BY-SA 4.0).
|
||
|
|
||
|
Published by Jeff Moe, Loveland, Colorado, USA.
|
||
|
|