4. 图片与视频

添加图片的sphinx说明:http://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html 添加图片的rst官方说明:

4.1. 图片

图片原文件统一存储在引用文档所在的同级目录的 media 文件夹下。

显示图片直接使用image或figure指令,无特殊情况的话我们书籍图片要求使用居中方式显示, 还需要添加“alt”选项指定图片的描述(类似doc中的题注),以便图片加载失败时显示文字

不要使用bmp图片 ,bmp图片在生成pdf的时候会丢失,所以不要使用bmp格式的图片。

4.1.1. figure命令

语法:

.. figure: ../media/rest-syntax/pic-video/logo.png
   :alt: 野火logo
   :align: center
   :caption: 野火logo

效果:

野火logo

4.1.2. image命令:

语法:

.. image:: ../media/rest-syntax/pic-video/logo.png
   :align: center
   :alt: 野火logo

效果:

野火logo

以下的图片显示方式是word自动转换的结果,使用这种方式无法以居中形式显示图片,所以我们要修改。

它的原理是使用“||”类似宏的方式替换指令,使rst源码看起来更简洁,但不能居中显示。

语法:

|logo|,使用"|宏名|"的形式替换文字。

.. |logo| image:: ../media/rest-syntax/pic-video/logo.png

效果:

logo,使用”|”宏名”|”的形式替换文字。

图片还可以使用 width、heigh、scale等参数,但不推荐使用,设置过width、height参数的图片, 在页面可以点击查看原图。

语法:

.. image:: ../media/rest-syntax/pic-video/logo.png
   :align: center
   :width: 5.63529in
   :height: 0.97222in

效果:

../_images/logo.png

4.2. 视频

使用raw指令插入html代码。 直接粘贴视频网站的通用html代码,不过貌似不能放大。

在vscode可能无法预览,直接在浏览器中看即可。

注解

TODO:目前还不知道如何放大,以及点击后到具体的视频网站播放。

语法:

.. raw:: html

<iframe src="//player.bilibili.com/player.html?aid=70961112&cid=122951107&page=1" scrolling="no" border="0" frameborder="no" framespacing="0" allowfullscreen="true"> </iframe>

效果:

语法:

.. raw:: html

<iframe height=498 width=510 src='http://player.youku.com/embed/XMzk2MzQxNTQ3Ng==' frameborder=0 'allowfullscreen'></iframe>