Bruce，演示工具，将reStructuredText放入您的投影仪
项目描述
Bruce，演示工具是为那些厌倦了与演示工具斗争的人准备的。演示文稿是用纯文本文件编写的。它允许文本、代码、图像、交互式Python会话和视频。它使用pyglet在OpenGL中渲染。
如果您是从低于3.0的版本升级，请务必删除任何以前的Bruce安装！
本发行版中的更改
处理来自pygments的错误
添加可选使用smartypants curlify（感谢Ned Batchelder）
修复Windows .pyw启动脚本
使布局解析更健壮
针对布局更改发出特定的警告 -> 样式表
向GUI启动器添加缺失的选项值
对齐表格，使标题行位于基线
窗口在所有初始化完成前保持不可见
Bruce，演示工具功能
按每节或过渡显示每页的reStructuredText内容
具有“子弹模式”，按每个项目符号显示每页
处理大多数reStructuredText，包括
用于强调、加粗和字面的内联标记
字面和行块
表格（目前尚不支持跨行或跨列）
块引用
定义、项目符号和编号列表（包括嵌套和可选逐步显示）
图像 - 内联和独立，包括缩放
页面标题（节标题）
对reStructuredText的扩展
嵌入式Python交互式解释器会话
代码块带语法高亮（需要可选的Pygments安装）
视频（嵌入方式与图片相同）可循环播放
动态修改样式表和布局（例如，每页多个字体）
页面间的过渡效果
插件以创建自定义内联元素
页面布局和装饰
内容滚动（超过一屏的内容）
合理的资源位置（图像、视频、声音与演示文件在同一目录下）
录制计时和截图
播放之前录制的演示或以恒定速度播放，可选循环播放
计时器和页面计数显示，用于练习
控制多显示器中打开的屏幕
以原生分辨率全屏运行
快速切换到/从全屏
如果安装了smartypants，则自动生成印刷字体符号
安装
Bruce需要Python 2.5或更高版本。从 <https://pythonlang.cn/> 获取。
请从 <http://code.google.com/p/bruce-tpt/downloads/list> 下载您操作系统的Bruce版本
Linux “bruce-<version>-linux.zip”（例如，“bruce-3.2-linux.zip”）
Windows “bruce-<version>-windows.zip”（例如，“bruce-3.2-windows.zip”）
OS X “bruce-<version>-osx.zip”（例如，“bruce-3.2-osx.zip”）
解压应用程序，然后双击创建的文件夹中的“bruce”程序。程序可能带有“.sh”或“.pyw”扩展名。Linux用户可以选择在终端中运行程序。
Bruce可使用smartypants模块的curlify功能自动生成印刷正确的引号（也称为“智能引号”）、连字符和省略号。从
如果应用程序无法运行且您在Linux上，可能需要安装可选的python tkinter包。这通常是通过调用类似
sudo apt-get install python-tk
如果您是 系统包维护者，请阅读源分发“bruce-<version>.tar.gz”中的 INSTALL.txt 或 Subversion存储库 <http://bruce-tpt.googlecode.com/svn/trunk>
如何使用Bruce，演示工具
在Windows上，您可以双击“run_bruce.py”文件。
在其他平台上运行
% bruce [presentation source.txt]
如果您尚未安装Bruce，则可以从源运行
% python run_bruce.py [presentation source.txt]
有一些命令行控制 - 使用 bruce -h 学习它们的作用。在没有命令行参数的情况下，Bruce将弹出一个简单的GUI。
控制
在运行演示时，以下控件是活动的
- 左右箭头；左右鼠标按钮；空格键（向前）
前后翻页。如果页面包含列表并且已启用list-expose，则每个列表项将依次显示，然后再显示下一页。
- page up，page down
前后翻5页。
- 鼠标滚轮
滚动大页内容。您还可以通过将鼠标左键拖动到屏幕上上下拖动内容。如果页面包含嵌入的Python解释器，则可以使用鼠标滚轮滚动其内容（当鼠标位于解释器上时）。单击并拖动始终滚动整个页面。
- control-F
在全屏和窗口模式之间切换
- control-S
将截图保存为“screenshot-<随机数字>.png”到当前目录。
- escape
退出演示
- home, end
转到第一页或最后一页
如何使用Bruce演示工具编写演示
Bruce演示是用reStructuredText格式的一些扩展编写的纯文本文件。请参阅示例文件夹中的*.rst文件以获取一些示例，最简单的是“simple.rst”，它在白色背景上显示居中的文本句子（使用“big-centered”样式）
.. load-style:: big-centered Text displayed centered on the default white background. ---- A new page, separated from the previous using the four dashes. Ut enim ad minim veniam. A Page Title ------------ Pages may optionally have titles which are displayed centered at the top by default.
等等。更多信息请参阅HOWTO（也可在Bruce网站上找到）以及可选的额外示例下载，请访问<http://pypi.python.org/pypi/bruce>。
自动播放
Bruce具有记录和播放演示文稿的功能。
命令行选项--record会让Bruce将每页的截图和计时信息写入指定的目录。例如，如果您运行
python run_bruce examples/test_images.rst --record=/tmp/test_images
然后您将发现，在完成演示文稿后，Bruce已经将/tmp/test_images填充了
/tmp/test_images/screenshot-0.png /tmp/test_images/screenshot-1.png /tmp/test_images/screenshot-2.png /tmp/test_images/screenshot-3.png /tmp/test_images/timing.txt
其中，timing.txt的内容是时间戳（以秒为单位）和在该时间显示的截图
1231803728.3 screenshot-0.png 1231803731.9 screenshot-1.png 1231803733.4 screenshot-2.png 1231803738.9 screenshot-3.png
自动播放演示文稿有几种选项
- 播放录制内容
您可以使用--playback命令行选项播放捕获的录制内容。提供由--record生成的timing.txt文件的路径。
timing.txt中的时间可以从0开始，--playback会忽略截图文件名（它愉快地接受只包含时间的文件），因此以下与上面的timing.txt在播放方面是等效的
0 2.9 5.4 10.9
- 恒定速度播放
如果您只想以恒定速度显示演示文稿中的每一页（就像幻灯片放映一样），则可以使用--playspeed命令行选项。这给出了每页之间暂停的秒数。
播放速度会考虑到页面切换 - 延迟从切换的开始处开始。
- 循环播放
如果您希望自动播放的演示文稿循环播放，请使用--loop命令行选项。
- 仅播放一次
如果您希望自动播放的演示文稿在播放一次后退出，请使用--autoquit命令行选项。
- 自动捕获每一页的截图
您可以将--record和--playspeed组合起来，自动翻页演示文稿并捕获每一页的截图。使用类似以下的内容：
python run_bruce.py examples/test_image.rst --record=/tmp/test_images \ --playspeed=.5请确保演示文稿的顶部有
.. style:: :transition.name: none
。建议在完成计时调整之前不要使用比.5更快的速度。
许可证
Bruce演示文稿工具的原始软件版权所有（c）2005-2009 Richard Jones <richard@mechanicalcat.net>。
它包含许多贡献部分。
有关完整的授权信息，请参阅LICENSE.txt。
