Làm thế nào để tạo một danh sách lồng nhau trong reStructuredText?

90

Tôi đang cố gắng tạo một danh sách lồng nhau đúng cách bằng mã sau (sau các tài liệu về Sphinx và docutils ):

1. X

  a. U
  b. V
  c. W

2. Y
3. Z

Tôi mong đợi điều này sẽ dẫn đến kết quả trong hai OLgiây nhưng thay vào đó tôi nhận được kết quả sau:

<ol class="arabic simple"> 
  <li>X</li> 
</ol> 

<blockquote> 
  <div>
    <ol class="loweralpha simple"> 
      <li>U</li> 
      <li>V</li> 
      <li>W</li> 
    </ol> 
  </div>
</blockquote> 

<ol class="arabic simple" start="2"> 
  <li>Y</li> 
  <li>Z</li> 
</ol>

Tôi đang làm gì sai? Không có được kết quả nào sau đây?

<ol class="arabic simple"> 
  <li>X
    <ol class="loweralpha simple"> 
      <li>U</li> 
      <li>V</li> 
      <li>W</li> 
    </ol> 
  </li>
  <li>Y</li> 
  <li>Z</li> 
</ol>

markup restructuredtext python-sphinx

— muhuk
nguồn

107

Đảm bảo danh sách lồng nhau được thụt vào cùng cấp với văn bản của danh sách mẹ (hoặc ba ký tự, tùy theo ký tự nào lớn hơn), như sau:

1. X

   a. U
   b. V
   c. W

2. Y
3. Z

Sau đó, bạn sẽ nhận được kết quả như mong đợi.

— ddbeck
nguồn

4

Có vẻ như điều này không chính xác. Trong trường hợp của tôi, tôi đang sử dụng *làm chỉ báo danh sách và khi tôi thụt lề dòng tiếp theo của mình hai ký tự cần thiết để xếp hàng với văn bản của danh sách mẹ, danh sách của tôi được coi là một danh sách riêng biệt bên trong một blockquote. Quy tắc kinh nghiệm mà tôi đã tìm thấy là danh sách bên trong phải được thụt lề ít nhất ba ký tự .

— Akrikos

@Akrikos Cảm ơn! Tôi đã cập nhật câu trả lời để bao gồm cảnh báo đó.

— ddbeck

36

Nếu bạn muốn Sphinx lo việc đánh số cho bạn, hãy làm điều này.

#. X
#. Y

   #. u 
   #. v 

#. Z

— zsoobhan
nguồn

6

Chỉ cần đánh dấu lại chi tiết này vì nó vẫn được áp dụng: u và v phải được thụt vào ít nhất 3 dấu cách (không phải 2 dấu cách), để khớp với văn bản của cấp chính. Nếu không, bạn sẽ nhận được "1. Z" thay vì "3. Z".

— S. Kirby

2

@ S.Kirby Có vẻ như người ta phải thụt lề nhiều hơn, nếu người ta sử dụng một mục danh sách như iii., sử dụng nhiều vị trí hơn. Có vẻ như văn bản phải được căn chỉnh và dường như không có số lượng dấu cách cụ thể mà người ta có thể sử dụng cho mọi trường hợp.

— Zelphir Kaltstahl

3

Xin lưu ý rằng các dòng trống thừa cũng rất quan trọng ở đây. Vì vậy, bạn sẽ cần 3 khoảng trắng cho mỗi phần tử của danh sách con lồng nhau, bên trên và bên dưới một dòng trống.

— flazzarini