pandoc 确实是神器啊。加上对 docx 的支持也很棒了,现在来仔细阅读一番 Eisvogel latex 模板的使用了。比 docx 的操作更加的灵活。关于 pandoc 的基本相关知识见 使用pandoc转换pdf与docx加上书签目录
基本使用
pandoc example.md -o example.pdf --from markdown --template eisvogel --listings |
注意,这里的
--template eisvogel
表示使用 eisvogel 这个模板的意思。这样使用,必须保证 eisvogel 这个模板放在data-dir
下面。想知道 data-dir 是在什么位置,可以使用命令
pandoc -v
进行查看。
比如我用 brew 在 macOS 安装的 pandoc
Default user data directory: /Users/username/.local/share/pandoc or /Users/username/.pandoc 就是在这里了。
因此我们只需要将 eisvogel.latex 放到这个目录下面就可以保证上面的命令会执行成功了。
页眉页脚
如果想要更好看规范的页眉和页脚的话,我们需要提供一些元数据。通过在 md 文件中,设置一个 YAML metadata block 在开始处。我们的文件可能看起来是这样的:
--- |
自定义模板变量
以下内容中,括号里面的代表了默认值。
封面设置
titlepage
(false
) 是否启用标题页(封面页)titlepage-color
(FFFFFF
)封面页的背景颜色。这个值必须设置成 HTML 16进制的颜色值,和D8DE2C
这样,没有开头的#
。同时,建议加上双引号(避免颜色被截断,如000000
会被识别成0
)。titlepage-text-color
(5F5F5F
) 封面页的文本颜色titlepage-rule-color
(435488
) 封面页顶部的横条颜色titlepage-rule-height
(4
) 封面横条的高度。(单位是 磅)titlepage-background
封面的背景图片路径。图片会被缩放来覆盖整个页面。logo
在封面页显示的图片路径。路径总是相对于 pandoc 被执行的位置。选项--resource-path
没有作用。logo-width
(100
) logo 的宽度(磅)
页眉页脚
header-left
(标题
) 页眉左部的文本header-center
页眉中间的文本header-right
(日期
) 页眉右部的文本footer-left
(作者
) 页脚左部文本footer-center
页脚中部文本footer-right
(页码
) 页脚右部文本
页面设置
page-background
所有页面的背景图片。会被缩放。page-background-opacity
(0.2
) 背景图片透明度caption-justification
(raggedright
) 图片表格等题注的对齐方式。(使用 caption 包的justification
参数)toc-own-page
(false
) 是否在目录后开始一个新的页面。(传递--toc
选项到 pandoc 命令)listings-disable-line-numbers
(false
) 禁用列表的序号listings-no-page-break
(false
) 列表内避免分页符disable-header-and-footer
(false`) 禁止页眉页脚footnotes-pretty
(false
) 脚注美化(需要footmisc
包)footnotes-disable-backlinks
(false
) 禁止从页尾的脚注到内容中出现脚注位置的引用跳转。(启用的话需要包footnotebackref
)book
(false
) typeset as bookfirst-chapter
(1
) 如果类型设置是有章节号的 book,设置第一章被赋予的值float-placement-figure
(H
) 重置图片的默认位置。可用的修饰符如下,前四个修饰符可以联合起来用:h
: here, i.e., approximately at the same point it occurs in the source text.t
: top of the page.b
: bottom of the page.p
: next page that will contain only floats like figures and tables.H
: Place the float HERE (exactly where it occurs in the source text). TheH
specifier is provided by the float package and may not be used in conjunction with any other placement specifiers.
table-use-row-colors
(false
) 启用表格行的颜色。默认是false
,因为颜色会扩展到表格的边缘,当前没有任何办法来进行改变。code-block-font-size
(\small
) 用来改变代码块内字体大小的 LaTeX 命令。可用的值是:\tiny
,\scriptsize
,\footnotesize
,\small
,\normalsize
,\large
,\Large
,\LARGE
,\huge
and\Huge
. 这个选项会改变使用 verbatim 环境的默认代码块和有列表的代码块的字体大小。
Latex 基本概念
控制序列(control sequence):一组由
\
开始的命令。有两种类型的控
制序列:\
之后紧随一个多个单词组成的控制字(control word)和\
之后紧
随一个非字母组成的控制符(control symbol)。环境(environment):LaTeX中的环境主要用于对一块数据进行排版。其格
式如下:\begin{environment_name}
The content ...
\end{environment_name}