Cách chính xác, nếu có, phân tách tài liệu nguồn trong Sphinx là gì?Tách tài liệu nguồn trong Sphinx (ví dụ: quản lý phân cấp tệp)
Tôi có một file lớn, chúng ta hãy gọi nó file1.rst
, cấu trúc của nó là như thế này:
Section 1
*********
Subsection 1
============
Subsection 2
============
Subsection 3
============
Mỗi tiểu mục là rất dài, và các tập tin nguồn đã trở thành không thể quản lý. Tôi muốn đặt mỗi tiểu mục trong một tệp nguồn khác nhau.
Tôi đã thử với chỉ thị include
:
Section 1
*********
.. include:: subsection1.rst
.. include:: subsection2.rst
.. include:: subsection3.rst
Nhưng nó đưa ra cảnh báo rằng nhãn trong subsection1.rst được nhân đôi trong section1.rst (không đúng sự thật, nhãn là duy nhất trong tiểu tài liệu).
Ngoài ra, có khả năng thay đổi thứ bậc trong chỉ thị TOC không?