ВНИМАНИЕ: коды USFM в параграфах \rem могут вызвать сбой

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. Коды USFM, встречающиеся после \rem и на той же строке, будут игнорироваться.
2. После этой первой строки \rem будет действовать так, как и раньше: игнорировать текст, но реагировать на любые встреченные коды USFM.
3. \toc1 и т. д. теперь распознаются как разрывы параграфов.

Переведено машиной с языка English Показать оригинал