斯芬克斯文献引文管理¶
介绍¶
重构文本 引文 不适合插入式参考(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}