From f76a30f1eebaddd83f13d45139df59d0f1b031e8 Mon Sep 17 00:00:00 2001 From: ckrenslehner Date: Fri, 27 Sep 2024 10:23:03 +0200 Subject: [PATCH 1/3] docs: add conversion to pdf to tips-and-tricks --- website/docs/tips-and-tricks.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/website/docs/tips-and-tricks.md b/website/docs/tips-and-tricks.md index 8bb851512e..c538cedb38 100644 --- a/website/docs/tips-and-tricks.md +++ b/website/docs/tips-and-tricks.md @@ -90,3 +90,15 @@ commit_parsers = [ ```jinja2 {{ get_env(name="CI_PROJECT_URL") }}/-/tags/{{ version }} ``` + +## Convert the markdown output to pdf + +```bash +pandoc --from=gfm --to=pdf -o CHANGELOG.pdf CHANGELOG.md +``` + +To support unicode characters use `xelatex` as pdf engine and a font family which includes the needed unicode characters + +```bash +pandoc --from=gfm --to=pdf --pdf-engine=xelatex -o CHANGELOG.pdf CHANGELOG.md --variable mainfont="Segoe UI Emoji" +``` From 52902262a6aa56d1a0653e1586d79da1f650f49f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Orhun=20Parmaks=C4=B1z?= Date: Fri, 27 Sep 2024 17:02:32 +0300 Subject: [PATCH 2/3] Update website/docs/tips-and-tricks.md --- website/docs/tips-and-tricks.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/tips-and-tricks.md b/website/docs/tips-and-tricks.md index c538cedb38..c57e43006f 100644 --- a/website/docs/tips-and-tricks.md +++ b/website/docs/tips-and-tricks.md @@ -91,7 +91,7 @@ commit_parsers = [ {{ get_env(name="CI_PROJECT_URL") }}/-/tags/{{ version }} ``` -## Convert the markdown output to pdf +## Convert markdown output to PDF ```bash pandoc --from=gfm --to=pdf -o CHANGELOG.pdf CHANGELOG.md From 76bd4264403544b5ffdb233346ca3a03886db15d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Orhun=20Parmaks=C4=B1z?= Date: Fri, 27 Sep 2024 17:02:38 +0300 Subject: [PATCH 3/3] Update website/docs/tips-and-tricks.md --- website/docs/tips-and-tricks.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/tips-and-tricks.md b/website/docs/tips-and-tricks.md index c57e43006f..7649ac7ccb 100644 --- a/website/docs/tips-and-tricks.md +++ b/website/docs/tips-and-tricks.md @@ -97,7 +97,7 @@ commit_parsers = [ pandoc --from=gfm --to=pdf -o CHANGELOG.pdf CHANGELOG.md ``` -To support unicode characters use `xelatex` as pdf engine and a font family which includes the needed unicode characters +To support unicode characters, use `xelatex` as PDF engine and a font family which includes the needed unicode characters: ```bash pandoc --from=gfm --to=pdf --pdf-engine=xelatex -o CHANGELOG.pdf CHANGELOG.md --variable mainfont="Segoe UI Emoji"