Sfenks - otomatik Trac biletleri başvurular ve changesets

Question

Sphinx mi oluşturmak, otomatik Trac içinde biletin/changesets karşılık gelen etmek #112 veya r1023 gibi Bağ metnine yol var? eg için

:

#112 -> http://mytracsite/tickets/112 
r1023 -> http://mytracsite/changeset/1023 

fazla örnek için TracLinks bakınız.

Answer 1

Eğer Sonra belgeler içinde :trac:`#123` ve :trac:`r1023` kullanabileceğiniz config.py

trac_url = 'http://mytratsite/' 

from docutils import nodes, utils 
from docutils.parsers.rst import roles 
import urllib 

def trac_role(role, rawtext, text, lineno, inliner, options={}, content=[]): 
    ref = trac_url + '/intertrac/' + urllib.quote(text, safe='') 
    node = nodes.reference(rawtext, utils.unescape(text), refuri=ref, **options) 
    return [node],[] 

roles.register_canonical_role('trac', trac_role) 

bu koyarsanız.

Bu, bir trac sitesine hızlı bağlantılar kurmanın en kolay yoludur. Bağlantılar için intertrac mekanizmasını kullandığı için her tür TracLinks için otomatik olarak çalışır.

Answer 2

Sphinx 1.0, extlinks uzantısını kullanarak external links ürününü desteklemektedir.

:issue:`123` 

ve http://mytracsite/123 dönüştürülür: sizin gibi bağlantılarınızı yazabilirsiniz yapılandırılabilir bir rol adı (örneğin 'konu') kullanma.