This repository has been archived on 2024-07-01. You can view files and clone it, but cannot push or open issues or pull requests.
Praxisbericht-Template/README.md

3.0 KiB

Praxisbericht-Template

Latex template for writing practial exams and reports for DHBW and ABB with TexLive.

⚠️ NOTE

This repository was archived on 01/07/2024 in favor of DHBW-ABB Typst template

Structure

The template is structured in the following way: Every logical part of the code is contained within a specific directory. The file main.tex is the root of the document and is not meant to be modified execpt for adding new packages to be used. The directories are as follows:

Direcory Contents
chapter Holds every chapter page of the report. These pages are to be created by the author on demand.
config Holds configuration files for metadata about the author, company and topic covered. The data specified will be used automatically throughout the entire document.
extra Extra files for utilities and applied fixes
multimedia Stores multimedia files used in the document such als images, videos and pdf files
pages these are the abstract layout pages of the document are not to be altered

Acronyms are defined in the file acros.tex. Likewise, glossaries are all defined in glossary.tex.

Build

The project is intended to be build by TexLive through the use of latexmk. This is why there is a custom .latexmkrc file specified to keep the build process clean.

Dependencies

This project requires the following:

  • TexLive
  • latexmk (often packaged with TexLive full-scheme)
  • python
  • pygments (python package for minted)

Quick start for Linux/WSL and Devbox

In the repository you will find a devbox.json. If you have devbox installed you can simply setup a ready to go container by running:

devbox shell

then inside the container compile with:

latexmk

Alternatively you can launch VSCode/VSCodium inside the devbox and compile with the LaTeX workstation plugin.

Files created during build

The build process of latexmk will create two folders for storing temporary cache files for faster rebuilds. The primary folder being .tmp which will hold every created .aux file. Additionally the resulting pdf file will be located besides main.tex as well as an index file called main.synctex.gz used for indexing between main.tex and main.pdf (unused by VSCode, used by Overleaf).

Build files:

  • main.pdf
  • main.synctex.gz
  • build/*
  • tmp/*