Sphinxで処理される RST を記述しているときに、図を参照するときに Sphinx LaTeX 出力で図番号を使用することができません。たとえば、次のコード:
The lemmings are attacking, as can be seen in :ref:`figlem`.
.. _figlem:
.. figure:: _static/lemming_invasion.*
They're coming!
これに変換されます：
They're come!に見られるように、レミングが攻撃しています。
/ここに画像が入ります/
図 1.1: 彼らが来る!
しかし、私が欲しいのは、次のような図を参照する「標準的な」LaTeX の方法です。
図 1.1 に見られるように、レミングが攻撃しています。
どうすればこれを達成できますか? 私が現在使用しているコードは、Sphinx のマニュアルで推奨されているものですが、必要な出力が得られません。
Sphinx の最新バージョン (1.3+) では、数値の番号付けとテキストからの参照が少し簡単になりました。サポートが組み込まれているためです。
テキストでは、次のようなことができます。
.. _label:
.. figure:: images/figure.*
At :numref:`label` you can see...
最終結果は、「図 1.1 を見るとわかります...」のようなものになるはずです。この手法は、デフォルトの HTML 出力と LaTeX 出力の両方で機能します。
conf.pyファイルで、必ずフラグを設定してくださいnumfig = True。numfig_format参照のテキスト形式 (および)の構成オプションもありますnumfig_secnum_depth。
参考文献:
numfig拡張機能はまさにこれを行います。私はそれを試してみましたが、うまくいきました。
Figure の参照は reST ではまだ実装されていないと思いますが、これに近づくための回避策http://article.gmane.org/gmane.text.docutils.user/5623があります。