“\begin{environment}...\end{environment}”的自定义命令

Question

要使用 screenplay 包输入一些对话，我必须使用

\begin{dialogue}{Johnny} Some dialogue. \end{dialogue}
\begin{dialogue}{Jane} I see. \end{dialogue}

一段时间后它会变得有点乏味。是否可以指定一个自定义命令，以便我可以使用类似的命令

\dialogue{Johnny} Some dialogue.
\dialogue{Jane} I see.

？

Answer 1

试试这个：

\newcommand{\dialogueline}[2]{\begin{dialogue}{#1} #2 \end{dialogue}}

% Usage example:
\dialogueline{Johnny}{Some dialogue.}  
\dialogueline{Jane}{I see.}  

Answer 2

事实上，您可以准确地得到您想要的：

\newcommand{\dialogueline}{\begingroup\catcode`\^^M=12 \dialogueline@EOL}
{\catcode`\^^M=12\gdef\dialogueline@EOL#1#2^^M{\begin{dialogue}{#1}#2\end{dialogue}\endgroup}}

此代码需要是 \makeatletter-protected - 被 \makeatletter/\makeatother 包围（编辑：这意味着您将 \makeatletter 放在定义之前，将 \makeatother 放在定义之后），或者放在 .sty 文件中。请注意，名为 dialogue 的环境定义了名为 \dialogue 的命令，因此您需要一个不同的名称。不要更改格式！

它的工作方式是 \dialogueline 是一个不带参数的命令，而是扩展为多个序列。首先，一个组开放令牌，将后面的任何内容放入其自己的范围内。其次，\catcode`^^M=12 序列。 LaTeX 为每个字母分配一个 catcode ：一个数字，表明它是什么类型。例如，反斜杠是catcode 0，命令名称构造函数；字母为类别代码 11；非字母打印字符（例如 at 符号）的 catcode 12。此序列使换行符 ^^M 具有 catcode 12，因此我们可以与其交互。最后，我们写出命令 \dialogueline@EOL，它完成了繁重的工作。

接下来，我们定义\dialogueline@EOL。我们在换行符为 catcode 12 的组中执行此操作，就像展开 \dialogueline 时一样。请注意，这就是为什么您不能用换行符分隔第二行的原因 - 它会被解释为文本。接下来，我们定义 \dialogueline@EOL 来接受两个参数，以换行符结尾；它通过获取第一个参数（在大括号中传递）并将其作为参数传递给 dialogue 环境来扩展，并将第二个参数（第一个参数之后和行尾之前的所有内容）传递为环境的身体。最后，\dialogueline@EOL结束在\dialogueline中打开的组，这样对^^M的catcode的更改在任何地方都不可见别的。鉴于此，您可以编写

\dialogueline{Johnny} Some dialogue.
\dialogueline{Jane}   I see.

并且一切都应该正常。

Answer 3

如果您假设每个对话框占据一个段落（通常，它以双行段落分隔符开始和结束），那么还有另一种方法让 \dialogue 仅采用一个参数：

\newif\indialog \indialogfalse
\def\dialogue#1{\ifindialog \end{dialogue}#1\begin{dialog}\else 
                \everypar={\end{dialogue}\indialogfalse \everypar={}}#1\indialogtrue\begin{dialogue} 
                \fi}

该代码是友好的肮脏和非 Latexy 的 - 它设置 \everypar 而不关心其现有内容 - 并且 Latex 有更清晰的抽象来执行此操作，我已经忘记了，但原理应该很清楚。