.. index:: image

.. _basic-image:

画像を貼る
------------------------------

``image`` を使います。ファイル名は相対パスで記述できます。

また、オプションを付けることで大きさなどを調整できます。

scale
    画像の縮尺
width
    横幅
height
    縦幅
align
    配置指定
    "top", "middle", "bottom", "left", "center", "right"が使える
alt
    altテキスト

::

  .. image:: ../img/sphinx.png
     :scale: 40%
     :height: 100px
     :width: 200px
     :align: left

~~~~~~
適用例
~~~~~~

.. image:: ../img/sphinx.png
   :scale: 40%

``image`` は ``table`` などと組み合わせることもできます。


::

  .. list-table:: ロゴの比較
     :widths: 15 10
     :header-rows: 1
  
     * - 画像
       - 解説
     * - .. image:: ../img/sphinx.png
            :scale: 40%
       - Sphinx
     * - .. image:: ../img/python.png
            :scale: 40%
       - Python
  
.. list-table:: ロゴの比較
   :widths: 15 10
   :header-rows: 1

   * - 画像
     - 解説
   * - .. image:: ../img/sphinx.png
          :scale: 40%
     - Sphinx
   * - .. image:: ../img/python.png
          :scale: 40%
     - Python


参考
~~~~~~

- :ref:`images-replace-table`