【问题标题】:clearfix paragraph in restructured text重组文本中的 clearfix 段落
【发布时间】:2014-05-06 14:57:11
【问题描述】:

我有一个 reStructuredText 文档,我有一组图像和解释它们的段落。我希望图像左对齐,文本围绕它们流动。如果我在 html 中执行此操作,我只需在 <img><p></p> 对之间插入 <div class="clearfix"></div>。在重组文本中,我得到了如下所示的内容:

.. image:: path/to/image.png
   :width: 200px
   :align: left

very interesting paragraph about path/to/image.png

.. image:: path/to/another/image.png
   :width: 200px
   :align: left

probably the most interesting paragraph ever about path/to/another/image.png

结果看起来像这个屏幕截图,因为它之间没有 clearfix 类:

如何在 reStructuredText 中解决此问题?有没有更好的办法?

【问题讨论】:

    标签: python-sphinx restructuredtext


    【解决方案1】:

    您所拥有的应该可以使用默认的 sphinx html 构建。换行将根据文本大小和图像大小进行。

    .. image:: path/to/image.png
       :width: 200px
       :align: left
    
    very interesting paragraph about path/to/image.png
    

    将产生以下结果,一个宽度为 200px,另一个宽度为 400px。文本换行取决于大小。

    还有其他选项可用。如果文本占用的垂直空间比图像少,并且您希望包含“clearfix”类,则可以使用raw directive 插入自定义html。

    .. raw:: html
    
       <div class="clearfix">
    
    .. image:: path/to/image.png
       :width: 200px
       :align: left
    
    very interesting paragraph about path/to/image.png
    
    .. raw:: html
    
       </div>
    

    【讨论】:

    • 感谢您对 image 指令的关注。这只是 SO 上的一个错误。我相应地更新了我的问题以避免混淆。这样做的挑战是段落文本占用的垂直空间比图像少。任何想法如何在这种情况下解决它?
    • 增加图像大小.. 或者,您可以尝试其他sphinx themes 之一。使用自定义 css 扩展默认 sphinx template。或者你可以使用.. raw:: html,指令和输入你习惯的html直接进入代码。
    • 原始指令正是我想要的;谢谢!我建议对您的答案进行编辑以纳入该内容。
    • 我也没有;谢谢你把答案放在那里。这才是最重要的!
    猜你喜欢
    • 1970-01-01
    • 1970-01-01
    • 1970-01-01
    • 1970-01-01
    • 2020-07-16
    • 1970-01-01
    • 2013-06-29
    • 1970-01-01
    • 1970-01-01
    相关资源
    最近更新 更多