Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mavam/quarto-brief
A Quarto template for a DIN 5008 letter
https://github.com/mavam/quarto-brief
brief din5008 latex letter quarto quarto-extension quarto-template
Last synced: 3 months ago
JSON representation
A Quarto template for a DIN 5008 letter
- Host: GitHub
- URL: https://github.com/mavam/quarto-brief
- Owner: mavam
- License: mit
- Created: 2023-02-23T14:20:35.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2023-12-08T13:37:46.000Z (about 1 year ago)
- Last Synced: 2024-08-03T22:03:31.906Z (5 months ago)
- Topics: brief, din5008, latex, letter, quarto, quarto-extension, quarto-template
- Language: TeX
- Homepage:
- Size: 27.3 KB
- Stars: 9
- Watchers: 3
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Brief — DIN 5008 compliant letters with Quarto
This quarto extension provides a letter template that adheres to the German [DIN
5008](https://de.wikipedia.org/wiki/DIN_5008) requirements, based on the
`scrlttr2` LaTeX document class.
## Usage
Install the extension and example qmd file as follows:
```bash
quarto use template mavam/quarto-brief
```
Then adapt the example as you see fit.
## Format Options
The sample [template.qmd](template.qmd) demonstrates all available tuning knobs.
Many options are directly lifted from the `scrlttr2` class.
### Setting the Font Size
The default font size is 12pt. To specify a different size for the document, use the YAML option 'fontsize'
```yaml
---
fontsize: 11pt
---
```
Any TeX-compatible unit should work, like e.g. `ex`, `in` or `mm`. However, to avoid layout breaks, it is recommended to use one of the most common sizes `10pt`, `11pt` or `12pt`.
### Customize Fonts
You can adjust fonts by adjusting Quarto's [PDF font
options](https://quarto.org/docs/reference/formats/pdf.html#fonts).
To use a different font, say [Roboto](https://fonts.google.com/specimen/Roboto),
downloading the font archive and unpack to get the TTF files. We use these
below:
- `Roboto-Bold.ttf`
- `Roboto-BoldItalic.ttf`
- `Roboto-Italic.ttf`
- `Roboto-Regular.ttf`
Then adjust the frontmatter as follows:
```yaml
---
# Used for most parts of the letter.
mainfont: Roboto
mainfontoptions:
- Extension=.ttf
- UprightFont=*-Regular
- BoldFont=*-Bold
- ItalicFont=*-Italic
- BoldItalicFont=*-BoldItalic
# Used for back-address and address field.
sansfont: Roboto
sansfontoptions:
- Extension=.ttf
- UprightFont=*-Regular
- BoldFont=*-Bold
- ItalicFont=*-Italic
- BoldItalicFont=*-BoldItalic
---
```
For more involved letters, you may want to consider setting `monofont` and
`mathfont` and their respective options.
## Credits
I got inspired by Mickaël Canouil's
[quarto-letter](https://github.com/mcanouil/quarto-letter) extension, but needed
something that adheres to DIN 5008.