我是项目管理员，但无法将 \+xt 标记为有效

Question

我想在将 \xt 标记更改为 +xt 之后，打印利未记某一章的测试副本（草稿，转为 PDF），但打印任务因标记无效而被拒绝，不过我还是强行打印了。当我查看标记清单时，发现新列出的标记，但无法勾选确认它们是否有效。

机器翻译自 English 显示原文

Answer 1

请使用 Help > Report a problem（帮助 > 报告问题）向我们报告此问题。这将包含一些日志文件，可能有助于诊断问题。

机器翻译自 English 显示原文

Comments

我会针对此问题发送另一份错误报告供您对比。在我担任管理员的项目中，我在 PT8 和 PT9 中都看到了相同的行为。

机器翻译自 English 显示原文

---

哎呀，抱歉，我想我在另一个帮助主题（Introduction to inventories for checking，检查清单简介）中找到了答案。看起来标记的有效性是在样式表中设置的，而不是在清单工具中设置的。

机器翻译自 English 显示原文

---

BruceBeatham，

您报告了无法验证标记的问题。Paratext 一直就是这样工作的。标记清单不允许进行验证——它只是提供项目中使用的标记列表。

详细解释
验证是由样式表（usfm.sty 以及可能的 custom.sty）处理的。当您在 Paratext 中查看时，可能会出现某些标记（如 \v14）显示为“粗体红色”的情况，以指示它不是有效标记（因为它未出现在样式表中）。您还可能看到像 \xt 这样的标记显示为“红色下划线”，以指示虽然 \xt 是样式表中的有效标记，但它通常不会出现在您放置它的位置。因此，对于 \xt，您可以在文本中的许多位置使用它来表示引用应被验证，但如果您将 \xt 放在 \io 字段中，它将失败，因为样式表不允许在该位置使用 \xt（有一种用于这些情况的标记 \ior）。

还有字符样式在另一个字符样式内部“嵌套”的情况。Paratext 通过要求使用 + 符号来处理这种情况。例如，如果在耶稣话语的文本部分中，我需要添加神的名字，我会得到类似这样的内容：
\wj .....\+nd God\+nd* ....\wj*

请注意，随着我们进入 Paratext 9，usfm 3.0 正在引入一些新功能。您可以在网上查看 usfm 3 文档：https://ubsicap.github.io/usfm/

机器翻译自 English 显示原文

---

BruceBeatham:

看起来标记的有效性是在样式表中设置的，而不是在清单工具中设置的。

是的，抱歉。我忘了标记清单只是一个标记列表，不允许用户选择其是否有效。抱歉误导了你们两位。

机器翻译自 English 显示原文

---

再次您好，

我回到这个帖子询问处理这些以及其他在 basic checks（基本检查）中出现的标记相关错误的最佳实践。由于它们的有效性是在 .sty 文件中定义的，这让我认为需要在该处进行配置以解决错误，但如果其他地方有我应该更改的内容，我不想乱动内部机制。

我有一段时间一直在忽略/拒绝标记错误，但现在我正在准备一本书提交给 DBL，这些错误似乎应该更妥善地解决。我有三种无法解决的通用标记错误：

• \xt 不允许在引言段落（\ip）中；
• \ior 不允许在引言大纲段落（\io#）中；以及
• 嵌入式标记被报告为“未知”（例如，在带有 \+w 标记的耶稣话语中嵌入的词汇表链接）。

项目属性（Project Properties）高级选项卡中的样式表信息显示它使用的是 usfm.sty 样式表，并注明是“已自定义”（Customized）。我将 USFM 版本更改为 3，但 Basic Checks 的结果没有变化。当我查看“C:\My Paratext 9 Projects”文件夹中的 usfm.sty 时，它显示“Version=3.0.2”。由于项目属性报告它使用的是“已自定义”样式表，我也查看了项目文件夹中的 custom.sty 文件。该文件顶部的注释说它“是在升级到 Paratext 8.0 时创建的。它基于项目最初使用的样式文件。这些文件已被删除，但文件的备份已保存到 usfm-color.sty.bak 和 custom.sty.bak” 我在当前项目文件夹中没有看到这两个 .bak 文件，但我假设它们一定在 Paratext 8 文件夹中。

我暂时重命名了项目文件夹中的 custom.sty（即重启 Paratext 后，高级选项卡不再报告“已自定义”样式表）。我不再拥有我们习惯的自定义颜色样式，但当我在该设置下运行 basic checks 时，\xt 和 \ior 的错误已解决。不过，+w 标记仍被报告为“未知标记”。

因此，我查看了当前项目文件夹中 custom.sty 文件里的 \Marker 定义，并发现了一些解决标记错误的线索：

• 对于“\Marker xt”规则，我当前的 custom.sty 中其“\Occurs under”属性只有值“x”，而在 usfm.sty 文件中，我发现了一个相当长的允许标记列表。
• 对于“\Marker ior”规则，我当前的 custom.sty 中其“\Occurs under”属性只有值“id”，而在 usfm.sty 文件中，我发现它允许出现在各种引言大纲下，以及“NEST”值。
• 对于“\Marker w”规则，我当前的 custom.sty 中是 usfm.sty 文件中出现的值的一个子集，并且缺少“NEST”值。

