我们所有的实验室和学习模块都使用 Markdown,一切都运行良好。我们使用 Typora 进行所有编辑,因为它为(非技术)用户提供了一种以人类可读格式(即所见即所得)查看其输出的快速方法。 然而,管理层表示希望对 Markdown 文件进行一些自定义,以便更准确地反映代码。换句话说,他们希望用户输入在围栏代码中以粗体显示。此外,他们想要一个目录,当转换为 PDF 格式时可以点击。
针对此问题,我开始使用 Eisvogel。除了粗体代码字体之外,它几乎可以完成所需的所有操作。我能够通过使用公式获得一些基本的粗体:
lab@desktop:~$ ssh [email protected]
[email protected]'s password:
[lab@centos1 ~]$
但是,他们仍然想要彩色背景,尽管这不是必需的。
理想情况下,他们想要一些 O'Reilly 式的东西,如下所示:
我还在第一个 Lab 文件的开头包含了一些 LaTeX 代码,它确实提供了很多功能。而且,我在 Eisvogel 文档中添加了额外的文本,这样我就可以拥有多色文本框。
对粗体代码字体有什么建议吗?
我已经阅读了这里的所有帖子,并且我认识到 Markdown 只接受代码,并且不会用它做任何其他事情。然而,我已经使用 LaTeX 做了类似的事情,但除了将每个人都转移到 LaTeX(这对 ndev 人员来说不太好)之外,我想知道是否有一种方法可以将 TeX 代码合并到 Markdown 中,就像我对测试实验室。
这是我的
build.sh
文件:
pandoc --toc \
--toc-depth 2 \
"T1.md" \
-s -o "Test_v23.pdf" \
--from markdown \
--filter=pandoc-latex-environment \
--template "eisvogel.tex" \
--listings
我尝试添加 T1.md 文件的内容和 eisvogel.tex 文件中的自定义项目,但它看起来像垃圾邮件,考虑到这篇文章的长度,现在可能是......
提前致谢。
我能够使用以下约定使其发挥作用。在我的 Markdown 代码中,我添加了以下几行:
::: code
\begin{Verbatim}[commandchars=\\\{\},fontsize=\small,breaklines=true]
test@rtr> \textbf{telnet 172.16.10.1 port 21}
\end{Verbatim}
:::
我将所有代码嵌入到开头的
::: code
和结尾的 :::
中。我还使用 LaTeX 命令 \begin{Verbatim}[commandchars=\\\{\},fontsize=\small,breaklines=true]
强制所选代码采用逐字格式。
以
test@rtr>
开头的行是提示符,然后为了使命令以粗体显示,我使用了 LaTeX 命令 \textbf{}
,同时将命令括在大括号内。
但是,由于我使用 Eisbogel 模板生成输出,因此它还需要添加一些代码,以便它知道如何处理此选择。
我将以下两行添加到我的 eisvogel.tex 文件中:
\usepackage{fvextra}
\DefineVerbatimEnvironment{Highlighting}{Verbatim}{breaklines,fontsize=$if(code-block-font-size)$$code-block-font-size$$else$\small$endif$,commandchars=\\\{\}}
我相信这就是我所做的一切。自从我开始工作以来已经有几个月了,但我想与其他人分享。如果您有任何疑问,请联系我。很高兴分享我修改后的模板。