Chỉ định hình ảnh trực tuyến ở định dạng Nhân sư (định dạng lại)

Question

Bất kỳ ý tưởng nào về cách tôi có thể tham chiếu đến hình ảnh trực tuyến trong khi ghi lại bằng Nhân sư?

này không làm việc:

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

Cung cấp cho tôi:

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

Thanks ...

Answer 1

Đó là khá lúng túng ...

Như delnan nêu trên trong mình bình luận, tôi chỉ nhận được một cảnh báo.

Trong phòng mình, tôi đã thử một số chỉ thị thô khá phức tạp trước khi tôi định hướng trên hình ảnh, và tôi chỉ nhìn vào đầu ra của Sphinx thay vì trên các trang được hiển thị. Khi tôi nhìn thấy đầu ra dài từ Sphinx tôi cho rằng tôi lại gặp lỗi khác.

Tuy nhiên, tôi đổ lỗi ... Hình ảnh tải tốt.

Answer 2

tôi sử dụng mã html liệu cho điều này, ví dụ:

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

Tính đến Sphinx 1.4, bạn có thể "khỉ vá" nhân sư từ tập tin docs/conf.py bạn như vậy:

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 

Một phiên bản trước của câu trả lời này cung cấp một bản vá không tương thích với bản phát hành nhân sư mới nhất 1.4 [1]. Hơn nữa, phiên bản tiếp theo của nhân sư nên hỗ trợ tùy chọn cấu hình này [2]:

suppress_warnings = ['image.nonlocal_uri'] 

Điều này sẽ loại trừ mọi cảnh báo 'không tìm thấy ảnh URI'.

tôi thấy cần thiết này bởi vì tôi muốn sphinx-build -W để phát ra "cảnh báo là lỗi" như một phần của cơ sở hạ tầng xây dựng thử nghiệm & tôi, để đảm bảo rằng không có lỗi trong tài liệu - Tôi biết rất rõ rằng tôi đang sử dụng URI hình ảnh không phải của địa phương và tôi OK với điều đó, nhưng tôi không muốn bỏ qua các cảnh báo khác.

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

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