This commit is contained in:
Dominik Becker 2018-06-29 20:18:29 +02:00
parent afeabc336e
commit 772d3fd38c

View File

@ -21,6 +21,7 @@ It's based on the `scrbook` document class and currently layed out for german sc
- [Acronyms](#acronyms) - [Acronyms](#acronyms)
- [Code Listings](#code-listings) - [Code Listings](#code-listings)
- [Paragraph Distances and Onehalf Spacing](#paragraph-distances-and-onehalf-spacing) - [Paragraph Distances and Onehalf Spacing](#paragraph-distances-and-onehalf-spacing)
- [Snippets for working in VS Code](#snippets-for-working-in-vs-code)
<!-- /TOC --> <!-- /TOC -->
@ -57,7 +58,7 @@ If you do not know what you're doing or get into trouble, you may want to read o
The main entry point for the document compilation is the file `main.tex` in the repo root. The main entry point for the document compilation is the file `main.tex` in the repo root.
Besides setting some common parameters for the document (like author name, title, date etc.), the basic document structure is created here (mostly by including seperate files) in the following order: Besides setting some common parameters for the document (like author name, title, date etc.), the basic document structure is created here (mostly by including seperate files) in the following order:
* configuration (`config/config.tex`) * configuration (`config.tex`)
* title page (`additionals/title.tex`) * title page (`additionals/title.tex`)
* disclosure notice (`additionals/disclosure.tex`, decomment in `main.tex` if neccessary) * disclosure notice (`additionals/disclosure.tex`, decomment in `main.tex` if neccessary)
* table of contents * table of contents
@ -66,7 +67,7 @@ Besides setting some common parameters for the document (like author name, title
* list of tables * list of tables
* list of code listings * list of code listings
* chapter files (`chapter/*`, needs to be filled up manually) * chapter files (`chapter/*`, needs to be filled up manually)
* bibliography (`config/references.tex`, using the entries defined in `library/library.bib`) * bibliography (`additionals/references.tex`, using the entries defined in `library/library.bib`)
* declaration of authorship (`additionals/affirmation.tex`) * declaration of authorship (`additionals/affirmation.tex`)
If you don't need one of the predefined document parts or want to omit it, simply remove or comment out the corresponding statements in `main.tex`. If you don't need one of the predefined document parts or want to omit it, simply remove or comment out the corresponding statements in `main.tex`.
@ -103,13 +104,14 @@ If there's no bibliography entry for a keyword, the bibliography type will be om
Here's an overview of the supported document types and their keywords: Here's an overview of the supported document types and their keywords:
| type | biblatex document type | keyword | | type | biblatex document type | keyword |
|-----------------------|------------------------|---------| |----------------------------------|-------------------------------|----------------|
| monographs | `@Book` | `mono` | | monographs | `@Book` | - |
| essays | `@Article` | `mag` | | essays and articles in magazines | `@Article` | - |
| articles | `@Article` | `art` | | articles in collections | `@InCollection` | - |
| web pages | `@Online` | `web` | | other papers | `@InProceedings` or `@Thesis` | - |
| legislative documents | | `leg` | | web pages | `@Online` | - |
| company internal docs | `@Misc` | `comp` | | legislative documents | `@Misc` | `jurisdiction` |
| company internal docs | `@Misc` | `company` |
References within the document are usually done using the `\autocite[prefix][postfix]{bibkey}` statement. References within the document are usually done using the `\autocite[prefix][postfix]{bibkey}` statement.
@ -244,3 +246,8 @@ For that reason you may wrap such environments (e.g. lists, images, tables, para
```latex ```latex
\vspace{-\topsep} \vspace{-\topsep}
``` ```
## Snippets for working in VS Code
I compiled a few useful editor snippets to work with this boilerplate in VS Code.
See [VS Code: LaTex-Snippets](https://gitlab.com/snippets/1729310) for more.