图片¶

说明:

There are two image directives: image and figure.
An image is a simple picture.
A figure consists of
    image data (including image options),
    an optional caption (a single paragraph),
    and an optional legend (arbitrary body elements).

    For page-based output media, figures might float to a different position if this helps the page layout.

image¶

备注

:scale:等配置在图片是http地址时不管用。这是因为当使用外部 URL 引入图片时，sphinx 通过解析本地图片获取大小信息，但对外部图片无法获取大小，所以无法正确应用 scale 设置。可以采用指定 width 和 height 的绝对值的方法来缩放

Example¶

.. image:: ../files/image/photo.jpg

Example¶

.. image:: ../files/image/photo.jpg
    :scale: 50 %

Example for image usage¶

.. image:: picture.jpg
   :width: 200px
   :height: 100px
   :scale: 50 %
   :alt: alternate text
   :align: right

其他示例¶

.. image:: https://travis-ci.org/rtfd/sphinx_rtd_theme.svg?branch=master
   :target: https://travis-ci.org/rtfd/sphinx_rtd_theme
   :alt: Build Status
.. image:: https://img.shields.io/pypi/l/sphinx_rtd_theme.svg
   :target: https://pypi.python.org/pypi/sphinx_rtd_theme/
   :alt: License
.. image:: https://readthedocs.org/projects/sphinx-rtd-theme/badge/?version=latest
  :target: http://sphinx-rtd-theme.readthedocs.io/en/latest/?badge=latest
  :alt: Documentation Status

figure¶

备注

A figure is an image with a caption and/or a legend:

Example¶

.. figure:: ../files/image/photo.jpg

Example¶

.. figure:: ../files/image/photo.jpg
    :scale: 50 %

Example for figure usage¶

 .. figure:: picture.png
    :scale: 50 %
    :alt: map to buried treasure

This is the caption of the figure (a simple paragraph).

This is the caption of the figure (a simple paragraph).

其他示例¶

.. figure:: image/photo.jpg
   :width: 20%, 12.0cm  % image宽度
   :figwidth:  % 图片宽度
   :scale: 50 %
   :alt: map to buried treasure
   :align : left, center, or right   % 指定「标题」位置

   『图片标题』



width说明:
  +---------------------------+
  |        figure             |
  |                           |
  |<------ figwidth --------->|
  |                           |
  |  +---------------------+  |
  |  |     image           |  |
  |  |                     |  |
  |  |<--- width --------->|  |
  |  +---------------------+  |
  |                           |
  |The figure's caption should|
  |wrap at this width.        |
  +---------------------------+

注释:
    .. -*- coding:utf-8 -*-