警告：\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 顯示原文