整合 zotero, pandoc 进行文献引用

文章目录

• 前言
• 安装 Zotero 和 Pandoc
• 下载 Zoerto 插件
• 下载 zotxt lua filter
• 安装 pandoc, pandoc-citeproc
• 使用
• • emacs zotxt 步骤
  • 示例代码
• 参考文献

前言

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 插件主页