reStructuredText書目字段正確使用

Question

將reStructuredText Bibliographic fields用於python文件的正確方法是什麼？

Answer 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是作爲Python文檔的輕量級標記開發的。