reStructuredText 书目字段正确使用答案

【问题标题】：reStructuredText Bibliographic fields proper usagereStructuredText 书目字段正确使用
【发布时间】：2013-03-05 02:03:03
【问题描述】：

将reStructuredText Bibliographic fields 用于python 文件的正确方法是什么？

【问题讨论】：

标签： python python-sphinx restructuredtext bibliography

【解决方案1】：

如何使用此类字段的最突出示例是在 Python PEP 中，例如PEP-0414:

PEP: 414
Title: Explicit Unicode Literal for Python 3.3
Version: $Revision$
Last-Modified: $Date$
Author: Armin Ronacher <armin.ronacher@active-4.com>,
        Nick Coghlan <ncoghlan@gmail.com>
Status: Final
Type: Standards Track
Content-Type: text/x-rst
Created: 15-Feb-2012
Post-History: 28-Feb-2012, 04-Mar-2012
Resolution: http://mail.python.org/pipermail/python-dev/2012-February/116995.html

虽然这是一个冗长的字段列表，但它显示了它们的使用方式。

如 reST 文档中所述，

此书目数据对应于一本书的封面，例如标题页和版权页。

所以每个文档应该只有一组这样的字段，即在开头。不要忘记，reST 是作为 Python 文档的轻量级标记开发的。

【讨论】：