斯芬克斯文献引文管理¶
介绍¶
重构文本 引文 不适合插入式参考（A.K.A. `Harvard System of Referencing`_ ）
另一种选择是（手动）使用 `authorship trigraph`_ （在旧的计算机科学课本中很常见）。
引文以4个字母开头：
一位作者：名字的前4个字母
两位作者：前两位作者1，前两位作者2
三位作者：前两位作者1、第一位作者2、第一位作者3
四位作者：每位作者的第一个字母
四位以上作者：前四位作者的第一个字母
名字的第一个字母总是大写。
在作者的首字母后，加上年份的两个数字（忽略世纪消歧）。
如果两个引用的符号完全相同，则附加一个小写字母。
为了便于编辑，引文文本应保存在文档底部的“参考”标题后面，如：
.. rubric:: References
.. [BiDB79] Biskup, J.; Dayal, U.; Bernstein, P.A..: Synthesizing independent database schemas. In: ACM SIGMOD 1979 Int. Conf. On Management of Data Proceedings, S. 143-151.
.. [BeBe79a] Beeri, C.; Bernstein, P.A.: Computational problems related to the design of normal relational schemas. ACM Trans. Database Syst., No. 1, 1979, S. 30-59.
.. [BeBe79b] Beeri, C.; Bernstein, P.A.: Computers are stupid. ACM Trans. Database Syst., No. 4, 1979, S. 253-266.
类似的选择是使用bibtex alpha 样式：
一位作者：姓氏的前3个字母
两到四位作者：姓氏的首字母连接在一起
四位以上作者：前三位作者姓氏的第一个字母连接在一起，结尾有一个“+”符号。
对于上面的示例，alpha样式的引用将是： [BDB79] ， [BB79A] 和 [BB79B] ，分别。
使用Sphinx Bibtex扩展¶
附加引用可以在 Sphinx 使用 sphinxcontrib-bibtex_ 延伸。
这个 sphinxcontrib-bibtex_ 扩展允许 BibTeX 引文应插入斯芬克斯生成的文件中。
扩展定义了一个新的 bibliography 指令和新的 cite 角色。
这些作用类似于 Latex thebibliography 环境和 \cite 命令。
引用存储在单独的纯文本bibtex格式文件中。目前，只有 unsrt 和 plain 支持BibTex样式。
请注意，当前 sphinxcontrib-bibtex_ 是一个 beta 版本。
安装延长件¶
模块安装有：
pip install sphinxcontrib-bibtex
这是小费。
对于Windows用户。为了便于安装第三方python包，请按照以下说明操作 `add Distribute and Pip to the Python installation`_ .
例子¶
在文档中，使用以下语法：
See :cite:`Strunk1979` for an introduction to stylish blah, blah...
并将指令放在文件末尾：
.. bibliography:: references.bib
这个 references.bib 文件应包含 BibTex 书目，包括以下条目：
@BOOK{Strunk1979,
title = {The Elements of Style},
publisher = {Macmillan},
year = {1979},
author = {Strunk, Jr., William and E. B. White},
edition = {Third}
}
使用Sphinx Natbib扩展
更灵活的选择是使用http://wnielson.bitback.org/projects/sphinx-natbib/
本文件可在本特定项目要求的情况下完成。
使用斯芬克斯论文资源
另请参阅http://jterrace.github.io/sphinxtr/html/ch-intro/index.html了解sphinx的各种有用的改编/扩展。
直接在狮身人面像中使用 Latex¶
对于高级用户， Latex 也可以直接用于斯芬克斯（仅需要 Latex 输出时）：：
See :raw-tex:`\cite{Strunk1979}` for an introduction to stylish blah, blah...
并在文件末尾插入参考书目：
.. raw:: latex
\bibliographystyle{plain}
\bibliography{listb.bib}