Chèn liên kết tương đối trong reStructuredText

Question

Tôi đang ghi lại một thư viện có thành phần Python và thành phần JavaScript. Tài liệu người dùng tổng thể và tài liệu Python API nằm trong reStructuredText, được xử lý bằng Sphinx. API JavaScript nằm trong jsdoc và được xử lý bằng bộ công cụ jsdoc. Định dạng đầu ra chính sẽ là HTML. Tôi mới vào reST, Sphinx và jsdoc.

Tôi đã thiết lập một hệ thống xây dựng để tất cả các trang html được tạo ra được đổ vào một cây thư mục duy nhất. Bây giờ tôi cần chèn vào trang chính (được tạo từ reST) một liên kết đến tài liệu Javascript được tạo. Điều này cần phải là một liên kết tương đối, vì các tài liệu có thể được đặt ở những nơi khác nhau trên các cài đặt khác nhau. reST sẽ tự động phân tích một URL đầy đủ, nhưng tôi không thể tìm ra cách để nó chèn một liên kết tương đối. Các cấu trúc như :ref: và :doc: dường như không giúp ích gì, bởi vì chúng mong đợi mục tiêu sẽ trở lại.

Bất kỳ ý tưởng nào?

Answer 1

Đã tìm ra. Sau đây chèn tham chiếu tương đối vào tài liệu js/index.html:

`Javascript API <js/index.html>`_