स्फिंक्स (पुनर्गठित टेक्स्ट) प्रारूप में एक ऑनलाइन छवि निर्दिष्ट करना

Question

स्फिंक्स के साथ दस्तावेज़ करते समय मैं किसी ऑनलाइन छवि को कैसे देख सकता हूं?

यह काम नहीं करता:

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

धन्यवाद ...

Answer 1

यह काफी शर्मनाक है ...

delnan के रूप में ऊपर उल्लेख किया है उसकी टिप्पणी, मुझे केवल चेतावनी मिल रही है।

मेरी रक्षा में, मैं छवि निर्देश पर बसने से पहले कुछ जटिल कच्चे निर्देशों की कोशिश कर रहा था, और मैं केवल प्रस्तुत पृष्ठों पर स्फिंक्स के आउटपुट को देख रहा था। जब मैंने स्फिंक्स से लंबे आउटपुट को देखा तो मुझे लगता है कि मैंने फिर से एक और त्रुटि मारा।

फिर भी, मुझे दोष है ... छवि ठीक है।

Answer 2

मैं इस के लिए कच्चे एचटीएमएल कोड का उपयोग, जैसे:

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

Answer 3

स्फिंक्स 1.4, आप "बंदर पैच" स्फिंक्स कर सकते हैं के रूप में अपने docs/conf.py फ़ाइल से तो जैसे:

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 

एक पहले का वर्शन इस उत्तर के एक पैच प्रदान किया गया जो नवीनतम स्फिंक्स 1.4 रिलीज [1] के साथ असंगत है।

suppress_warnings = ['image.nonlocal_uri'] 

यह 'nonlocal छवि यूआरआई मिला' कोई चेतावनी को बाहर निकाल देगा: इसके अलावा, स्फिंक्स की अगली फिल्म इस विन्यास विकल्प [2] का समर्थन करना चाहिए।

मैं यह आवश्यक पाया क्योंकि मैं sphinx-build -W को फेंकना "त्रुटियों के रूप में चेतावनी" अपने परीक्षण & निर्माण के बुनियादी ढांचे, के हिस्से के रूप सुनिश्चित करना है कि वहाँ दस्तावेज में कोई गलती कर रहे हैं चाहते हैं - मैं जानता हूँ कि बहुत अच्छी तरह से मुझे लगता है कि मैं nonlocal छवि यूआरआई का उपयोग कर रहा हूँ और मैं के साथ ठीक हूँ, लेकिन मैं अन्य चेतावनियों को अनदेखा नहीं करना चाहता।

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

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