一个Pandoc模板的使用

一个Pandoc模板的使用

这个模板的Github地址为:Wandmalfarbe/pandoc-latex-template, 这个模板的工作流程大概是这样的,首先使用pandoc将Markdown文件转换成tex文件,然后使用Tex Live把tex文件转换为PDF文件。当然原模板是英文的,需要按照本文中介绍的方法稍加修改使之支持中文。


反正我是被这个排版效果惊艳到了,而且这个封面的颜色、字体什么的都是可以自己设置的。于是我毫不犹豫的决定要好好研究这个模板的使用,并决定用这个模板写下学期的Stata讲义。

安装PandocTex Live

Pandoc是个非常强大的文本转换工具,我之前就转好了,但是一直没有直接使用过。一般都是直接使用Atom的MPE插件转换md到pdf。
这两个工具网上的安装教程一大堆,我就不再赘述了。

使用该模板

点击这个连接就能直接下载这个仓库了:pandoc-latex-template.zip

下载解压之后你会发现里面有这个文件:eisvogel.tex,首先把这个文件的后缀改成latex,也就是说把这个文件名改成eisvogel.latex

对于Mac用户,下面你需要将这个文件放到~/.pandoc文件夹下的templates子文件夹中。如果没有这个文件夹需要执行新建。

接下来把终端路径切换到这个文件夹里面的某个示例中,例如:

1
cd '~/Desktop/pandoc-latex-template-master/examples/default-titlepage/'

然后删除掉里面的pdf和图片运行下面的编译命令:

1
pandoc default-titlepage.md -o default-titlepage.pdf --from markdown --template eisvogel --listings

不过如果你把md文档中的加入一些中文,你就会发现中文无法编译。安装下面的方法修改即可。
首先找到刚刚的那个eisvogel.latex,用编辑器打开,在开头的大概这个位置加一句:

这是个中文宏包。

下面就直接说我修改的结果我,例如我想写一份《计量经济学与Stata应用》的讲义,我把这份讲义的开头改成了这个样子:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
---
title: "计量经济学及Stata应用教程"
author: 程振兴
date: "2018-08-18"
subject: "Markdown"
keywords: [Stata, 计量经济学]
subtitle: "Stata数据获取、分析、展示及其在计量经济学中的应用"
toc: true
titlepage: true
titlepage-color: "1f9792"
titlepage-text-color: "FFFFFF"
titlepage-rule-color: "FFFFFF"
titlepage-rule-height: 1
toc-own-page: true
abstract: 这是一个摘要
color-link: "1f9792"
...

注意最下面是三个点不是短线。
然后这个文件的名字是:计量经济学与Stata.md,编译命令是:

1
pandoc 计量经济学与Stata.md -o 计量经济学与Stata.pdf --template eisvogel --highlight-style pygments --listings --latex-engine=xelatex -V mainfont="STSongti-SC-Regular" --number-sections

这里需要使用xelatex引擎。设置主要字体为”STSongti-SC-Regular”,这个是字体册里面的。然后章节使用数字标记。编译效果如下:

感觉非常满意了,不过还是有两个不满意的点:

  1. 里面的代码高亮不支持Stata;
  2. 目录的标题没方法修改。

最后,每次编译都要打开终端输入一大串命令是不是非常麻烦。然后我发现Sublime Text3的这个功能好强大:

于是我就新建了一个编译系统然后输入下面的代码:

1
2
3
{
"shell_cmd": "pandoc 计量经济学与Stata.md -o 计量经济学与Stata.pdf --template eisvogel --highlight-style pygments --listings --latex-engine=xelatex -V mainfont=\"STSongti-SC-Regular\" --number-sections"
}

保存为StataBook.sublime-build,然后 选择:

选择好之后,在md文件页面按Command+B就能直接直接编译了!

最近就要开始写这个《计量经济学与Stata应用讲义》啦!

评论

Your browser is out-of-date!

Update your browser to view this website correctly. Update my browser now

×