Pandoc 风格的引文

Pandoc http://www.johnmacfarlane.net/pandoc/使用 Markdown 格式，支持使用 BibTeX 文件中的键自动引用。该格式的一些示例如下：

Blah blah [@doe99]

Blah blah [@doe99, p.33]

Blah blah [see @doe99, pp. 33-35; also @smith04, ch. 1].

Emacs 和 Pandoc/Markdown

有一个Pandoc模式 http://wwwuser.gwdg.de/~jkremer/pandoc-mode.html通过 Emacs 与 Pandoc 交互，可以与降价模式 http://jblevins.org/projects/markdown-mode/。 Pandoc-Mode 和 Markdown-Mode 不支持自动完成 bibtex 文件的引文。对 TeX 文件具有这种支持的模式是Reftex https://www.gnu.org/software/auctex/reftex.html。我正在寻找一种在编辑 Markdown 文件时获得 Reftex 式自动完成功能的方法。

其他编辑器中的自动完成

Textmate有一个解决方案：在 textmate 中自动完成 bibtex 文件中的 pandoc 风格引文 http://snipplr.com/view/19519/.

该功能还在于Vim-潘多克 https://github.com/vim-pandoc/vim-pandoc:

自动完成是通过破解来实现的乳胶盒 http://www.vim.org/scripts/script.php?script_id=3109实施 bibtex 引文补全，即使结果 看起来不太像原来的。

如何从 Emacs 中的 bibtex 文件中自动完成 pandoc 样式的引文？

为此，您可以使用reftex-citation.

Setup

启用 RefTeX

您必须为您正在编辑的文件启用 RefTeX，这可以通过M-x reftex-mode或通过设置文件变量 http://www.gnu.org/software/emacs/manual/html_node/emacs/Specifying-File-Variables.html比如添加-*- mode: reftex; -*-到文件的第一行。

告诉 RefTeX 你的参考书目在哪里

你需要告诉 RefTeX你的参考书目文件在哪里 https://tex.stackexchange.com/a/54825/5701。这可以通过将以下内容添加到 .emacs 中（并根据您的设置编辑路径）来完成：

;; So that RefTeX finds my bibliography
(setq reftex-default-bibliography '("path/to/bibfile.bib"))

注意reftex-default-bibliography是一个列表，因此您可以向其中添加多个路径。

如果您对不同的文件使用不同的参考书目，最好告诉 RefTeX 每个文件的参考书目。恐怕我只知道一种丑陋的方法来做到这一点。这个想法是，由于 RefTeX 可以从 LaTeX 宏中提取正确的参考书目，因此您可以在注释中嵌入 LaTeX 宏。因此，您可以将这样的注释与参考书目规范一起添加到 Pandoc：

bibliography::bibliography_name.bib
<!-- \bibliography{bibliography_name} So that RefTeX knows about the bibliography -->

告诉 RefTeX 如何格式化引文

To get reftex-citation要插入 Pandoc 使用的格式，您必须自定义reftex-cite-format http://www.gnu.org/software/auctex/manual/reftex/reftex_60.html例如将以下内容插入到您的 .emacs 中：

(eval-after-load 'reftex-vars
  '(progn 
     (setq reftex-cite-format '((?\C-m . "[@%l]")))))

您可能还想包含其他格式。有关如何执行此操作的说明，请参阅https://tex.stackexchange.com/a/31992/5701 https://tex.stackexchange.com/a/31992/5701。请注意，此设置是全局的，因此如果您也将 RefTeX 用于 LaTeX，它也会受到影响。

Use

To insert a citation either do M-x reftex-citation or C-c [ then press Enter and you are allowed to insert a search term for searching in your bibliography. RefTeX will then insert the key of the bibliography item you selected in Pandoc format.