引言
在演示了官方的例子後,是不是蠢蠢欲動,想大顯身手一番?彆着急,我們從建立自己的第一份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)
----
全部結束啦
===========