custom.sty 样式表中的冗余内容

Question

我有一个项目，其 custom.sty 样式表中似乎包含大量过时内容，其中包括以下部分：

...
\Marker pc
\OccursUnder mt3

\Marker b
\OccursUnder mt3

# Custom style file created by the upgrade to Paratext 8.0. It is based upon
# the original style files used by your project.
# These files have been removed, but a backup of the files has been saved to
# usfm.sty.bak and custom.sty.bak.
...

在这个项目中，他们在诗篇中使用 \b 标记来标示段落分隔，但它们全部显示为红色，即视为错误：

我推测这是因为该自定义样式表规定 \b 仅出现在 \mt3 之下。我想如果我从 custom.sty 中移除 \b 标记的定义，就能解决这个问题。

但我想知道这个样式表中还有哪些来自远古时代的内容（提到了升级到 Paratext 8.0……）。如果这个团队实际上并没有任何自定义样式需求，我是否可以直接删除该 custom.sty 文件，使其回退到标准 USFM 样式？那样可能对他们更有利。有什么要求或注意事项是我应该知道的吗？需要管理员权限才能发送该更改吗？

机器翻译自 English 显示原文

Answer 1

有意思……我实际上把 \Marker b 行从 custom.sty 中移除了，现在 \b 标记不再显示为红色，也就是说没有报错。这让我认为 \OccursUnder 行替换了标准定义中的内容。我假设标准定义位于主“My Paratext X Projects”文件夹中的 USFM.sty 文件里？该文件中的 \b 标记只有一个简单的 \OccursUnder c。那么为什么现在 \b 在 \q1 下面也是正常的呢？看来我们需要更努力地理解其工作原理。

但就我的具体情况而言，我假设如果这个项目没有特殊的样式需求，我只需删除 custom.sty 文件，就能恢复默认样式，对吗？

机器翻译自 English 显示原文

Comments

如果有人能写一份关于“OccursUnder”的正式描述，我会站起来称他们为有福的（而这通常是我只对母亲做的事）。

如您所发现的，custom.sty 文件中的行会替换 usfm.sty 文件中的内容。它不仅仅是补充或添加。

补充概念发挥作用的地方在于，在您的 custom.sty 文件中，您不必重写 usfm.sty 中定义的每一行；如果您编辑了它，它会覆盖 usfm.sty。但如果您没有提到它，那么 usfm.sty 仍然有效。

我仍然模糊不清的是 OccursUnder 的确切范围。我认为它的意思是“这个标记是否落在该其他标记下的某个层级中？”。所以 \b 落在某个东西（可能是 \v）之下，而那个东西又落在另一个东西 \c 之下——重要的那个——而那个又落在另一个东西之下——也许是 \id，等等。如果能看到一个流程图或某种组织结构，以查看（根据 usfm.sty）什么被视为什么的子集，那就太好了。

机器翻译自 English 显示原文

---

mnjames:

如果有人能写一份关于“OccursUnder”的正式说明，我会站起来称他们为有福的（而这通常是我只对母亲做的事）。

看来 Nathan 将不得不获得你的祝福……

样式表如何指定标记允许出现的位置？ Helps

在样式表中，\OccursUnder 和 \Rank 协同工作以指定标记有效的位置。 如果标记没有 \OccursUnder 条目，它可以以任何顺序出现在任何位置。 如果标记有 \OccursUnder 条目，则它必须至少有一个“父级”标记在 OccursUnder 列表中。“父级”必须出现在所讨论标记的任何出现之前。 例如：标记“\p”说“\OccursUnder c”；这意味着在第一个 \p 之前必须有一个前置的章节标记，并且它停止……

机器翻译自 English 显示原文

Answer 2

你好，jeffh。我经常创建 custom.sty 样式表（实际上，上面提到的可能就是我创建的其中之一）。那里的定义是对 usfm.sty 中已有内容的补充。usfm.sty 文件已经包含了 \b 的定义，包括它出现在哪些标记下，因此 custom.sty 中的任何内容都是额外的（而不是将其限制为“仅”）。在这种情况下，该项目显然在某个阶段希望能够在 \mt3 之后有一个额外的空行，当然，更好的做法可能是直接增加 \mt3 样式定义中的“段后间距”。正如你所说，检查项目中是否真的需要 custom.sty 的一个好方法是将其从项目文件夹中移除，看看会发生什么（查看“运行基本检查”（Run basic checks）报告的内容）。不过，为了让 \b 不再显示为红色，你实际上应该在 custom.sty 中添加以下内容：
\Marker b
\OccursUnder q1

机器翻译自 English 显示原文