pandox怎么用_神器Pandoc的安装与使用 | Flyaway's Blog
前言
其实很早就知道Pandoc这个东西了,只是一直没有什么需求促使我去使用它。平时写博客虽然也是用Markdown,但是由于Jekyll并不支持Pandoc,所以也没有特别去研究它(目前博客使用的是Kramdown渲染器,它在很多扩展语法都是借鉴Pandoc的。)。可是时过境迁,现在平时需要写一些非正式报告和总结,每次使用word的时候总觉得不舒服,有次为了调整一个段落的行距搞了1个多小时,虽然可以说是我自己没有学好word的基本操作,但是每次为了寻找一个功能"翻箱倒柜"地在网上找方法,彻底破坏了写作的情绪,这实在让我很难受。因此我选择markdown来进行平时的写作,为了达到这个目的,必须要选择一个markdown的渲染器,网上有着各式各样的渲染器,还有一些可以直接在线渲染的网站。但是平时在本地编辑的时候,总要开个浏览器,这实在让人接受不了。在众多渲染器中,最先映入眼帘的就是Pandoc了,号称为文本格式转换的瑞士军刀,既然有了这个称号,说明其功能是非常不错的。后来查了一下,发现果然是一个神器,它甚至可以生成pdf和docs!
Pandoc的官网在这里,网上有很多具体介绍Pandoc的文章,其中质量比较高的有:
本文就不再赘述上面文章提到过的一些基本概念和操作了,如果读者还不知道Markdown和Pandoc是什么的话,请阅读上述文章。
配置
具体的安装过程上述文章和Pandoc的官网上都有,此处不再细说了,这里主要说明一些在安装过程遇到的问题和解决方法(以windows7为例)。
系统路径
在Windows下Pandoc安装的时候,默认是安装在用户主目录下的,以win7为例,就是C:\Users\USERNAME\AppData\Local\Pandoc,照理来说安装程序是应该会把这个目录添加到Path中去的,但是我发现并没有自动添加,因此首先要将这个目录手动加入到Path中,这样才能在任何的目录下进行调用。
生成HTML
就我自己而言,我使用Pandoc最主要的功能就是利用它来生成HTML和PDF文件,本节先讨论HTML的配置方法,下一节再来说明pdf的配置。
其实将markdown生成html,是Pandoc最基本的一个功能,使用起来也是非常简单的,打开cmd,切换到makrdown文本所在的目录,写入如下代码
1pandoc in.md -o out.html
程序运行之后,就会在当前目录下生成一个相应的out.html文件。
CSS样式
上面这是最基本的用法了,但是这还不能满足我的日常需求,单纯的html文件太过单调了,只有配上相应的CSS样式,才能使得文本以更加优美的方式展现出来。
可喜的是pandoc完全支持加入css一起渲染,利用如下的命令:
1pandoc in.md -c style.css out.html
其中style.css是为生成的html文件编写的样式文件,但是这个style.css应该放在哪呢?放在当前目录下,当然没问题,但是每次编写markdown的时候,都要将这个css文件复制到当前目录下,那岂不是很麻烦?因此我要想办法把它放在一个固定的地方,每次直接调用就可以了。
这就引出了pandoc的默认目录了,可以通过pandoc --version命令来查看pandoc当前的默认目录,还是以windows7为例,它的默认目录是C:\Users\USERNAME\AppData\Roaming\pandoc ,只需要将这个style.css文件放入到这个目录下,那么在任意目录使用pandoc时,都能自动读取到这个文件,而且,如果需要一些特殊的css样式,可以在当前目录编写,pandoc会自动使用当前目录下的style.css替代默认目录中的style.css文件。
生成独立HTML
通常来说,写作的目的是写给别人来看的,但是如果是使用html文件的格式的话,那么每次传输都需要传送整个目录文件,因为会有很多图片或css文件需要一起被传送,否则html会无法正确显示。这显然是很麻烦的,有没有办法让pandoc在生成的时候,自动把style.css中样式代码直接嵌入到html中呢?办法当然是有的,主要是参考了这篇文章。主要有两种方法:
第一种是使用方法是使用如下的命令:
1pandoc -s -H style.css in.md -o out.html
但是当我试用这种方式的时候,发现style.css文件必须放在当前目录下,这个命令才能正常执行,否则会报错说找不到style.css文件。
另外一种更加好的方式使用--self-contained参数:
1pandoc -s --self-contained -c style.css in.md -o out.html
这个命令不但会把css文件嵌入到html中,它会把所有外部文件全部压缩进单个html文件中,包括图片、视屏、音乐等。这是何等强大的功能!!
利用上述这个命令,就能将markdown文档轻易地生成一个真正独立的html文件,不需要任何其他外部文件支持,这就非常方便传递了。
生成pdf
生成一个pdf文件也是pandoc的主要功能之一,但是它要依赖于latex,如果需要使用pandoc来生成pdf文件,那么需要另外安装Latex,pandoc官方推荐安装MiKTeX,具体安装过程也不说了,非常简单。安装好MikTex之后,可以利用如下的命令来生成pdf:
1pandoc in.md -o out.pdf
但是这样命令会出现这样的错误
! Package inputenc Error: Unicode char \u8:鍒?not set up for use with LaTex. pandoc: Error producing PDF from Tex source. See the inputsnc package documentation for explanation. ...
原因是pandoc默认选择的pdf引擎是pdflatex,而pdflatex是不支持中文的,因此会发生上述错误。因此在使用pandoc的时候,可以手动指明Latex引擎为xelatex,这是完全支持中文显示的。这样我们的命令就变成了:
1pandoc in.md -o out.pdf --latex-engine=xelatex
使用这个命令能够正常的编译出pdf文件,但是当你打开编译出来的pdf文件时,会发现其中的中文部分全是空白,这是字体的问题,因为Latex的默认字体是不支持中文的,因此我们可以继续修改命令:
1pandoc in.md -o out.pdf --latex-engine=xelatex -V mainfont=SimSun
其中mainfont参数是用来指明所使用的字体,SinSun表示的是宋体,你可以选择其他支持中文的字体。
但是这个命令还是有问题的,打开生成的pdf,你会发现其中的中文完全是没有断行的,这是因为pandoc本身对中文支持不够,但这不是说我们没有解决方案,解决方案是使用网友编辑好的latex模板来生成pdf,这里用到的是tzengyuxio提供的pm-template.latex4。 下载模板后将其中的LiHei Pro字体替换成系统中安装有的中文字体即可,然后编译命令改为
1pandoc in.md -o out.pdf --latex-engine=xelatex --template=pm-template.latex
这时就能生成一个比较完美的pdf文件了。
Vim与Pandoc
既然现在有了panodc这个神器,那么大部分的文本编辑操作我就可以在Vim中进行了,而不需要去使用那个无比臃肿的word了,配合Vim强大的定制功能,我就能配置出一个功能完善的pandoc写作环境了。
这显然又是一个很深的话题,这里我只是稍微写一下配置过程,因为我自己本身也还在研究当中。
首先可以为markdown文件映射几个命令,使得可以快捷的生成html,在Vim的_vimrc文件中加入如下代码:
1
2
3
4
5
6
7
8
9
10
11
12function! ToHtml()
exec 'w'
exec "!pandoc -s -S --self-contained -c style.css % -o %<.html>
endfunction
function! ToPdf()
exec 'w'
exec "!pandoc % -o %<.pdf>
endfunction
:nmap :call ToHtml()
:nmap :call ToPdf()
上述的代码中,我首先定义了两个函数,分别是用来调用pandoc来生成html和pdf文件的,然后映射了两个快捷键和去调用这两个函数,这样就实现了直接在Vim中调用pandoc生成html或pdf,而不再需要通过命令行来调用。
最后推荐一个比较好的pandoc插件:vim-pandoc,这个插件我也是刚刚开始使用,感觉还不错,值得推荐。
参考资料
如果发现没有pandoc命令,说明还没有将安装目录添加到系统Path中,请查看上一节内容。 ↩
pandox怎么用_神器Pandoc的安装与使用 | Flyaway's Blog相关推荐
- 2345电脑管家_极限挑战:同时安装4大国产杀毒软件,我的电脑是最安全的?
还没到国庆假期,老毛桃就提前给自己放了假,闲着就作妖,这不?现在就忙着卸载.人固有一秃,或秃于科研,或秃于卸载!说到作妖,是怎么一回事呢?此前不少网友私信让老毛桃挑战一下同时安装360和电脑管家.对此 ...
- python进行数据分析需要安装哪两个库_对Python进行数据分析_关于Package的安装问题...
一.为什么要使用Python进行数据分析? python拥有一个巨大的活跃的科学计算社区,拥有不断改良的库,能够轻松的集成C,C++,Fortran代码(Cython项目),可以同时用于研究和原型的构 ...
- 可道云 docker 群晖_群晖NAS安装影视客户端新手教程,手把手教你NAS怎么下载电影...
群晖NAS安装影视客户端新手教程,手把手教你NAS怎么下载电影 前言 故事的起点在2016年,那时候中了nas的毒,自己diy了一台黑裙,连安装加使用,把玩了一周后,感到一阵索然无味... 然后这台n ...
- 素材管理神器 Eagle 下载安装使用教程
素材管理神器 Eagle 下载安装使用教程 Eagle 可以轻松收集及整理设计项目的"案例.灵感.截图.图片.视频.音频.情绪板"等各种素材,激发更多创意灵感,让工作变得更有效率! ...
- kodi树莓派_树莓派Raspberry Pi 安装XBMC(Kodi)方法及使用教程
树莓派Raspberry Pi 安装XBMC(Kodi)方法及使用教程4 C i9 E$ h! o' Z) j1 w7 Y* S( } p3 _( y" h, V/ C4 P. K& ...
- 字幕剪切视频神器AutoCut的安装和使用
大家好,我是herosunly.985院校硕士毕业,现担任算法研究员一职,热衷于机器学习算法研究与应用.曾获得阿里云天池比赛第一名,科大讯飞比赛第三名,CCF比赛第四名.拥有多项发明专利.对机器学 ...
- 内网穿透神器Frps一键安装脚本及设置教程
frps 是一个高性能的反向代理应用,可以帮助您轻松地进行内网穿透,对外网提供服务,支持 tcp, http, https 等协议类型,并且 web 服务支持根据域名进行路由转发. *因为frps是g ...
- FANUC协作机器人CRX系列_规格特点和安装调试(一)
FANUC协作机器人CRX系列_规格特点和安装调试(一) CRX系列协作机器人目前有2种型号:CRX-10iA和CRX-10iA/L, CRX-10iA型: 该型号为标准版协作机器人,运动半径可达12 ...
- [MacOSX]_[LaunchDaemons]_[Mac OS X 安装Tomcat开机启动服务的方法之一]
场景: 1. Hudson作为持续集成软件,是需要在一个Java web容器部署的才能使用的,一般最常用的就是Tomcat. 2. Tomcat在Windows上部署安装Services很容易,使用自 ...
- ubuntu双系统引导梅花_手把手教你安装win10+Ubuntu16.04的双系统(全网最详细)
点击"小詹学Python",选择"置顶"公众号 重磅干货,第一时间送达 本文转载自AI蜗牛车,禁二次转载 前言 本系列为小白入门整个AI项目教程,主要涉及双系统 ...
最新文章
- [转]几种最短路径算法的比较
- 工程实践也能拿KDD最佳论文?解读Embeddings at Airbnb
- 探索JAVA并发 - 悲观锁和乐观锁
- NASA发现超级地球,真的适宜居住?
- Linux命令【二】终端+Vim
- FFmpeg在Windows系统下的编译过程
- Chrome谷歌浏览器私密浏览自动开启功能获批专利
- Netbeans加入CI的代码提示
- 【Linux】字符转换命令join
- 提高C#编程水平不可不读的50个要诀
- 22.c语言各种输入输出与错误处理
- libudev-dev : Depends: libudev0 (= 175-0ubuntu9) but 175-0ubuntu9.3 is to be installed 错误解决方案...
- Python爬虫课--第二节 爬虫请求模块 urllib.request,urllib.parse,requests模块
- kaggle猫狗分类
- 爬虫一:用正则表达式爬取图片
- 简单实用算法——人民币金额大写转换
- 中国电信9月在京推5G新号段,资费199元至599元?
- Win11系统点击wifi图标没有反应怎么解决?
- 未来天择计算机,三体吧关于计算机智能进化的讨论,拿来大家考虑一下
- 2105-小泉的难题