如何在 reStructuredText/Sphinx 中创建浮动图形? [英] How to create floating figures in reStructuredText / Sphinx?

问题描述

我想要一个带有文字环绕的图形.

I want to have a figure with text wrapped around it.

这就是我要说的:

Installation of Optional Accessories
====================================

.. warning:: Never plug in or unplug a Hand Robot or a Grasp Sensor while the robot is turned on, as the system will not function properly and damage to the robot could occur.

Installing a Hand Robot
-----------------------

.. _`fig-attach-hand-robot`:
.. figure:: attach-hand-robot.*
  :scale: 40%
  :align: right

  Attach Hand Robot

Make sure the robot is turned off as described in the section :ref:`turn-off-robot`. 

Take the hand robot out of the grounded bin that sits on top of the electrical panel (if you have an adjustable height table) or sits on top of the rear table (if you have a fixed height table). Make sure not to touch the pins on the electrical wiring while doing so. Insert the conical protrusion of the hand robot into the conical receptacle (see :ref:`fig-attach-hand-robot`). Once the hand robot is supported by the InMotion Arm Robot, make sure the two knobs below the Hand Robot have engaged and sprung in. If they have not, twist them until they do as shown (see :ref:`fig-knobs-in`).

和 这个 PDF 输出的屏幕截图就是我得到的.

• 为什么图形标题居中，而不是在图像下方?
• 为什么正文(确保..."和接受...")不在图片的左侧，而不是在图片下方?我希望图形向右浮动并在其左侧显示文本.

推荐答案

所以，我对 reStructuredText 进行了一些研究，看起来你想要的实际上是不可能的.

So, I did some research into reStructuredText and it seems what you want is not actually possible.

图 和 image 指令从未提及在对象周围环绕文本的能力.

The documentation for the figure and the image directives never mention the ability to wrap text around the object.

这可能是提供给 Sphinx 开发人员的功能请求，尽管我怀疑他们会拒绝它，因为它没有在第一个规范中明确提及.

This might be a feature request to provide to the Sphinx developers although I suspect they'll reject it because it isn't explicitly mentioned in the rst specification.

我希望赏金能引起一些关注，但我怀疑没有.

I was hoping the bounty would garner this some attention but I suspect is hasn't.

这篇关于如何在 reStructuredText/Sphinx 中创建浮动图形?的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持IT屋！