mavam/quarto-brief

A Quarto template for a DIN 5008 letter

Brief — DIN 5008 compliant letters with Quarto

This quarto extension provides a letter template that adheres to the German DIN 5008 requirements, based on the scrlttr2 LaTeX document class.

Usage

Install the extension and example qmd file as follows:

quarto use template mavam/quarto-brief

Then adapt the example as you see fit.

Format Options

The sample 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'

---
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.

To use a different font, say 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:

---
# 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 extension, but needed something that adheres to DIN 5008.

quarto-brief's Issues

Add instructions for custom fonts to readme

Hi, thanks for providing this extension/template. I never managed to implement this on my own and just recently found your extension.

I figured out, how to use custom fonts in the letter (I personally don't like lmodern too much).
Can I open a PR to add the details to your readme?

The font files need to be in the root folder of the *.qmd file.
Supposing the font files are called e.g. "roboto-latin-regular.ttf" or "roboto-latin-italic.ttf", etc.,
the necessary YAML options are:

mainfont: roboto
mainfontoptions:
- Extension=.ttf
- UprightFont=*-latin-regular
- BoldFont=*-latin-700
- ItalicFont=*-latin-italic
- BoldItalicFont=*-latin-700italic

This changes the font for the body, header, the address..., basically all except the back-address-field.
To change the latter, you need to also add the following:

sansfont: roboto
sansfontoptions:
- Extension=.ttf
- UprightFont=*-latin-regular
- BoldFont=*-latin-700
- ItalicFont=*-latin-italic
- BoldItalicFont=*-latin-700italic