2012-02-22 8 views
5

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?

Trả lời

6

Tôi trả lời câu hỏi của riêng mình (xấu hổ!) Vì cuối cùng tôi đã hiểu những gì tôi đã nhận được sai.

TOC, chỉ mục mục lục có thể được sử dụng nhiều lần. Điều này sẽ dẫn đến cấu trúc phân cấp mà tôi đang tìm kiếm.

Tôi hy vọng điều này có thể giúp ích cho những người, như tôi, nghĩ rằng chỉ có thể có một TOC.