1
0
Fork 0
mirror of https://github.com/benedictdudel/pandoc-letter-din5008.git synced 2024-08-16 10:19:49 +02:00
mirror-pandoc-letter-din5008/README.md

81 lines
1.7 KiB
Markdown
Raw Normal View History

2016-07-20 23:06:24 +02:00
# Pandoc Letter Template (DIN 5008)
## Description
This template allows you to write simple letters in Markdown and convert them
into nice looking PDFs. The template is based on Koma Script and satisfies
the German DIN 5008 norm for letters.
## Example
A simple letter in Markdown looks like the following:
```markdown
---
author: Max Mustermann
phone: +49 1234 56789
email: max.mustermann@beispiel.de
date: 01.08.2016
place: Musterstadt
subject: Titel vom Brief
return-address:
- Musterstraße
- 12345 Berlin
address:
- Musterfirma GmbH
- Max Mustermann
- Musterstraße
- 12345 Musterstadt
opening: Sehr geehrte Damen und Herren,
closing: Mit freundlichen Grüßen
encludes: Muster, Muster, Muster
...
```
The compiled result will then look like this:
![alt Letter](https://github.com/benedu/pandoc-letter/raw/master/example/letter.png)
You can also download the compiled PDF [here](https://github.com/benedu/pandoc-letter/raw/master/example/letter.pdf).
## Requirements
In order to use the template you must have installed the following components:
- [Pandoc](http://pandoc.org/installing.html)
- [LaTeX](https://latex-project.org/ftp.html)
## Usage
Before you can make use of the template you need to move the LaTeX template file
into Pandocs template directory:
```
mkdir ~/.pandoc
2016-11-23 16:18:17 +01:00
mv your-repo-path/letter.latex ~/.pandoc/templates
2016-07-20 23:06:24 +02:00
```
After creating a letter written in Markdown you can compile it into PDF with the
following line:
`pandoc letter.md -s -o letter.pdf --template="letter"`
## Configuration
The following yaml variables are supported:
- `opening`
- `closing`
- `encludes`
- `author`
- `phone`
- `email`
- `place`
- `subject`
- `return-address`
- `address`