整合 zotero, pandoc 进行文献引用

前言

Zotero 是常用的知识、文献管理软件，而 Pandoc 可以对文档进行不同格式的转换，实现一次写作(markdown之类)，得到多种文档(html, pdf, docx, ppt, beamer, epub等等)。有机结合两者，可以自由实现文档转换和文献引用。

安装 Zotero 和 Pandoc

参考文献的相应主页有介绍，不再赘述。

下载 Zoerto 插件

1. better bibtex

   aria2c -x 16 -k 1m -c https://github.com/retorquere/zotero-better-bibtex/releases/download/v5.4.29/zotero-better-bibtex-5.4.29.xpi
   

2. zotxt

   aria2c -x 16 -k 1m -c https://github.com/egh/zotxt/releases/download/v5.1.4/zotxt-5.1.4.xpi
   

3. 安装插件

   zotero 中 tools -> add-ons -> Install add-on from file 分别安装上述的两个 xpi 文件

下载 zotxt lua filter

zotxt_version="1.0.0"
aria2c -x 16 -k 1m -c https://github.com/odkr/pandoc-zotxt.lua/archive/refs/tags/"$zotxt_version".tar.gz
tar xf ./pandoc-zotxt.lua-"$zotxt_version".tar.gz
# pandoc --version
mkdir -p ~/.pandoc/filters
mv ./pandoc-zotxt.lua-"$zotxt_version" ~/.pandoc/filters/
cd ~/.pandoc/filters
ln -s pandoc-zotxt.lua-"$zotxt_version"/pandoc-zotxt.lua ./pandoc-zotxt.lua

安装 pandoc, pandoc-citeproc

根据发行版的包管理软件进行，Gentoo

emerge pandoc pandoc-citeproc

使用

在 org 或者 markdown 文件中，通过 @XXX 的方式添加参考文献，其中 XXX 是 citekey，由 zotero 中的 better bibtex 插件生成。 Emacs 编辑器可以通过 zotxt 插件，在编辑器中直接搜索题录并添加 citekey。然后根据输入文件的格式和输出文件的格式，修改示例代码就可以。

emacs zotxt 步骤

M+x 运行 zotxt-citekey-insert (默认的快捷键是 C+c " k)

1. 选择 search method
   

2. 输入 query (AI)
   

3. 选择题录
   

4. 自动插入了 citekey (@caoLearningRankPairwise2007)
   

5. pdf 和 MS Word 的效果

   PDF 效果
   
   MS Word (.docx) 效果
   

示例代码

1. org mode to pdf(latex)

   pandoc -L pandoc-zotxt.lua --filter /usr/bin/pandoc-citeproc -f org -t latex -o tmp.pdf tmp.org
   

2. org mode to MS Word

   pandoc -L pandoc-zotxt.lua --filter /usr/bin/pandoc-citeproc -f org -t docx -o tmp.docx tmp.org
   

3. markdown to pdf(latex)

   pandoc -L pandoc-zotxt.lua --filter /usr/bin/pandoc-citeproc -f markdown -t latex -o tmp.pdf tmp.md
   

参考文献

1. Pandoc 主页
2. Zotero 主页
3. Better Bibtex 主页
4. pandoc-zotxt.lua 主页
5. zotxt 主页
6. zotxt-emacs 插件主页