rust-beam

beam是一种您可以比beamer更快地编写的纯文本幻灯片格式。

这是beam非正式规范的Rust实现。

依赖项

构建

Rust稳定版。

运行时

一个带有beamer的LaTeX工作安装。

安装

运行 cargo install rust-beam 安装rust-beam的最新稳定版本。

运行 cargo install --git https://gitlab.com/chennisden/rust-beam.git 从源代码安装rust-beam。

规范

以下是beam文件格式的非正式规范。

幻灯片

• 幻灯片由一个~标记分隔。紧随其后的任何文本都是幻灯片的标题。如果您不想设置标题，则在~后不留文本。
• 一行中的前导和尾随空白将被忽略。

特殊字符

• #将开始一个新部分，标题将是同一行后跟的文本。

• ~将创建一个新幻灯片，标题将是同一行后跟的文本。

• -可以用来制作项目符号列表。底层调用LaTeX中的"itemize"环境。

• >开始一个块。第一行用作标题（留空则没有标题）。

• <开始一个示例块。同样，第一行用作标题。

• !开始一个警报块。同样，第一行用作标题。

• @可以用来创建一个包含特定图像的幻灯片。虽然可能，但建议不要向此类幻灯片添加文本。底层使用

   \setbeamertemplate{background}{
   	\includegraphics[width=\paperwidth,height=\paperheight]{IMAGEPATH}
   }
  

• * 可以用于在幻灯片中插入图片。在底层，它调用

   \begin{center}
   	\includegraphics[width=6cm]{IMAGEPATH}
   \end{center}
  

• ^ 将直接将文本原样输入到前言中。这允许你设置演示文稿的主题、标题和作者。如果一行以 ^ 开头，则将结束当前幻灯片，无一例外。

• 字符转义由 LaTeX 处理，而不是 beam。这意味着无法显示以原始 -、!、> 或 < 字符开头的行。这被视为一个设计缺陷，但是一个非常小的缺陷。

你也可以使用 % 作为注释，因为它在 LaTeX 中也是一个注释。但是要小心不要意外地开始一个新的幻灯片。

示例

所有示例都可以在 examples/ 中找到，假设你已经在这个目录下。

“example.beam” 包含一个示例。假设 rust-beam 已经在您的系统中，请运行

rust-beam example.beam

beam 将生成一个中间 TeX 文件，然后通过 latexmk 编译它。以下是对示例的再现。

^ \documentclass{beamer}[12pt]
^ \title{beam}
^ \author{Dennis Chen}

\titlepage

# Introduction

~ What is beam?
- beam is a file format to write presentations with
- beam is a program that converts beam files into beamer

~ Why?
beam does for beamer what Markdown does for HTML
- beamer takes far too long to write.
- We only need a subset of beamer's features

# Features

~ Frametitles
Use the ``~'' character to set the frametitle.

~ Bullet points
- You've already seen it in this presentation.
- Bullet points invoke the ``itemize'' environment.

~ Block
> How to make a block
> This symbol makes a block.

~ Exampleblock
< How to make an exampleblock
< This symbol makes an exampleblock.

~ Alertblock
! How to make an alertblock
! This symbol makes an alertblock.

~ Images
Use the ``\@'' character to set a background image.

~
@beach.jpg

~
You can also use the ``\*'' characater to include an image in the slide.
*beach.jpg

# Miscellaneous

~ Stylization
beam should be written in all lowercase, even at the start of a sentence.