Sử dụng self in sphinx toctree không bao gồm các phần phụ

Question

Tôi muốn nhân vật toctree của mình bao gồm trang chính (index.rst). Các tài liệu cho rằng bao gồm cả 'self' sẽ làm điều này, nhưng như những người khác đã lưu ý trên stackoverflow, nó chỉ bao gồm tiêu đề của trang chính, để nếu độ sâu> 1 hành vi của trang chính khác với các trang được liên kết.

Tôi cũng đã xem các chỉ dẫn nội dung được đề xuất cho vấn đề này, đối với tôi, điều này chỉ tạo danh sách nội dung riêng biệt và không giúp ích với toctree. Tôi thực sự đang tìm kiếm một giải pháp tạo ra một hành vi nhất quán trong toctree. Có cái nào không?

Answer 1

Bao gồm chữ số self chỉ thêm tiêu đề của tài liệu hiện tại như bạn đã đề cập. Tuy nhiên, bao gồm cả tiêu đề của tài liệu hiện tại thực sự thêm nó vào cây. Ví dụ:

.. toctree:: 
    :maxdepth: 2 

    index 

sẽ tạo ra kết quả bạn muốn. Tôi không chắc chắn tại sao điều này không được liệt kê rõ ràng trong tài liệu ở đâu đó.