30 lines
1.5 KiB
Markdown
30 lines
1.5 KiB
Markdown
# LaTex Boilerplate
|
|
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.
|
|
|
|
## Getting Started
|
|
To use this template in a new project, either download the [ZIP](https://gitlab.com/fastexitlane/latex-boilerplate/-/archive/master/latex-boilerplate-master.zip) directly from GitLab or clone it using Git:
|
|
|
|
```bash
|
|
git@gitlab.com:fastexitlane/latex-boilerplate.git
|
|
# now set up your own Git workspace:
|
|
git remote remove origin
|
|
git remote add origin git@your-own-gitlab.host:path/to/repo.git
|
|
git push origin master
|
|
```
|
|
|
|
If you already have set up an empty Git workspace for your project, add it as additional remote and then fetch and pull:
|
|
|
|
```bash
|
|
git remote add boilerplate git@gitlab.com:fastexitlane/latex-boilerplate.git
|
|
git fetch boilerplate
|
|
git pull boilerplate master
|
|
# if you don't want to keep the remote for pulling future updates, remove it:
|
|
git remote remove boilerplate
|
|
```
|
|
|
|
In order to use the preconfigured continuous integration, make sure your GitLab CI meets the [Basic Requirements](https://gitlab.com/fastexitlane/latex-boilerplate/wikis/GitLab-CI#basic-requirements).
|
|
|
|
If you know what you're doing, simply start adding your content files in `chapter/` as LaTex `\chapter`s and `\input` them into `main.tex`.
|
|
If you do not know what you're doing or get into trouble, you may want to consider the [wiki](https://gitlab.com/fastexitlane/latex-boilerplate/wikis/home) ;-)
|