Skip to content

Latest commit

 

History

History
149 lines (101 loc) · 4.59 KB

rst2s5.rst

File metadata and controls

149 lines (101 loc) · 4.59 KB

文本方式写幻灯片

Authors: 机械唯物主义 <[email protected]>
Date: 2010-11-10

Contents

为什么要用S5?

作为乐于分享的开发人员, 总是免不了想向其他人介绍一些好玩的东西. 这个时候, 我们需要写幻灯片, 用展示自己要讲的东西. 其他人往往使用PPT, PPT是很好, 但是它是二进制专有格式的, 无法以文本方式编辑, 也无法进行版本管控, 离开了PPT程序也无法打开, 无法满足我们的需求. 那么我们应该用什么工具来做幻灯片呢? 在wikipedia上面有 slide工具列表 来介绍现有的幻灯片工具, 我选择的是 S5 .

那么S5有什么好处呢?

  • 纯文本
  • html

纯文本, 直观, 清爽, 方便编写以及后期的维护. 文件本身其实是html格式的, 利用其他javascript, css之类的设置弄成slide的效果. 本身方便分发以及发布, 再也不用超级大的PPT工具啦!

S5实例

S5其实就是一个html文件, 带有一堆的css, 脚本什么的, 可以让你以这种方式写:

::

<!-- 这是一张slide --> <div class="slide" id="id1">

<!-- 这是slide的标题 --> <h1>为什么要用S5?</h1> <!-- 这是slide的内容 --> <ul>

<li>纯文本</li> <li>html</li>

</ul>

</div>

上面就是一张slide的内容, 是不是很简单?

rst2s5实例

不过写html也太累了, 那么多尖括号也不直观, 最后我在 大妈 的指导下, 找到了rst2s5这个工具. 可以用rst的方式来写, 然后转为S5格式.

代码

为什么要用S5?
================================

* 纯文本
* html

试用一下

不多说, 在线rst2s5 : http://server.linjunhalida.com/tools/rst2s5/

本地生成

rst2s5是属于 docutils 的, 安装后可以在命令行执行

need docutils:

rst2s5 xxx.rst xxx.html
rst2s5 --theme small-white xxx.rst xxx.html
rst2s5 --theme-url http://xxx.com/ui/small-white xxx.rst xxx.html

如何写rst2s5?

网上有 rst2s5教程 , 但是没有示例, 我找了半天, 发现这个教程其实也是用rst写出来的, 源文件是 这个, 只要仿照这个文件去写就可以了. 或者你可以看我写的 文档. 不需要去学, 直接抄就好了.

至于rst格式, 你可以看: ReST快速入门, 来学习如何写.

写代码

rst2s5也可以写程序整合到自己的系统中. 比如 我的博客

代码:

from docutils.core import publish_string

overrides = {'theme': '',
             'theme_url': '/statics/S5/ui/small-white',}

def rst2S5(string):
    return publish_string(
        source=string,
        settings_overrides=overrides,
        writer_name='s5')

上面的代码, theme里面填的是本地有的theme, 如果要引用网站上面的theme, 需要把theme栏留空, 设置theme_url. 我花了好几个小时才发现只有这样才能激活theme_url的选项.

资源