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

Question

我想用 reStructuredText 和rst2html5编写一个 2 列网站（html）。

我试过这样

.. container:: right

   Right text

.. container:: left

   Left text

并且效果很好（使用css“float”）。

但是，rst2html5无法编译 .rst，其中包含容器指令中带有消息(SEVERE/4) Unexpected section title or transition. .

.. container:: right

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

   Right text

.. container:: left

   Left text

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

我想像这样使用 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输出？

我读了这个线程，但无法获得 2 列 html。

任何意见将不胜感激。提前致谢。

score 3 · Accepted Answer

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

这是关于该问题的一个问题：使用 CSS 自动排列 2 列文本看起来 CSS3:columns 属性现在得到了相当广泛的支持。

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

1 回答 1