引用和参考书目¶
您可以使用存储在图书文件夹中的 bibtex
文件中的引用来添加引用和参考书目。然后,您可以使用 {cite}
角色在 Markdown 中添加一个引用,并使用 {bibliography}
指令包含 bibtex 文件中的书目。
参见
这个功能使用了优秀的 sphinxcontrib-bibtex 扩展。
更改内联引用样式¶
您可以使用一些替代角色来更改内联引用样式。下面是一些例子:
引文
{cite:p}`perez2011python`
结果是 [Perez et al., 2011]引文
{cite:t}`perez2011python`
结果是 Perez et al. [2011]引文
{cite:ps}`perez2011python`
结果是 [Perez, Granger, and Hunter, 2011]引文
{cite:ts}`perez2011python`
结果是 Perez, Granger, and Hunter [2011]
参见
要获得更完整的内联引用样式列表,请查看 sphinxcontrib-bibtex
文档。
选择你的参考书目样式¶
您还可以自定义引用的样式。默认情况下,引用以 alpha
样式显示。其他当前支持的样式包括 plain
、unsrt
和 unsrtalpha
。这些样式创建以下书目格式:
alpha
: 使用字母数字(alphanumeric)的引用标签,引用按作者、年份排序。plain
: 使用数字(numeric)参考标签,引文按作者、年份排序。unsrt
: 使用数字参考标签,引文按外观顺序排序。unsrtalpha
: 使用字母数字(alphanumeric)引用标签,引用按外观顺序排序。
要设置你的参考样式,使用style
选项:
```{bibliography}
:style: unsrt
```
更改引用样式¶
有几个选项可以作为内联引用的格式。要选择一个,请使用 _config.yml
中的以下配置。
# In _config.yml
# In _config.yml
sphinx:
config:
bibtex_reference_style: author_year # label, super, and author-year.
参见
有关配置选项列表和更多细节,请参阅 sphinxcontrib-bibtex
文档
局部参考书目¶
您可能希望在每个文档的末尾包含一个参考书目列表,而不是在单独的文档中包含一个单独的参考书目。然而,拥有多个书目指令可能会导致 sphinx
发出 duplicate citation warnings
。
一个常见的修复方法是在 bibliography 指令中添加一个 filter
:
```{bibliography}
:filter: docname in docnames
```
参见 局部参考书目 中的 sphinxcontrib-bibtex
文档。
参考书目示例¶
参考书目示例:
- CKS+10
J Gregory Caporaso, Justin Kuczynski, Jesse Stombaugh, Kyle Bittinger, Frederic D Bushman, Elizabeth K Costello, Noah Fierer, Antonio Gonzalez Pena, Julia K Goodrich, Jeffrey I Gordon, and others. Qiime allows analysis of high-throughput community sequencing data. Nature methods, 7(5):335–336, 2010.
- HdHP+16
Christopher Ramsay Holdgraf, Wendy de Heer, Brian N. Pasley, Jochem W. Rieger, Nathan Crone, Jack J. Lin, Robert T. Knight, and Frédéric E. Theunissen. Rapid tuning shifts in human auditory cortex enhance speech intelligibility. Nature Communications, 7(May):13654, 2016. URL: http://www.nature.com/doifinder/10.1038/ncomms13654, doi:10.1038/ncomms13654.
- PGH11(1,2,3,4)
Fernando Perez, Brian E Granger, and John D Hunter. Python: an ecosystem for scientific computing. Computing in Science \\& Engineering, 13(2):13–21, 2011.
- SK14
John Stachurski and Takashi Kamihigashi. Stochastic stability in monotone economies. Theoretical Economics, 2014.