Czy można wstawiać sekcje do kontenera w reStructuredText?

Question

Chciałbym napisać 2-kolumnę witryny (html) z reStructuredText i rst2html5.

Próbowałem jak ten

.. container:: right 

    Right text 

.. container:: left 

    Left text 

i działa dobrze (z css "pływaka").

Jednak nie może skompilować pliku .rst z sekcją w dyrektywie kontenerowej z komunikatem (SEVERE/4) Nieoczekiwany tytuł sekcji lub przejście..

.. container:: right 

    ======== 
    Section1 
    ======== 

    Right text 

.. container:: left 

    Left text 

Domyślam się, że zachowanie rst2html5 jest całkowicie poprawne dla pierwszej specyfikacji.

Chciałbym uzyskać .html z .rst z rst2html5 w ten sposób.

<div class="right"> 
    <h1>Section1</h1> 
    <p>Right text</p> 
</div> 
<div class="left"> 
    <p>Left text</p> 
</div> 

Czy wolno umieszczać sekcje wewnątrz pojemnika lub coś w tym stylu? (Myślę, że to nie jest dozwolone, prawda?) lub Jak mogę uzyskać podobne wyjście HTML do powyższego z .rst (z rst2html5)?

Przeczytałem wątek this, ale nie udało mi się uzyskać 2-kolumnowego html.

Wszelkie uwagi będą mile widziane. Z góry dziękuję.

Answer 1

Myślę, że próba uczynienia ReST obsługą dwóch kolumn jest niewłaściwy. ReST nie dba o layout i nie powinien przejmować się układem. To powinno być zrobione przez projekt strony i klasy.

Oto pytanie na ten temat: flow 2 columns of text automatically with CSS Wygląda na to, że właściwość CSS3: columns jest obecnie dość szeroko obsługiwana.

I masz rację, Docutils nie ma nagłówków sekcji w kontenerach. Kontenery są rodzajem elementów karoserii i dozwolone są tylko wewnątrz sekcji. http://docutils.sourceforge.net/docs/ref/doctree.html