latex - 如何处理 Ipython Notebook 中的引用？

Question

在 Ipython Notebook 中处理引用的最佳方法是什么？理想情况下，我想要一个 bibtex 文件，然后像在 latex 中一样，在 Ipython Markdown 单元格中有一个简写列表，在笔记本的末尾有完整的引用。

我查到的相关资料是这样的:http://nbviewer.ipython.org/github/ipython/nbconvert-examples/blob/master/citations/Tutorial.ipynb

但我不能很好地遵循文档。谁能解释一下？非常感谢!!

Answer 1

概括
该解决方案主要基于 Sylvain Deville 的 excellent blog post .它允许您简单地编写 [@citation_key]在 Markdown 单元格中。引用文献将在文档转换后格式化。唯一的要求是 LaTeX 和 pandoc，它们都得到了广泛的支持。虽然从来没有保证，但这种方法应该在很多年后仍然有效。
分步指南
除了 jupyter 的工作安装之外，您还需要:

latex (installation guide)。

潘多克 (installation guide)。

一个 引文风格语言 .下载引用样式，例如 APA .保存 .csl将文件(例如 apa.csl )放入与 jupyter notebook 相同的文件夹中(或稍后指定 .csl 文件的路径)。

一个 .bib文件 与您的引用。我正在使用 sample bib file list.bib .保存到与您的 jupyter notebook 相同的文件夹(或稍后指定 .bib 文件的路径)。

完成这些步骤后，剩下的就很简单了:

在 jupyter notebook 的 markdown 单元格中使用 markdown 语法进行引用。例如，[@Sh:1]语法如下: ([@citationkey_in_bib_file]) .与其他解决方案相比，我更喜欢这种语法，因为输入 [@something] 非常快。 .

在 ipython 笔记本的末尾，使用以下语法创建一个代码单元格 自动转换您的文档 (注意这是 R 代码，对于 python，使用与 system() 等效的命令):

 #automatic document conversion to markdown and then to word
 #first convert the ipython notebook paper.ipynb to markdown
 system("jupyter nbconvert --to markdown paper.ipynb")
 #next convert markdown to ms word
 conversion <- paste0("pandoc -s paper.md -t docx -o paper.docx",
                " --filter pandoc-citeproc",
                " --bibliography="listb.bib",
                " --csl="apa.csl")
 system(conversion)

运行此单元(或简单地运行所有单元)。请注意，第二个系统调用只是 pandoc -s paper.md -t docx -o paper.docx --filter pandoc-citeproc --bibliography=listb.bib --csl=apa.csl .我只用了paste0()能够将其分布在多行并使其更易于阅读。
输出是一个word文档。 如果您喜欢其他文档 , 查看 this guide替代语法。

#额外内容

如果您不喜欢转换后的文档包含文档转换的语法，请在代码单元格的上方和下方插入一个 Markdown 单元格，其中包含转换的语法。在上面的单元格中，输入 <!--并在下面的单元格中输入 --> .这是用于注释的常规 HTML 命令，因此这两个单元格之间的语法将是 已评估但未打印 .

您还可以添加 yaml头在你的第一个单元格中。例如。，

 ---
 title: This is a great title. 
 author: Author Name
 abstract: This is a great abstract
 ---