phân nhóm reStructuredText không tôn trọng

Question

Dưới đây là một đoạn còn lại đơn giản:

deleting this line causes all subheadings to be rendered as h1 tags 

I should be an h1 
================= 

I should be an h2 
----------------- 
foo    

I should also be an h2 
---------------------- 
foo 

và đây là một cuộc biểu tình của nó được hiển thị:

với dòng đầu tiên: http://rst.ninjs.org/?n=ff67380d732a33c7844f350c240804d0
mà không cần dòng đầu tiên: http://rst.ninjs.org/?n=550ea2c1b4233affdce1d158c5dc4d99

tôi 're rendering reST bằng cách sử dụng Python sau đây:

from docutils.core import publish_parts 
parts = publish_parts(rest_content, writer_name="html") 
html_snippet = parts['html_body'] 

Làm cách nào để nhận các tiêu đề phụ (cụ thể là <h2> thẻ) mà không có dòng đầu tiên? Có cung cấp hai mức phân cấp cao hơn các tiêu đề phụ không? Naively cung cấp tiêu đề trang không giúp được: http://rst.ninjs.org/?n=e874f6eaad17c8ae7fd565f9ecb2212b

Answer 1

Không quảng bá tiêu đề thứ nhất cho tiêu đề tài liệu.

Lưu ý settings_overrides param truyền cho publish_parts() trong ví dụ dưới đây:

rest_content = """ 
I should be an h1 
================= 

I should be an h2 
----------------- 
foo 


I should also be an h2 
---------------------- 
foo 
""" 

from docutils.core import publish_parts 
parts = publish_parts(rest_content, writer_name="html", 
     settings_overrides={'doctitle_xform':False}) 
html_snippet = parts['html_body'] 

print(html_snippet) 

Và kết quả:

<div class="document"> 
<div class="section" id="i-should-be-an-h1"> 
<h1>I should be an h1</h1> 
<div class="section" id="i-should-be-an-h2"> 
<h2>I should be an h2</h2> 
<p>foo</p> 
</div> 
<div class="section" id="i-should-also-be-an-h2"> 
<h2>I should also be an h2</h2> 
<p>foo</p> 
</div> 
</div> 
</div> 

Answer 2

ReST không quan tâm bạn sử dụng biểu tượng nào cho mỗi cấp, "=" chỉ là một quy ước. Vì vậy, nếu bạn loại bỏ cái đầu tiên thì nó sẽ thấy "-" như biểu thị một h1. Tôi không nghĩ rằng có một cách xung quanh điều này không may.

Answer 3

Chỉ cần có cùng một vấn đề. Các giải pháp được chấp nhận đã không làm việc cho tôi. Tuy nhiên, mã sau đây đã làm:

content = publish_parts(
    rest_content, 
    writer_name='html', 
    settings_overrides={'initial_header_level': 2}) 
html = content['html_body']