{"id":14980592,"url":"https://github.com/fkemser/gerlatexletter","last_synced_at":"2026-02-25T16:32:01.591Z","repository":{"id":244298356,"uuid":"755332109","full_name":"fkemser/GerLaTeXLetter","owner":"fkemser","description":"A LaTeX template for business letters (mostly) following German DIN 5008 standard, based on KOMA-Script class 'scrlttr2'.","archived":false,"fork":false,"pushed_at":"2024-09-01T19:30:17.000Z","size":204,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-01T20:24:37.204Z","etag":null,"topics":["din5008","koma-script","latex","latex-template","letter","scrlttr2","tex"],"latest_commit_sha":null,"homepage":"","language":"TeX","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fkemser.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-02-09T22:49:31.000Z","updated_at":"2024-09-01T19:30:21.000Z","dependencies_parsed_at":"2024-06-13T23:04:19.396Z","dependency_job_id":"b9236d20-49c0-4156-a2d5-4e61571f0420","html_url":"https://github.com/fkemser/GerLaTeXLetter","commit_stats":null,"previous_names":["fkemser/gerlatexletter"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fkemser%2FGerLaTeXLetter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fkemser%2FGerLaTeXLetter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fkemser%2FGerLaTeXLetter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fkemser%2FGerLaTeXLetter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fkemser","download_url":"https://codeload.github.com/fkemser/GerLaTeXLetter/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238743955,"owners_count":19523208,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["din5008","koma-script","latex","latex-template","letter","scrlttr2","tex"],"created_at":"2024-09-24T14:02:03.483Z","updated_at":"2025-10-29T00:30:38.940Z","avatar_url":"https://github.com/fkemser.png","language":"TeX","funding_links":[],"categories":[],"sub_categories":[],"readme":"\r\n\u003c!-- Improved compatibility of back to top link: See: https://github.com/othneildrew/Best-README-Template/pull/73 --\u003e\r\n\u003ca name=\"readme-top\"\u003e\u003c/a\u003e\r\n\u003c!--\r\n*** Thanks for checking out the Best-README-Template. If you have a suggestion\r\n*** that would make this better, please fork the repo and create a pull request\r\n*** or simply open an issue with the tag \"enhancement\".\r\n*** Don't forget to give the project a star!\r\n*** Thanks again! Now go create something AMAZING! :D\r\n--\u003e\r\n\r\n\r\n\r\n\u003c!-- PROJECT SHIELDS --\u003e\r\n\u003c!--\r\n*** I'm using markdown \"reference style\" links for readability.\r\n*** Reference links are enclosed in brackets [ ] instead of parentheses ( ).\r\n*** See the bottom of this document for the declaration of the reference variables\r\n*** for contributors-url, forks-url, etc. This is an optional, concise syntax you may use.\r\n*** https://www.markdownguide.org/basic-syntax/#reference-style-links\r\n--\u003e\r\n[![Contributors][contributors-shield]][contributors-url]\r\n[![Forks][forks-shield]][forks-url]\r\n[![Stargazers][stars-shield]][stars-url]\r\n[![Issues][issues-shield]][issues-url]\r\n[![GNU GPL v3.0 License][license-shield]][license-url]\r\n\u003c!-- [![LinkedIn][linkedin-shield]][linkedin-url] --\u003e\r\n\r\n\r\n\r\n\u003c!-- PROJECT LOGO --\u003e\r\n\u003cbr /\u003e\r\n\u003cdiv align=\"center\"\u003e\r\n  \u003c!-- \u003ca href=\"https://github.com/fkemser/GerLaTeXLetter\"\u003e\r\n    \u003cimg src=\"images/logo.png\" alt=\"Logo\" width=\"80\" height=\"80\"\u003e\r\n  \u003c/a\u003e --\u003e\r\n\r\n\u003ch3 align=\"center\"\u003eGerLaTeXLetter\u003c/h3\u003e\r\n\r\n  \u003cp align=\"center\"\u003e\r\n    A LaTeX template for business letters (mostly) following German DIN 5008 standard, based on KOMA-Script class 'scrlttr2'.\r\n    \u003cbr /\u003e\r\n    \u003ca href=\"https://github.com/fkemser/GerLaTeXLetter\"\u003e\u003cstrong\u003eExplore the docs »\u003c/strong\u003e\u003c/a\u003e\r\n    \u003cbr /\u003e\r\n    \u003cbr /\u003e\r\n    \u003ca href=\"https://github.com/fkemser/GerLaTeXLetter\"\u003eView Demo\u003c/a\u003e\r\n    ·\r\n    \u003ca href=\"https://github.com/fkemser/GerLaTeXLetter/issues\"\u003eReport Bug\u003c/a\u003e\r\n    ·\r\n    \u003ca href=\"https://github.com/fkemser/GerLaTeXLetter/issues\"\u003eRequest Feature\u003c/a\u003e\r\n  \u003c/p\u003e\r\n\u003c/div\u003e\r\n\r\n\r\n\r\n\u003c!-- TABLE OF CONTENTS --\u003e\r\n\u003cdetails\u003e\r\n  \u003csummary\u003eTable of Contents\u003c/summary\u003e\r\n  \u003col\u003e\r\n    \u003cli\u003e\r\n      \u003ca href=\"#about-the-project\"\u003eAbout The Project\u003c/a\u003e\r\n      \u003cul\u003e\r\n        \u003cli\u003e\u003ca href=\"#built-with\"\u003eBuilt With\u003c/a\u003e\u003c/li\u003e\r\n        \u003cli\u003e\u003ca href=\"#testing-environment\"\u003eTesting Environment\u003c/a\u003e\u003c/li\u003e\r\n      \u003c/ul\u003e\r\n    \u003c/li\u003e\r\n    \u003cli\u003e\r\n      \u003ca href=\"#getting-started\"\u003eGetting Started\u003c/a\u003e\r\n      \u003cul\u003e\r\n        \u003cli\u003e\r\n          \u003ca href=\"#prerequisites\"\u003ePrerequisites\u003c/a\u003e\r\n          \u003cul\u003e\r\n            \u003cli\u003e\u003ca href=\"#debian\"\u003eDebian\u003c/a\u003e\u003c/li\u003e\r\n            \u003cli\u003e\u003ca href=\"#tex-live-package-manager\"\u003eTeX Live Package Manager (tlmgr)\u003c/a\u003e\u003c/li\u003e\r\n          \u003c/ul\u003e\r\n        \u003c/li\u003e\r\n        \u003cli\u003e\u003ca href=\"#installation\"\u003eInstallation\u003c/a\u003e\u003c/li\u003e\r\n      \u003c/ul\u003e\r\n    \u003c/li\u003e\r\n    \u003cli\u003e\r\n      \u003ca href=\"#customization\"\u003eCustomization\u003c/a\u003e\r\n      \u003cul\u003e\r\n        \u003cli\u003e\u003ca href=\"#headerlco-headerfooterinformation-block-template\"\u003eheader.lco (Header/Footer/Information Block Template)\u003c/a\u003e\u003c/li\u003e\r\n        \u003cli\u003e\u003ca href=\"#lettertex-individual-letter\"\u003eletter.tex (Individual Letter)\u003c/a\u003e\u003c/li\u003e\r\n        \u003cli\u003e\u003ca href=\"#logopng-sample-logo\"\u003elogo.png (Sample Logo)\u003c/a\u003e\u003c/li\u003e\r\n        \u003cli\u003e\u003ca href=\"#lettertex-individual-letter\"\u003etemplate.lco (General Letter Template)\u003c/a\u003e\u003c/li\u003e\r\n      \u003c/ul\u003e\r\n    \u003c/li\u003e\r\n    \u003cli\u003e\u003ca href=\"#usage\"\u003eUsage\u003c/a\u003e\u003c/li\u003e\r\n    \u003cli\u003e\u003ca href=\"#roadmap\"\u003eRoadmap\u003c/a\u003e\u003c/li\u003e\r\n    \u003cli\u003e\u003ca href=\"#contributing\"\u003eContributing\u003c/a\u003e\u003c/li\u003e\r\n    \u003cli\u003e\u003ca href=\"#license\"\u003eLicense\u003c/a\u003e\u003c/li\u003e\r\n    \u003cli\u003e\u003ca href=\"#contact\"\u003eContact\u003c/a\u003e\u003c/li\u003e\r\n    \u003cli\u003e\u003ca href=\"#acknowledgments\"\u003eAcknowledgments\u003c/a\u003e\u003c/li\u003e\r\n  \u003c/ol\u003e\r\n\u003c/details\u003e\r\n\r\n\r\n\r\n\u003c!-- ABOUT THE PROJECT --\u003e\r\n## About The Project\r\n\r\n[![Product Name Screen Shot][screenshot1]](res/letter.pdf)\r\n[![Product Name Screen Shot][screenshot2]](res/letter.pdf)\r\n\r\nDuring my research on writing letters with [LaTeX][LaTeX-url] and [KOMA-Script][scrlttr2-url] I encountered many great templates on the web. However, none of them met all my requirements so I decided to create my own one. This template offers\r\n\r\n* a structured layout, mostly following German [DIN 5008][din5008] standard,\r\n* a customizable logo placeholder, information block, and footer\r\n* an automatically created vCard QR code with your (company's) contact details, allowing the recipient to store them in their smartphone, and\r\n* code snippets allowing you to\r\n  * include OS environmental variables in your letter, e.g. as used in the [TeXLetterCreator](https://github.com/fkemser/TeXLetterCreator) project,\r\n  * create multi-lingual documents.\r\n\r\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\r\n\r\n\r\n\r\n### Built With\r\n\r\n[![LaTeX][LaTeX-shield]][LaTeX-url]\r\n[![Shell Script][Shell Script-shield]][Shell Script-url]\r\n\r\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\r\n\r\n\r\n\r\n### Testing Environment\r\n\r\nThe project has been developed and tested on the following system:\r\n\r\n| Info | Description\r\n---: | ---\r\nOS | Debian GNU/Linux 12 (bookworm)\r\nKernel | 5.15.90.1-microsoft-standard-WSL2\r\nPackages | [texlive-latex-recommended (2022.20230122-3)](https://packages.debian.org/bookworm/texlive-latex-recommended)\r\n|| [texlive-luatex (2022.20230122-3)](https://packages.debian.org/bookworm/texlive-luatex)\r\n|| [xz-utils (5.4.1-0.2)](https://packages.debian.org/bookworm/xz-utils)\r\n\r\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\r\n\r\n\r\n\r\n\u003c!-- PREREQUISITES --\u003e\r\n## Prerequisites\r\n\r\nPlease make sure that the following dependencies are installed:\r\n\r\n* [XZ Utils](https://xz.tukaani.org/xz-utils/)\r\n* TeX distribution of your choice, e.g. [TeX Live](https://www.tug.org/texlive/)\r\n* [LuaTeX](https://www.luatex.org/) engine\r\n* Packages (CTAN)\r\n  [afterpage](https://www.ctan.org/pkg/afterpage), [babel](https://www.ctan.org/pkg/babel), [babel-english](https://www.ctan.org/pkg/babel-english), [babel-german](https://www.ctan.org/pkg/babel-german), [catchfile](https://www.ctan.org/pkg/catchfile), [enumitem](https://www.ctan.org/pkg/enumitem), [etoolbox](https://www.ctan.org/pkg/etoolbox), [fontawesome5](https://www.ctan.org/pkg/fontawesome5), [graphicx](https://www.ctan.org/pkg/graphicx), [iflang](https://www.ctan.org/pkg/iflang), [ifthen](https://www.ctan.org/pkg/ifthen), [qrcode](https://www.ctan.org/pkg/qrcode),  [scrlayer-scrpage](https://www.ctan.org/pkg/scrlayer-scrpage), [scrlttr2](https://www.ctan.org/pkg/scrlttr2), [sourcesanspro](https://www.ctan.org/pkg/sourcesanspro), [tabularx](https://www.ctan.org/pkg/tabularx), [xstring](https://www.ctan.org/pkg/xstring)\r\n\r\nBelow you can find distribution-specific installation instructions.\r\n\r\n\u003e :exclamation: Please **do not forget to install the [additional CTAN packages](#tex-live-package-manager)** after (!) the distribution-specific package installation.\r\n\r\n### Debian\r\n\r\n```sh\r\n\u003e sudo apt install texlive-latex-recommended texlive-luatex xz-utils\r\n```\r\n\r\n### TeX Live Package Manager (tlmgr)\r\n\r\n**Some CTAN packages listed above are not included in the distributions' packages**. However, they can be manually installed by using the **TeX Live package manager** `tlmgr`.\r\n\r\nBefore continuing please make sure that `tlmgr`'s **user mode has been initialized** by running the following command:\r\n\r\n```sh\r\n\u003e tlmgr init-usertree\r\n```\r\n\r\nIn case you skip this step you may get an error during installation:\r\n\r\n\u003e (running on Debian, switching to user mode!)  \r\n\u003e (see /usr/share/doc/texlive-base/README.tlmgr-on-Debian.md)  \r\n\u003e TLPDB: not a directory, not loading: /home/user/texmf  \r\n\u003e tlmgr: **user mode not initialized**, please read the documentation!\r\n\r\nNow you can **install the required CTAN packages**:\r\n\r\n```sh\r\n\u003e tlmgr install babel-english babel-german blindtext catchfile enumitem fontawesome5 qrcode sourcesanspro xstring\r\n```\r\n\r\nIn some cases the **installation may fail** with a message similar to the following one:\r\n\r\n\u003e tlmgr: **Local TeX Live (2022) is older than remote repository (2023)**.  \r\n\u003e Cross release updates are only supported with  \r\n\u003e   update-tlmgr-latest(.sh/.exe) --update  \r\n\u003e See https://tug.org/texlive/upgrade.html for details.\r\n\r\nIn those cases the version of the TeX Live system installed via your distribution's package manager does not match the version of `tldr`'s default repository. **To fix this problem:**\r\n\r\n1. **Figure out the year of your local TeX Live system** by running the following command:\r\n\r\n    ```sh\r\n    \u003e tex --version\r\n    ```\r\n   The output may look like this:\r\n\r\n    \u003e TeX 3.141592653 (TeX Live **2022**/Debian)  \r\n    \u003e kpathsea version 6.3.4  \r\n    \u003e Copyright 2022 D.E. Knuth.  \r\n    \u003e ...\r\n\r\n2. **Add the repository** while replacing `\u003cyear\u003e` by the year from step 1 (**2022** here).\r\n\r\n    ```sh\r\n    \u003e tlmgr option repository ftp://tug.org/historic/systems/texlive/\u003cyear\u003e/tlnet-final\r\n    ```\r\n\r\n    In case you would like to use another mirror please have a look at: https://tug.org/historic/\r\n\r\nNext we will **install the necessary hyphenation pattern packages**.\r\nIn case you skip this step you may get a warning message when compiling your letter and your LaTeX compiler may use the wrong hyphenation patterns:\r\n\r\n```\r\n\u003e Package babel Warning: No hyphenation patterns were preloaded for\r\n\u003e (babel)                the language 'German (new orthography)' into the format.\r\n\u003e \r\n\u003e (babel)                Please, configure your TeX system to add them and\r\n\u003e (babel)                rebuild the format. Now I will use the patterns\r\n\u003e (babel)                preloaded for \\language=0 instead on input line 48.\r\n```\r\n\r\nBefore continuing please **make sure that the following files can be modified by your current user**:\r\n\r\n```sh\r\n\u003e sudo touch                                        \\\r\n    /var/lib/texmf/tex/generic/config/language.dat  \\\r\n    /var/lib/texmf/tex/generic/config/language.dat.backup\r\n\u003e sudo chown $(id -u):$(id -g)                      \\\r\n    /var/lib/texmf/tex/generic/config/language.dat  \\\r\n    /var/lib/texmf/tex/generic/config/language.dat.backup\r\n```\r\n\r\nThen **install the hyphenation pattern packages** by running:\r\n\r\n```sh\r\n\u003e tlmgr install hyphen-german\r\n```\r\n\r\nAfterwards, **do not forget to revert the file permission changes**:\r\n\r\n```sh\r\n\u003e sudo chown root:root                              \\\r\n    /var/lib/texmf/tex/generic/config/language.dat  \\\r\n    /var/lib/texmf/tex/generic/config/language.dat.backup\r\n```\r\n\r\n\u003e :warning:  The installation process modifies the system-wide `Babel` configuration file `language.dat` (see above). Your (Linux) distribution's package manager may also modify this file in the future, e.g. when updating your TeX base installation. This may result in configuration issues so it is **recommended to backup this file every time you update your TeX distribution packages**.\r\n\r\nOptional: In case you have modified the template (and therefore need additional CTAN packages) **you may find the following `tlmgr` commands useful**\r\n\r\n```sh\r\n# Search for a package that contains a certain file, e.g. 'loadhyph-de-1996.tex'\r\n\u003e tlmgr search --global --file loadhyph-de-1996.tex\r\n\r\n# Show which files belong to a certain package, e.g. 'hyphen-german'\r\n\u003e tlmgr info hyphen-german --list\r\n\r\n# List installed packages\r\n\u003e tlmgr list --only-installed\r\n```\r\n\r\n**Done!** You can continue with [Installation](#installation).\r\n\r\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\r\n\r\n\r\n\r\n\u003c!-- INSTALLATION--\u003e\r\n## Installation\r\n\r\n1. Clone the repo\r\n  ```sh\r\n   \u003e git clone https://github.com/fkemser/GerLaTeXLetter.git\r\n   ```\r\n2. Customize the template, see [Customization](#customization).\r\n\r\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\r\n\r\n\r\n\r\n\u003c!-- CUSTOMIZATION --\u003e\r\n## Customization\r\n\r\nBefore writing your first letter you should customize the template. To do so, please have a look at the following repository files:\r\n\r\n```\r\n.\r\n├── src\r\n│   ├── header.lco    Header/Footer/Information Block Template\r\n│   ├── letter.tex    Individual Letter\r\n│   ├── logo.png      Sample Logo\r\n│   └── template.lco  General Letter Template\r\n...\r\n```\r\n\r\n\u003e :information_source: For more information please also have a look at the comments within the files, the [KOMA-Script documentation][scrlttr2-doc-url] and the [KOMA-Script Wiki][koma-wiki-url].\r\n\r\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\r\n\r\n\r\n\r\n### `header.lco` (Header/Footer/Information Block Template)\r\n\r\nOpen `header.lco` with your favourite editor and replace the example values by your own ones. Generally speaking it is always about the last `{}` of each line.\r\n\r\n```latex\r\n\\renewcommand{\\fromgivennames}{Max}\r\n```\r\n\r\nWith some variables you are able to not only change their values but also their field descriptor, indicated by `[]`.\r\n\r\n```latex\r\n\\setkomavar{frombushours1}[Mo - Mi]{08:00 - 17:00}\r\n```\r\n\r\nThere are also some variables that allow you to set multi-line text:\r\n\r\n```latex\r\n\\setkomavar{fromroutebus}{%\r\n  11 Musterstraße\\newline\r\n  22 Musterplatz%\r\n}\r\n```\r\n\u003e :exclamation:  Please use `\\newline` instead of `\\\\` to set a linebreak.\r\n\r\n#### vCard QR Code\r\n\r\nBy default, a vCard will be generated from the sender's information and printed as a QR code within the information block. To disable this behaviour, simply comment each of the following lines with a `%` at the beginning.\r\n\r\n```latex\r\n\\newplength{fromvcardheight}\r\n\\setplength{fromvcardheight}{1.5cm}\r\n```\r\n#### Logo\r\n\r\nTo replace the sample logo with your own one, simply replace `logo.png` by your own file. To use a different file name simply replace `{logo}` by your own filename, without any extension. The file must be located in the `src` folder. \r\n\r\n```latex\r\n\\setkomavar{fromlogo}{\\includegraphics[height=1.25cm]{logo}}\r\n```\r\n\r\nTo disable the logo just comment the above line with a `%` at the beginning.\r\n\r\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\r\n\r\n\r\n\r\n### `letter.tex` (Individual Letter)\r\n\r\n\u003e :question:But this is the file to write my individual letter, why should I store anything template-related here?\r\n\r\nWell, for writing just one single letter you may skip this section. But in case of form letters you need a template which  `letter.tex` will be the base for.\r\n\r\n#### Change language\r\n\r\nEdit the following line to change the letter's language: \r\n\r\n```latex\r\n\\usepackage[ngerman]{babel}\r\n```\r\n\u003e :warning: At the moment, only `ngerman`, `english`, `USenglish`, and `UKenglish` (all case-sensitive) are supported.\r\n\r\nThis will not only change the information block's descriptors but also any text within the letter for which you have defined language-dependent variables. It also loads language-specific hyphenation patterns.\r\n\r\n#### Variables\r\n\r\nYou can define your own variables by using the following command, where `varname` is the variable's name and `description` its (optional) description.\r\n```latex\r\n\\newkomavar[description]{varname}\r\n```\r\n\r\nTo use the variable or its description (`*`) within the letter just use:\r\n```latex\r\n\\usekomavar{varname}  % Variable\r\n\\usekomavar*{varname} % Descriptor\r\n```\r\n\r\nFor multi-lingual documents you can define language-dependent values:\r\n\r\n```latex\r\n% Default\r\n\\setkomavar{varname}{value_default}\r\n\r\n% ngerman\r\n\\IfLanguagePatterns{ngerman}{%\r\n  \\setkomavar{varname}{value_ngerman}\r\n}{}\r\n```\r\n\r\nThe same applies to descriptions:\r\n\r\n```latex\r\n% Default\r\n\\setkomavar*{varname}{description_default}\r\n\r\n% ngerman\r\n\\IfLanguagePatterns{ngerman}{%\r\n  \\setkomavar*{varname}{description_ngerman}\r\n}{}\r\n```\r\n\r\n#### Environmental variables\r\n\r\nTo use your system's environmental variables within your letter:\r\n\r\n1. Define a new variable where `envvarname` is the environmental variable's name (within your system) and `macroname` the macro (variable) name that you will use within your letter.\r\n\r\n  ```latex\r\n  \\getenv[\\macroname]{envvarname}\r\n  ```\r\n2. In your letter simply use `\\macroname` wherever you would like to use the variable's value.\r\n\r\n#### Addressee-independent variables\r\n\r\nWhen writing form letters there may be some addressee-related parts that do not change, e.g. subject, closing, etc. You can set them within the `Addressee-independent` section.\r\n\r\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\r\n\r\n### `logo.png` (Sample Logo)\r\n\r\nSee [Logo](#logo) section above.\r\n\r\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\r\n\r\n### `template.lco` (General Letter Template)\r\n\r\nTo change the letter's general appearance please edit `template.lco`. However, this is only recommended for experienced users.\r\n\r\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\r\n\r\n\r\n\r\n\u003c!-- USAGE--\u003e\r\n## Usage\r\n\r\nTo write your individual letter, open `letter.tex` and edit the following two sections:\r\n\r\n| Section | Description |\r\n---: | ---\r\n`ADDRESSEE` | Recipient-related information, e.g. name, address, etc.\r\n`BODY` | Letter body (text)\r\n\r\n\u003e :exclamation:A manual `\\pagebreak`  has to be set after each page, otherwise the textwdith will not be calculated correctly.\r\n\r\nTo create the final PDF of your letter, change into the `src` directory and run the following command:\r\n\r\n```sh\r\n\u003e lualatex letter\r\n```\r\n\r\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\r\n\r\n\r\n\r\n\u003c!-- ROADMAP --\u003e\r\n## Roadmap\r\n\r\nSee the [open issues](https://github.com/fkemser/GerLaTeXLetter/issues) for a full list of proposed features (and known issues).\r\n\r\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\r\n\r\n\r\n\r\n\u003c!-- CONTRIBUTING --\u003e\r\n## Contributing\r\n\r\nContributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.\r\n\r\nIf you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag \"enhancement\".\r\nDon't forget to give the project a star! Thanks again!\r\n\r\n1. Fork the Project\r\n2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)\r\n3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)\r\n4. Push to the Branch (`git push origin feature/AmazingFeature`)\r\n5. Open a Pull Request\r\n\r\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\r\n\r\n\r\n\r\n\u003c!-- LICENSE --\u003e\r\n## License\r\n\r\nDistributed under the **MIT License**. See [`LICENSE`][license-url] for more information.\r\n\r\n\u003e :warning: The license above does not apply to the sample logo file `/src/logo.png`. For more information please have a look at [Logoipsum's terms of license](https://logoipsum.com/license).\r\n\r\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\r\n\r\n\r\n\r\n\u003c!-- CONTACT --\u003e\r\n## Contact\r\n\r\nProject Link: [https://github.com/fkemser/GerLaTeXLetter](https://github.com/fkemser/GerLaTeXLetter)\r\n\r\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\r\n\r\n\r\n\r\n\u003c!-- ACKNOWLEDGMENTS --\u003e\r\n## Acknowledgments\r\n\r\n###\r\n* [KOMA-Script](https://komascript.de/)\r\n* [Logoipsum](https://logoipsum.com/) (`src/logo.png`)\r\n\r\n###\r\n* [The LaTeX Project](https://www.latex-project.org/)\r\n* [TeX Live - TeX Users Group (tug.org)](https://www.tug.org/texlive/)\r\n* [LuaTeX](https://www.luatex.org/)\r\n\r\n###\r\n* [afterpage (CTAN)](https://www.ctan.org/pkg/afterpage)\r\n* [babel (CTAN)](https://www.ctan.org/pkg/babel)\r\n* [catchfile (CTAN)](https://www.ctan.org/pkg/catchfile)\r\n* [enumitem (CTAN)](https://www.ctan.org/pkg/enumitem)\r\n* [etoolbox (CTAN)](https://www.ctan.org/pkg/etoolbox)\r\n* [fontawesome5 (CTAN)](https://www.ctan.org/pkg/fontawesome5)\r\n* [graphicx (CTAN)](https://www.ctan.org/pkg/graphicx)\r\n* [iflang (CTAN)](https://www.ctan.org/pkg/iflang)\r\n* [ifthen (CTAN)](https://www.ctan.org/pkg/ifthen)\r\n* [qrcode (CTAN)](https://www.ctan.org/pkg/qrcode)\r\n* [scrlayer-scrpage (CTAN)](https://www.ctan.org/pkg/scrlayer-scrpage)\r\n* [sourcesanspro (CTAN)](https://www.ctan.org/pkg/sourcesanspro)\r\n* [scrlttr2 (CTAN)](https://www.ctan.org/pkg/scrlttr2)\r\n* [tabularx (CTAN)](https://www.ctan.org/pkg/tabularx)\r\n* [xstring (CTAN)](https://www.ctan.org/pkg/xstring)\r\n###\r\n* [othneildrew/Best-README-Template](https://github.com/othneildrew/Best-README-Template)\r\n* [Ileriayo/markdown-badges](https://github.com/Ileriayo/markdown-badges)\r\n\r\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\r\n\r\n\r\n\r\n\u003c!-- MARKDOWN LINKS \u0026 IMAGES --\u003e\r\n\u003c!-- https://www.markdownguide.org/basic-syntax/#reference-style-links --\u003e\r\n[contributors-shield]: https://img.shields.io/github/contributors/fkemser/GerLaTeXLetter.svg?style=for-the-badge\r\n[contributors-url]: https://github.com/fkemser/GerLaTeXLetter/graphs/contributors\r\n[forks-shield]: https://img.shields.io/github/forks/fkemser/GerLaTeXLetter.svg?style=for-the-badge\r\n[forks-url]: https://github.com/fkemser/GerLaTeXLetter/network/members\r\n[stars-shield]: https://img.shields.io/github/stars/fkemser/GerLaTeXLetter.svg?style=for-the-badge\r\n[stars-url]: https://github.com/fkemser/GerLaTeXLetter/stargazers\r\n[issues-shield]: https://img.shields.io/github/issues/fkemser/GerLaTeXLetter.svg?style=for-the-badge\r\n[issues-url]: https://github.com/fkemser/GerLaTeXLetter/issues\r\n[license-shield]: https://img.shields.io/github/license/fkemser/GerLaTeXLetter.svg?style=for-the-badge\r\n[license-url]: https://github.com/fkemser/GerLaTeXLetter/blob/master/LICENSE\r\n[linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=for-the-badge\u0026logo=linkedin\u0026colorB=555\r\n[linkedin-url]: https://linkedin.com/in/linkedin_username\r\n[screenshot1]: res/letter-1.png\r\n[screenshot2]: res/letter-2.png\r\n\r\n[LaTeX-shield]: https://img.shields.io/badge/latex-%23008080.svg?style=for-the-badge\u0026logo=latex\u0026logoColor=white\r\n[LaTeX-url]: https://www.latex-project.org/\r\n[Shell Script-shield]: https://img.shields.io/badge/shell_script-%23121011.svg?style=for-the-badge\u0026logo=gnu-bash\u0026logoColor=white\r\n[Shell Script-url]: https://pubs.opengroup.org/onlinepubs/9699919799/\r\n\r\n[din5008]:https://de.wikipedia.org/wiki/DIN_5008\r\n[koma-wiki-url]:https://sourceforge.net/p/koma-script/_list/wiki\r\n[scrlttr2-doc-url]:http://mirrors.ctan.org/macros/latex/contrib/koma-script/doc/scrguide-en.pdf\r\n[scrlttr2-url]:https://www.ctan.org/pkg/scrlttr2","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffkemser%2Fgerlatexletter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffkemser%2Fgerlatexletter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffkemser%2Fgerlatexletter/lists"}