本文档介绍了如何使用Python3的Hovercraft工具创建impressive.js演示文稿，从新建rst文本开始，逐步讲解各级标题、项目列表、超链接、图片、演讲者笔记、代码高亮等元素的添加，以及最终生成HTML文档的步骤。
引言
在演示了官方的例子后，是不是蠢蠢欲动，想大显身手一番？别着急，我们从建立自己的第一份hovercraft演示文稿，顺便学习学习reStructuredText.
新建rst文本
我是这样创建我的第一份hovercraft演示文稿的，如果有更好的办法，请告诉我一下。
首先，我创建一个myfisrt_test.txt文件，然后将后缀名改为.rst。
接着我们用notepad++打开myfisrt_test.rst,我们就在这上面写文档即可。
演示文稿说明
以下代码可以直接复制到你的myfisrt_test.rst中去.
:title: 我的第一份hovercraft
:author: Admin
:description: learn the hovercraft
:keywords: presentation, restructuredtext, impress.js,
:css: myfisrt_test.css
下面可以介绍下该演示文稿，上面的内容不会在演示中显示出来。第一张幻灯片
hovercraft演示文稿不像PPT一样称为幻灯片，一般用步骤(step）来表示，比如step1、step2等，为了熟悉期间，我们仍然称作幻灯片。
----
我的第一份hovercraft
=====================
我就喜欢每天学点新东西，新东西让我热血沸腾。
这里用'----'来区分不同幻灯片
用文字下面加'=='来表示标题，这个'=='长度至少要比标题文字长度长。各级标题
下面代码介绍rst中各级标题的用法。
----
为什么要学这个？
================
因为我希望以代码的方式来思考，让东西变得可控。
各级标题文字下面可以用'= - ` : ' " ~ ^ _ * + # < > .'进行区分，顺序无所谓
这是二级标题
----------------
三级标题又是如何的？
~~~~~~~~~~~~~~~~~~~~~项目列表、斜体以及加粗
----
其他一些格式
=============
所有的reStructuredText都可以在hovercraft中支持。
比如：
* 项目列表
* 二级
* 三级
*这是斜体* **这是加粗的**顺序列表以及超链接
超链接使用跟markdown有些不同，请注意区别。
----
更多的格式
===========
1. 顺序列表
2. 第三
3. 还可以加入超链接 `CSDN blog`_
.. _CSDN blog: http://write.blog.csdn.net/postlist添加图片
幻灯片中添加图片只要添加路径即可，不过第一次测试时发现绝对路径不好使，相对路径可以使用。
调节图片大小后，图片也不能正常显示，不知道为什么。
----
图片
===========
你也可以在hovercraft中加入图片
.. image:: images/python-logo-master-v3-TM.png
也可以设定图片大小
.. image:: images/python-logo-master-v3-TM.png
:width: 50px
:height: 130px
----添加演讲者笔记
官方文档里说这是个杀手级特性，hovercraft独有。
根据个人操作后的理解，这个演讲者笔记演示中不会显示，如果需要提示时，键盘按P键，就进入到控制台，此时可以见到演讲者笔记.
添加演讲者笔记
================
据说这是hovercraft的一个杀手级特性！该特性主要在控制台时显现。当你在展示的时候，键盘上按p键调出控制台，你就能看到一些自己添加的笔记，展示的时候是看不见的
，可以作为演讲时的提醒。
.. note::
偷偷提醒你一下哦
- Even bullet lists!
- Which can be handy!
加入源代码
----
源代码
================
要想加入代码，使用两个冒号 ，代码缩进就行了。
::
def test():
return 1+1
def test2():
pass代码高亮
----
代码高亮
========
需要在加入代码的基础上，加一点参数。
.. code:: python
def test():
return 1+1
def test2():
pass代码测试
水平有限，这一块没搞懂，望高人指点。
----
代码测试
=========
有点不太懂
.. code:: python
:class: hidden
from datetime import datetime
.. code:: python
>>> datetime(2013, 2, 19, 12)制作html文档
以上各块代码是分开的，下面还有一个合集，直接复制过去即可，如果存在缩进一些问题，可以下载我的百度网盘链接。
上述代码还没有涉及旋转、缩放这些令人心动的效果，这将在下一篇文章中谈及，可以先试试自己的第一个小作品哦。
打开cmd，输入代码
hovercraft 你的rst文档路径 你要输出的文件夹这样在你要输出的文件夹里就会产生一个index.html文件，直接就可以在浏览器里打开了
（作品演示时可能存在一些显示问题，很有可能是代码缩进的问题，任何rst语句后面都有一个空格，且每个语句前面顶格写，这样也许能避免一些问题）
所有代码集合
:title: 我的第一份hovercraft
:author: Python Wang
:description: learn the hovercraft
:keywords: presentation, restructuredtext, impress.js,
:css: abc.css
----
我的第一份hovercraft
=====================
哈哈，我就喜欢每天学点新东西，新东西让我热血沸腾。
----
为什么要学这个？
================
因为我希望以代码的方式来思考，让东西变得可控。
这是二级标题
----------------
三级标题又是如何的？
~~~~~~~~~~~~~~~~~~~~~
----
其他一些格式
=============
所有的reStructuredText都可以在hovercraft中支持。
比如：
* 项目列表
* 二级
* 三级
*这是斜体* **这是加粗的**
----
更多的格式
===========
1. 顺序列表
2. 第三
3. 还可以加入超链接 `CSDN blog`_
.. _CSDN blog: http://write.blog.csdn.net/postlist
----
图片
===========
你也可以在hovercraft中加入图片
.. image:: images/python-logo-master-v3-TM.png
也可以设定图片大小
.. image:: images/python-logo-master-v3-TM.png
----
添加演讲者笔记
================
据说这是hovercraft的一个杀手级特性！该特性主要在控制台时显现。当你在展示的时候，键盘上按p键调出控制台，你就能看到一些自己添加的笔记，展示的时候是看不见的
，可以作为演讲时的提醒。
.. note::
偷偷提醒你一下哦
- Even bullet lists!
- Which can be handy!
----
源代码
================
要想加入代码，使用两个冒号 ，代码缩进就行了。
::
def test():
return 1+1
def test2():
pass
----
代码高亮
========
需要在加入代码的基础上，加一点参数。
.. code:: python
def test():
return 1+1
def test2():
pass
----
代码测试
=========
有点不太懂
.. code:: python
:class: hidden
from datetime import datetime
.. code:: python
>>> datetime(2013, 2, 19, 12)
----
全部结束啦
===========
231
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
