Ausarbeitungsvorlage für die Uni
uni
Go to file Use this template
2023-02-10 13:54:46 +01:00
.vscode Update pipeline and markdown snippets 2021-10-12 12:15:03 +02:00
additionals Improve automization and VSCode integration 2021-11-10 13:33:51 +01:00
appendix 52 modularized build script into functions and added possibility to have markdown appendices 2021-04-15 13:30:34 +02:00
chapter Initial Commit + Docs 2018-01-31 23:23:53 +01:00
library Initial Commit + Docs 2018-01-31 23:23:53 +01:00
resources Initial Commit + Docs 2018-01-31 23:23:53 +01:00
templates Use current date for github workflow's generated PDF 2023-02-10 13:54:46 +01:00
.gitignore Improve automization and VSCode integration 2021-11-10 13:33:51 +01:00
.hunspellignore #3 Hunspell Spellcheck, Docs 2018-04-10 01:35:16 +02:00
.latexmkrc #8 migrated code listings to minted 2018-04-26 20:26:36 +02:00
build.sh Improve setup and build process, don't require new line at the end of each md file 2023-01-17 15:49:24 +01:00
config.tex Improve automization and VSCode integration 2021-11-10 13:33:51 +01:00
LICENSE LICENSE 2018-04-04 14:05:49 +02:00
main.tex Improve automization and VSCode integration 2021-11-10 13:33:51 +01:00
README.md Update 'README.md' 2021-09-08 05:35:06 +00:00
setup.sh Fix directory name for Github workflows 2023-02-02 16:48:24 +01:00
wordcount.lua Adjust to personal needs 2021-05-16 22:01:36 +02:00

Uni Ausarbeitung

This is a simple preconfigured boilerplate for medium-sized LaTex projects including continuous integration for GitLab CI. It's based on the scrbook document class and currently layed out for german scientiefic documents. Furthermore, it provides the possibility to write documents in Markdown instead of LaTex.

Origin: LaTeX Boilerplate

Getting Started

To use this template in a new project, either download the ZIP directly from Gitea or clone it using Git:

git clone git@direct.kingofdog.de:KingOfDog/uni-ausarbeitung.git <directory-name>
# now set up your own Git workspace:
git remote remove origin
git remote add origin git@direct.kingofdog.de:path/to/repo.git
git push origin main

If you already have set up an empty Git workspace for your project, add it as additional remote and then fetch and pull:

git remote add boilerplate git@direct.kingofdog.de:KingOfDog/uni-ausarbeitung.git
git fetch boilerplate
git pull boilerplate main
# if you don't want to keep the remote for pulling future updates, remove it:
git remote remove boilerplate

Setup CI/CD

In order to setup the repo for CI / CD on GitLab, Drone CLI on Gitea, Workflos on GitHub and Azure DevOps, as well as VS Code integration, run ./setup.sh latex or ./setup.sh markdown, depending in which workflow you want to use. CI will use Dockerized builds by default.

Writing

Latex

If you know what you're doing, simply start adding your content files in chapter/ as LaTex \chapters and \input them into main.tex. You can then run the build using VS Code preconfigured tasks or using build.sh.

Markdown

For Markdown, add your content as *.md files in chapter/ and prefix them with ascending numbers (to keep chapter sequence). You shouldn't need to \input or configure anything else, as the files are concatenated automatically at build time. Run build.sh pandoc to build your PDF.

If you do not know what you're doing or get into trouble - or want to use the Markdown Workflow, you may want to consider the wiki ;-)

Docker Images

If you need a Docker image to build your documents, head over to pandoc-latex (DockerHub). Also, there's a prebuilt Docker image for spellchecking using Hunspell - head over to docker-hunspell.