reStructuredText/Sphinxで浮動図形を作成する方法は？

Question

私はそれを囲むテキストで図を持っていたいです。

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`). 

や図のキャプションではなく、画像の下で、中央にあるのはなぜthis screenshot of PDF output is what I'm getting.

• を：

  これは私が言っている何ですか？

• イメージの下にあるのではなく、イメージの左側に本文テキスト（「確認してください...」と「取ります...」）がないのはなぜですか？私は図を右に浮かせて、その左にテキストを置いて欲しい。

Answer 1

私はreStructuredTextについていくつかの調査を行いましたが、実際には望んでいないようです。

figureとimageディレクティブのドキュメントでは、オブジェクトの周囲にテキストを折り返すことはできません。

これは、最初の仕様で明示的に言及されていないため、Sphinx開発者に拒否すると思われますが、これは機能要求です。

私は、恩恵がこの注目を集めることを望んでいましたが、私はそうではないと考えています。

Answer 2

画像をテキストの一部として処理するには、実際にsubstitutionsを使用することがあります。ここで

参考にすることができドキュメンテーションからの抜粋：

The |biohazard| symbol must be used on containers used to 
dispose of medical waste. 

.. |biohazard| image:: biohazard.png 

誰がこの問題に遭遇した場合、私は、コードのこのビットは助けとなるかもしれない、これは

Answer 3

に役立ちます願っています。私は実際のスフィンクスコードをハックしたくないと判断して、_build/latex/pi3d_book.texに適用された非常に短いPythonスクリプトを作成して、前後に\hfillを持つ\includegraphicsをラップイメージに変換しました。画像をリストの中に入れたり、画像を拡大するなど、この作業を止めることはたくさんあります。私の最初のスフィンクス指令は次のようなものです

.. image:: perspective.png 
    :align: right 

明らかに、セットアップに合わせてファイル名とパスを変更する必要があります。私spinxプロジェクトから、私は1つの章の冒頭で大きな照らさ手紙を置く必要がある場合、これは非常に有用ではありませんwrapfix.py

import subprocess 

with open("_build/latex/pi3d_book.tex", "r") as f: 
    tx = f.read().splitlines() 

txnew = [] 
flg1 = True 
for line in tx: 
    if line == "" and flg1: 
    txnew += ["\\usepackage{wrapfig}",""] 
    flg1 = False # just do this once before first blank line 
    elif "includegraphics{" in line and "hfill" in line: 
    fname = line.split("{")[2].split("}")[0] 
    if line.startswith("{\\hfill"): # i.e. right justify 
     fl_type = "R" 
    else: 
     fl_type = "L" 
    txnew += ["\\begin{wrapfigure}{" + fl_type + "}{0.35\\textwidth}", 
       "\\includegraphics[width = 0.3\\textwidth]{" + fname + "}", 
       "\\end{wrapfigure}"] 
    else: 
    txnew += [line] 

txnew = "\n".join(txnew) 
with open("_build/latex/pi3d_book.tex", "w") as fo: 
    fo.write(txnew) 

subprocess.Popen(["pdflatex", "pi3d_book"], cwd="/home/jill/pi3d_book/_build/latex")