因此，我制作了 custom.sty 文件的其他临时副本；一个是我使用了 usfm.sty 中这三个标记的所有“\Occurs under”值，另一个是我在 custom.sty 文件中注释掉了这些标记的信息。正如预期的那样，我确实恢复了自定义颜色样式，但 Basic Checks 的结果与我移除 custom.sty 时相同：\xt 和 \ior 的错误已解决，但 \+w 标记仍被报告为“未知标记”。

有没有办法解决 \+w 标记的“未知标记”错误？并且，如上所述编辑我的 custom.sty 文件是否是解决引言中 \xt 和 \ior 标记“不能在此处出现”错误的最佳方式？

机器翻译自 English 显示原文

---

在 \xt 下的 \OccursUnder 部分添加 ip 作为标记
这是我的 custom.sty 文件中的样子

\Marker xt
\Description Cross reference target reference(s)
\OccursUnder x f ex ef fe ip ipi im imi ili ili1 ili2 ipq imq ipr iq iq1 iq2 iex p pi pi1 pi2 ms ms1 ms2 ms3 r mr s1 s2 s3 s4 sr # 3.0 Added ex ef fe  ipq imq ipr iq iq1 iq2 iex  ms ms1 ms2 ms3 r mr s1 s2 s3 s4 sr

您可以添加 NEST。似乎两种方式都可以。如果有人错了请纠正我，但我认为 NEST 仅用于向后兼容。

在具有 \wj . . .\+w Word|Lemma\+w . . .\wj* 的项目中。我在 custom.sty 中对 \w 没有修改，似乎工作正常。
您正在使用 USFM 3.0 吗？

机器翻译自 English 显示原文

---

CrazyRocky:

如果有人错了请纠正我，但我认为 NEST 仅用于向后兼容。

在应用样式时，NEST 仍然需要知道是否可以嵌套（即它是否会自动为样式添加 '+'）。但这基本上就是它唯一的用途。

机器翻译自 English 显示原文

Answer 2

感谢 anon848905 & anon291708，
我想让我困惑的是标记清单窗口顶部的警告，上面写着“这只能由项目管理员完成。”这让我以为验证功能不可用，是因为 Paratext 没有识别出我是管理员。也许最好替换该警告或包含另一条评论，让用户知道有效标记及其顺序是在样式表中定义的。
再次感谢，
BruceBeatham

机器翻译自 English 显示原文

Comments

是的，BruceBeatham，那个“警告”也让我困惑了！

anon200667

机器翻译自 English 显示原文

Answer 3

感谢这些提示。

通过注释掉 custom.sty 文件中 \xt、\ior 和 \w 的部分，以移除对标准 usfm 的任何修改，我能够解决我的 3 个问题中的 2 个：我不再看到任何“occurs under”错误，但仍然有很多与 \w 相关的错误：“Unknown marker \+w”（未知标记 \+w）和“Unknown atributes (lemma): \+w”（未知属性 (lemma): \+w）

CrazyRocky:

您正在使用 USFM 3.0 吗？

是的，该项目现在使用 USFM 3。我最近尝试解决这些错误时将其从 2 更改为 3。

在我拥有的 usfm.sty 中，\w 部分的 \OccursUnder 属性末尾确实包含 NEST。我注意到该部分还有一行被注释掉的代码，写着：
#!\Attributes ?lemma ?strong ?srcloc
这让我怀疑这是否与“未知属性错误”有关

机器翻译自 English 显示原文

Comments

请检查确保 \+w …\+w* 仅用于嵌入式情况，如脚注内或 \wj …\wj* 内部。如果标记不正确，您会遇到“Unknown marker +w”（未知标记 +w）错误。

该行
#!\Attributes ?lemma ?strong ?srcloc
是 USFM 3.0 的 \Attributes 属性。（USFM 2.0 将其视为注释。）
它定义了用 \w 标记的单词的“单词级属性”（词根、Strong 编号和源位置）。例如：
\w gracious|strong="H1234,G5485"\w*
它不应该导致“未知属性错误”。
参见：

• Word Level Attributes — Unified Standard Format Markers 3.0.0 documentation
• Words and Characters — Unified Standard Format Markers 3.0.0 documentation

机器翻译自 English 显示原文

Answer 4

解决了！我意识到并非所有 \+w 标记都被标记为未知。当我查看为什么某些标记被标记时，我发现在那种情况下，实际上在 \w+ 标记之前有一个“周围”字符样式的结束标记，然后在 \w+* 结束后重新启动周围字符样式。因此，由于某种原因，\w+ 实际上并未嵌入。我正在手动进行必要的更改。

机器翻译自 English 显示原文

Answer 5

CrazyRocky:

请检查确保 +w …+w* 仅用于嵌入式情况，如脚注内或 \wj …\wj* 内部。如果标记不正确，您会遇到“Unknown marker +w”（未知标记 +w）错误。

是的！就是那个！

机器翻译自 English 显示原文