Nhân sư - tạo tham chiếu tự động tới vé Trac và các thay đổi

Question

Là Sphinx, có cách nào để tự động liên kết văn bản như #112 hoặc r1023 với vé/thay đổi tương ứng trong Trac?

Đối với ví dụ:

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

Xem TracLinks để biết thêm ví dụ.

Answer 1

Nếu bạn đặt này trong 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) 

của bạn Sau đó, bạn có thể sử dụng :trac:`#123` và :trac:`r1023` trong tài liệu của bạn.

Đây có lẽ là cách dễ nhất để tạo liên kết nhanh đến một trang web theo dõi. Nó tự động làm việc cho tất cả các loại TracLinks vì nó sử dụng cơ chế intertrac cho các liên kết.

Answer 2

Nhân sư 1.0 giờ hỗ trợ external links bằng cách sử dụng phần mở rộng extlinks. Sử dụng tên vai trò có thể định cấu hình (ví dụ: 'vấn đề'), bạn có thể viết các liên kết của mình như:

:issue:`123` 

và nó sẽ được chuyển thành http://mytracsite/123.