11

Sphinxでドキュメントを作成するときにオンライン画像を参照する方法について何かアイデアはありますか？

これは動作しません：

.. image:: http://www.mysite.com/images/someimage.png

私に与える：

/home/user/proj/2010/11/08/the_forever_war.rst:11: WARNING: nonlocal image URI found: http://www.mysite.com/images/someimage.png

ありがとう...

4

3 に答える 3

20

docs/conf.pysphinx 1.4以降、次のようにファイルからスフィンクスに「モンキーパッチ」を適用できます。

import sphinx.environment
from docutils.utils import get_source_line

def _warn_node(self, msg, node, **kwargs):
    if not msg.startswith('nonlocal image URI found:'):
        self._warnfunc(msg, '%s:%s' % get_source_line(node), **kwargs)

sphinx.environment.BuildEnvironment.warn_node = _warn_node

この回答の以前のバージョンでは、最新のsphinx1.4リリース[1]と互換性のないパッチが提供されていました。さらに、sphinxの次のリリースでは、この構成オプションをサポートする必要があります[2]。

suppress_warnings = ['image.nonlocal_uri']

これにより、「非ローカルイメージURIが見つかりました」という警告が除外されます。

sphinx-build -Wテストとビルドのインフラストラクチャの一部として「エラーとしての警告」を発行し、ドキュメントに間違いがないことを確認したいので、これが必要であることがわかりました。非ローカルイメージURIを使用していることをよく知っています。それで大丈夫ですが、他の警告を無視したくありません。

[1] https://github.com/sphinx-doc/sphinx/issues/2429#issuecomment-210255983

[2] https://github.com/sphinx-doc/sphinx/issues/2466

于 2015-02-28T06:40:17.233 に答える
6

これには生のhtmlコードを使用します。例：

.. raw:: html

   <p style="height:22px">
     <a href="https://travis-ci.org/aio-libs/aiozmq" >
       <img src="https://travis-ci.org/aio-libs/aiozmq.svg?branch=master"/>
     </a>
   </p>
于 2014-03-27T18:41:32.880 に答える
4

それはかなり恥ずかしいです...

デルナンが彼のコメントで上で述べたように、私は警告を受け取っているだけです。

私の弁護では、imageディレクティブに落ち着く前に、非常に複雑なrawディレクティブを試していました。そして、レンダリングされたページではなく、Sphinxの出力を見ていました。Sphinxからの長い出力を見たとき、私は再び別のエラーが発生したと思いました。

それにもかかわらず、私は責任があります...画像は正常に読み込まれます。

于 2012-10-07T21:46:48.533 に答える