| Hugo-Cactus-theme-mod

0001-01-01

2092字

本文由简悦 SimpRead 转码，原文地址 forum.obsidian.md 最初发表在我的博客在这里 334. 检查所有链接（这是我的第一篇文章，所以我仅限于 5 个链接）

目标

我想重复地将 markdown 转换为时尚的自定义 pdf。我用 markdown 来记下我所有的笔记，感谢我对黑曜石的不朽热爱。特别是对于我即将到来的 OSCP 考试重考，我希望能够快速流畅地将我的笔记从黑曜石中取出，变成一份看起来很专业的报告，我可以为上交而感到自豪。

我对完成的定义是这样的：

降价输入生成 PDF 输出
我可以控制足够的风格来使其成为我自己的风格
- 代码块应具有语法突出显示
- 我可以使用我从未完成的颜色和资源投资组合网站 158
- 很高兴拥有：样式在降价_中_控制以影响输出 PDF，从而更轻松地创建模板
我可以轻松地在其他报告中重用该样式
该过程应该易于编写脚本

工具

潘多克
潘润
艾斯福格尔乳胶模板 363
GIMP 为标题页和后续页面制作背景图像

风格

我绝不是设计师，但我相信我正在用我的投资组合网站 158. 网站上的颜色很大程度上受到星际飞船提示的启发，尤其是洋红色，我稍微修改了一下，到处都使用，以及我在 fontjoy 中偶然发现的字体。我真的很喜欢立交桥单声道标题的技术外观，所以我很想在我的报告中使用这些标题。

我的目的是创建一个我打算多次使用的模板，并且我希望使用该模板的报表具有美感。有了这个，以及 Eisvogel LaTex 模板允许您为页面背景和标题页背景设置变量的事实，我开始在 Gimp 中创建这些背景，这些背景是链接文档中页面上的背景，并在下一节中链接为和。titlepage-background: "TitlePageBackground.png"``page-background: "PageBackground.png"

使用 Panrun 和 Eisvogel 模板

Panrun 是一个工具，允许您在 markdown 文档的 yaml 前言中为 pandoc 设置参数，因此您不必记住必须传递的所有参数。我的前言最终看起来像这样：

---
note_type: reference
writing_type: draft
title: Academy.htb
author: 5hade
titlepage: true
titlepage-rule-color: "ff0d8a"
titlepage-background: "TitlePageBackground.png"
titlepage-text-color: "eaecef"
page-background: "PageBackground.png"
colorlinks: "ff0d8a"
toc: true
toc-own-page: true
mainfont: DejaVuSerif
sansfont: Overpass Mono
linkcolor: magenta
urlcolor: magenta
listings-no-page-break: true
code-block-font-size: \scriptsize
output:
  pdf:
    pdf-engine: xelatex
    output: academy-htb.pdf
    from: markdown
    template: eisvogel
    listings: true
---

前两个 yaml 物品不是用于 panrun，而是我在黑曜石金库中使用的前品。块中的那些由 pandoc 使用，其余的都由 Eisvogel 模板直接用于设置 PDF 输出的样式和格式。output

重用模板

现在我已经完成了一次，我可以创建一个模板，以便在我想输出另一个报表时使用。我使用模板程序 92 我的模板看起来像这样：

---
note_type: <% tp.system.suggester(["thought", "media", "transient", "plan", "meeting", "presentation", "reference", "draft"], ["thought", "media", "transient", "plan", "meeting", "presentation", "reference", "draft"]) %>
writing_type: draft
title: <% tp.file.cursor(1) %>
author: <% tp.file.cursor(2) %>
titlepage: true
titlepage-rule-color: "ff0d8a"
titlepage-background: "<% tp.user.home_dir() %>/Pictures/pandoc/TitlePageBackground.png"
titlepage-text-color: "eaecef"
page-background: "<% tp.user.home_dir() %>/Pictures/pandoc/PageBackground.png"
colorlinks: "ff0d8a"
toc: true
toc-own-page: true
mainfont: DejaVuSerif
sansfont: Overpass Mono
linkcolor: magenta
urlcolor: magenta
listings-no-page-break: true
code-block-font-size: \scriptsize
output:
  pdf:
    pdf-engine: xelatex
    output: <%tp.file.title%>.pdf
    from: markdown
    template: eisvogel
    listings: true
---

结果！

以下是制作本文档的结果，以及我用来测试系统的退役 HackTheBox 机器的文章。

令人印象深刻！令人印象深刻

现在_这_具有真正的价值！非常感谢您的分享！

（终于有人使用 YAML _以_正确的方式设置 Pandoc 和 LaTeX 参数了！

好东西！
你用什么来实际将 md 笔记导出到 Latex 等？

哦，我实际上从来没有将文档导出到乳胶。乳胶模板是我在 github 上找到的，它提供了我发现非常有用的选项。对我来说，在所有 yaml 就位的情况下，我实际上要做的就是，它将使用 yaml 标头中设置的选项运行 pandoc。在模板中，它们设置为：panrun <filename>.md

pdf:
    pdf-engine: xelatex
    output: <%tp.file.title%>.pdf
    from: markdown
    template: eisvogel
    listings: true

其运行方式与 Eisvogel 是模板从 GitHub 下载到我的 ~/.pandoc/templates 目录相同pandoc --pdf-engine xelatex -o <filename>.md -f markdown --template eisvogel --listings

你对泛润的替代品有什么想法吗？

似乎必须为此安装红宝石很麻烦
我已经安装了它，但似乎仍然无法正常运行

我在我的包管理器中根本没有看到任何替代方案。查看源代码（潘润 / 盘润在师傅 ·MB21 / 潘润 ·GitHub 27）它只有 185 行 Ruby，可能可以很容易地移植到 Python 或任何对你的用例有意义的东西中。

我的想法完全一样，我将尝试在 python 中创建一个并行

如果您成功了，如果您同意，请在此线程中发布代码！

计划是在 github 上放一些东西。可能需要一点时间，但一旦我有了它就会发回这里。

仅供参考：我认为您甚至可以简化一下，因为 Pandoc 现在拥有用于从 YAML 文件读取元数据的选项 59 跟。所以基本上，你不需要 panrun。--defaults=FILE

尽管如此，工作流程还是不错的

哦！这很整洁，我没见过。有了这个，你不会失去使用模板器附带的替换的能力吗？我阅读文档中该部分的方式，看起来这看起来像是寻找一个独立的 yaml 文件，而不是能够读取降价前言中的 yaml。也许我对此的理解是不正确的。我认为 panrun 的目的是能够在每个文档的基础上更改内容，例如，如果您想更改文件名，或者如果您为不同的报告有不同的标题页。

如果您也在寻找一个，我很乐意做出贡献！不反对红宝石，但我更喜欢我所有的工具 python！

我认为你是对的。据我所知，有一个 Pandoc 开发人员之间正在进行的讨论是否将所有信息包含在一个文件中 48.