警告：\rem 段落中的 USFM 代码可能导致崩溃

Question

我刚刚追踪到某人项目中崩溃的原因，是一行代码。不幸的是，有人在编写 FRT 书籍模板时犯了一个错误，导致这行代码被包含在内：

\rem sorta will sort by \toc1, sortb by \toc2, sortc by \toc3

这几乎肯定会导致崩溃或未定义行为。

如果您的前言（Front matter）中包含该行，请将其修改为：
\rem sorta will sort by toc1, sortb by toc2 , sortc by toc3
即去掉斜杠。否则您将会遇到崩溃问题。

早期版本的 USFM 标准有些模糊，但 Paratext 和 USFM-3 标准并未将 \rem 描述为“忽略本行剩余部分”，而是将其描述为一种不产生输出的段落样式。
这意味着：

1. \rem 一直持续到下一个段落标记
2. \rem 仍然必须处理其中包含的任何标记。（否则它如何发现下一个段落标记？）
3. 由于 \toc1 等也被描述为段落标记（尽管未作为此类使用），它们应该会取消 \rem

机器翻译自 English 显示原文

Answer 1

更正……上述第 3 点可能是不正确的。标准规定“所有段落标记前都应有一个换行符。”因此，我认为代码在上述情况下完全忽略 \toc1 等是合理的。
我刚刚提交了一个小改动（我想大概一周左右可用），它遵循以下逻辑：

1. 出现在 \rem 之后且在同一行上的 USFM 代码将被忽略。
2. 在第一行之后，\rem 将继续像以前一样工作：忽略文本，但处理遇到的任何 USFM 代码。
3. \toc1 等现在被识别为段落分隔符。

机器翻译自 English 显示原文