python - 是否可以在 reStructuredText 中将部分放在容器内？

Question

我想用 reStructuredText 和 rst2html5 编写一个 2 栏网站 (html) .

我试过这样

.. container:: right

   Right text

.. container:: left

   Left text

并且效果很好(使用 css“float”)。

然而，rst2html5无法编译带有消息 (SEVERE/4) Unexpected section title or transition. 的容器指令中的节的 .rst。

.. container:: right

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

   Right text

.. container:: left

   Left text

我猜/认为 rst2html5 行为对于第一个规范是完全有效的。

我想像这样使用 rst2html5 从 .rst 获取 .html。

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

是否允许在容器内包含部分或类似内容？(我认为这是不允许的，对吧？)或者如何从 .rst(使用 rst2html5)获得与上面类似的 html 输出？

我读了this线程，但无法获取 2 列 html。

如有任何意见，我们将不胜感激。提前致谢。

Answer 1

我认为尝试让 ReST 处理两列是错误的方法。 ReST 不关心布局，也不应该关心布局。这应该由站点设计和类来完成。

这是一个关于这个问题的问题:flow 2 columns of text automatically with CSS看起来 CSS3: columns 属性现在得到了相当广泛的支持。

您是对的，Docutils 不会在容器中分割标题。容器是一种主体元素，只允许在内部部分使用。 http://docutils.sourceforge.net/docs/ref/doctree.html