Pandoc工具笔记总结

1. 安装

参考：

https://zhuanlan.zhihu.com/p/612355849

http://t.csdnimg.cn/WABXA

2. 必备工具说明

pandoc：用来转换格式，务必下载3.1版本，https://pandoc.org/installing.html

pandoc-crossref：一个用于 Pandoc 的插件，用于实现文档中的交叉引用功能。

解压后放于pandoc安装文件夹

https://github.com/lierdakil/pandoc-crossref/releases

它提供了一种简便的方式来引用文档中的标签，生成自动编号，并创建链接以指向被引用的标签。以下是 pandoc-crossref 的主要功能和作用：

• 交叉引用： 允许在文档中引用其他部分的内容，例如章节、图表、公式、表格等。这样可以避免手动维护编号，确保引用的一致性。
• 自动编号： 支持为文档中的各种元素自动生成编号。这包括章节、图表、公式、表格等。自动生成的编号可以通过标签进行引用。
• 引用格式： 允许用户自定义引用的格式。可以设置引用的前缀、后缀、分隔符等。这样可以满足不同排版风格的需求。
• 定制标签： 允许用户为特定元素添加标签，以便在文档其他部分引用。这对于大型文档或需要频繁引用的元素非常有用。
• 多种输出格式： pandoc-crossref 支持多种输出格式，包括 HTML、PDF、Word等。这使得在不同输出格式下仍然能够保持交叉引用的正确性。
• 集成 Pandoc： pandoc-crossref 与 Pandoc 集成良好，可以通过简单的命令行选项启用。它是一个 Pandoc的过滤器插件。

3. 查看版本信息

pandoc --version

4. 其他支持

• 参考文献样式文件：规范化转换为word之后的参考文献格式标准。把这个文件放在pandoc.exe的安装目录中。csl
• 参考模板：IEEE，爱思唯尔

保证当前这个文件夹中必须含有如下几种文件：
pandoc.exe
ieee.csl
pandoc-crossref.exe
LaTex导出的tex文件(main.tex)及其依赖的文件(cite.bib等)

5. 使用

pandoc cas-sc-template.tex --filter pandoc-crossref -M tableEqns -M autoEqnLabels --bibliography cas-refs.bib --citeproc --csl engineering-applications-of-artificial-intelligence.csl --resource-path=.;figs --number-sections -M reference-section-title=Reference -o output.docx

pandoc main.tex -o output.docx -w docx \
       --reference-doc Hindawi_template.docx \
       --filter pandoc-crossref \
       --bibliography=refs.bib \
       --citeproc \
       --csl ieee-transactions-on-communications.csl

–filter pandoc-crossref ：启用 Pandoc 的交叉引用过滤器pandoc-crossref，允许进行交叉引用、自动编号等操作。
–citeproc：使用 Pandoc 的引用处理器，允许从BibTeX 数据库 (cite.bib) 中引用文献。
–csl ieee.csl：指定引文样式 (CSL) 文件，这里使用 IEEE 格式 (ieee.csl) 来格式化文献引用。
–bibliography=cite.bib：指定 BibTeX 数据库文件，其中包含了文献引用的信息。
-M reference-section-title=参考文献：指定生成的文档中文献部分的标题为“参考文献”。
-M autoEqnLabels：启用自动为公式添加标签。
-M tableEqns：在表格中自动为方程添加标签。
-t docx+native_numbering：指定输出格式为 docx，并启用本地编号（native numbering）。
–number-sections：对文档的章节进行编号。
-o output.docx：指定输出文件的名称为 output.docx。
--toc：生成目录 【可选】
--resource-path=.;Figures：指定 tex 源图片的存放文件夹

.;Figures：. 表示当前工作目录，; 是 Windows 系统的分隔符（Linux、Unix、macOs 用 : ），Figures 是存放 tex 源图片的子文件夹的名称
eps、pdf 等格式无法正常转化进 Word 文件，需提前将图片转为 jpg 等格式

pandoc main.tex -o output.docx ^
    --reference-doc template.docx ^
    --filter pandoc-crossref -M tableEqns -M autoEqnLabels ^
    --resource-path=.;Figures ^
    --bibliography ref.bib ^
    --citeproc ^
    --csl references_style.csl ^
    -M reference-section-title=Reference ^
    --number-sections ^
    --toc

pandoc cas-sc-template.tex --reference-doc TII-Articles-Word-template.docx  --filter pandoc-crossref -M tableEqns -M autoEqnLabels --bibliography cas-refs.bib --citeproc --csl engineering-applications-of-artificial-intelligence.csl --resource-path=.;figs --number-sections -M reference-section-title=Reference -o output.docx