Skip to main content
 首页 » 编程设计

python之reStructuredText 书目字段的正确使用

2025年05月04日8bhlsheji

使用 reStructuredText Bibliographic fields 的正确方法是什么?对于 python 文件?

请您参考如下方法:

关于如何使用此类字段的最突出示例是在 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 文档中所述,

This bibliographic data corresponds to the front matter of a book, such as the title page and copyright page.

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