rst2beamer3k 0.9.1

简介

A docutils脚本，将reStructuredText转换为Beamer风格的LaTeX。

Beamer是一个用于演示的LaTeX文档类。rst2beamer提供了一个docutils编写器，将reStructuredText转换为Beamer风格的LaTeX，并提供了一个相同的命令行脚本。通过此脚本，可以使用reStructuredText制作幻灯片和演示。

这是一个非官方分支（基于 https://pypi.python.org/pypi/rst2beamer），可在Python 2和3上运行。

安装

使用 pip

$ pip install --upgrade rst2beamer3k

$ sudo port install texlive-latex -x11 texlive-fonts-recommended -x11

用法

rst2beamer应解释reStructuredText的一个合理子集并生成合理的LaTeX。并非Beamer的所有功能都已实现，仅实现了（大）一个子集，允许快速生成外观良好的幻灯片。这些包括

• 覆盖列表（即逐点出现的列表项）。

• Beamer主题。

• 自动居中和调整图形大小。

• 嵌入注释和输出注释幻灯片。

• 将幻灯片内容排列成列。

一些示例可以在发行版的 docs/examples 目录中找到。实际上，可以使用 pdflatex 与 rst2beamer 结合来获取演示文稿的 PDF 版本。

rst2beamer 被称为

$ rst2beamer [options] [<source> [<destination>]]

例如

$ rst2beamer infile.txt outfile.tex

infile.txt 包含了 reStructuredText，而 outfile.tex 包含生成的 Beamer LaTeX。

它支持常见的 docutils 和 LaTeX 写作者 (rst2latex) 选项，除了 documentclass 选项（该选项被固定为 beamer）和 hyperref 选项（这些选项已在 Beamer 中设置）。它还支持

--theme=THEME           Specify Beamer theme.
--overlaybullets=OVERLAYBULLETS
                        Overlay bulleted items. Put [<+-| alert@+>] at the
                        end of \begin{itemize} so that Beamer creats an
                        overlay for each bulleted item and the presentation
                        reveals one bullet at a time
--centerfigs=CENTERFIGS
                        Center figures.  All includegraphics statements will
                        be put inside center environments.
--documentoptions=DOCUMENTOPTIONS
                        Specify document options. Multiple options can be
                        given, separated by commas.  Default is
                        "10pt,a4paper".
--shownotes=SHOWNOTES   Print embedded notes along with the slides. Possible
                        arguments include 'false' (don't show), 'only' (show
                        only notes), 'left', 'right', 'top', 'bottom' (show
                        in relation to the annotated slide).

限制

早期版本的 rst2beamer 由于 LaTeX 写作者的更改而无法与 docutils 0.4 一起使用。虽然这个问题已经被修复，但大部分工作都是使用从版本 0.5 及以上的 docutils 快照完成的。因此，建议用户更新 docutils。

最近，docutils 0.6 中的 LaTeX 写作者的更改再次破坏了 rst2beamer。我们认为所有这些错误都已被发现。

并非所有 Beamer 的功能都受到支持，有些与页面布局或演示相关的功能可能永远不支持。引入复杂的语法来达到复杂和特定的页面效果违背了 reStructuredText 简单易写的格式的宗旨。如果您需要复杂的演示，请使用 PowerPoint 或 Keynote。

如果单个幻灯片的内容过大，它将简单地溢出幻灯片的边缘并消失。可以说，这是您应该在每张幻灯片上放更少内容的信号。

致谢

rst2beamer 由 Ryan Krauss 和 Paul-Michael Agapow 开发。感谢那些报告并帮助我们追踪错误的人：Perttu Laurinen、Mike Pennington、James Haggerty 和 Dale Hathaway。

历史