整合 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 插件首頁