在 Paratext 中使用来自 \z 命名空间的本地（自定义）USFM 标记

Question

在我们的项目中，我们有时会在脚注或词汇表条目中放入一两个国家语言（高棉语）的单词，并希望对其进行标记以便进行出版前处理。我们定义了一个标记 \zkh（使用 USFM 3.0 中定义的 \z 命名空间），并在 custom.sty 中添加了以下内容：

\Marker zkh
\Endmarker zkh*
\Name zkh...zkh* - Special Text - Khmer Language Text
\Description For Khmer Language text
\OccursUnder ip im ipi imi ipq imq ipr iq iq1 iq2 iq3 io io1 io2 io3 io4 ms ms1 ms2 s s1 s2 s3 s4 cd sp d lh li li1 li2 li3 li4 lf lim lim1 lim2 lim3 lim4 m mi nb p pc ph phi pi pi1 pi2 pi3 pr pmo pm pmc pmr po q q1 q2 q3 q4 qc qr qd qm qm1 qm2 qm3 tr th1 th2 th3 th4 thr1 thr2 thr3 thr4 tc1 tc2 tc3 tc4 tcr1 tcr2 tcr3 tcr4 f fe NEST

不幸的是，我不知道如何在 Paratext 9 中使用它。如果我处于标准视图（Standard view）并开始输入标记（通过输入斜杠），会出现一个上下文菜单，它不让我输入“z”。实际上，它允许我输入，但如果我按回车键，它不会做任何事情——它无法将其放入文本中。

有没有什么方法可以克服这个问题？

谢谢！

机器翻译自 English 显示原文

Answer 1

viverechristus，

当你在窗口中输入标记时，可以按空格键来接受该标记。只有当标记是该列表中的有效标记时，按回车键才有效。例如，如果你按 \ 键，它会显示字符样式。如果你尝试输入 \p 然后按回车，应该什么都不会发生（或者它会给你类似 \pn 的东西）。但是，如果你按 \p 然后按空格，它会添加一个段落标记。在你的情况下，如果你按 \zkh 然后按空格，它应该会添加正确的标记。

请注意，如果在按 \ 之前高亮显示单词，它应该会在选中的单词周围添加开始和结束标记。

机器翻译自 English 显示原文

Comments

谢谢。我本应该早就知道这一点，现在知道了我很高兴。

机器翻译自 English 显示原文

---

anon848905:

只有当标记是该列表中的有效标记时，按回车键才有效。

谢谢你的说明。很高兴了解到这个 Paratext 的细节。但我认为让 Paratext 对 \marker< 回车 > 和 \marker< 空格 > 的处理方式不同并不直观。（像 Shoebox 和 Toolbox 这样的旧 SF 程序对它们的处理是相同的。）

viverechristus 的困惑表明，他也觉得按 < 回车 > 键没有任何反应很奇怪/令人沮丧。

那么，这种不同的行为有什么我看不到的优势吗？

对我来说，要么只有 < 空格 > 才能关闭标记对话框，而 < 回车 > 永远不能关闭它；或者更好的是，Paratext 应该将 \marker< 回车 > 视为与 \marker< 空格 > 相同，用于关闭对话框并插入 SF 标记。（除非有非常充分的理由要做出这种区分。）

因为我觉得普通用户不会记住这种程度的区别（如果他们曾经知道的话）。当它不按预期工作时，他们只会以为自己搞错了什么。

机器翻译自 English 显示原文

---

你说得对，这确实有点奇怪。以下是我的理解。无论添加标记的上下文如何，你总是可以用空格键结束它。所以输入 \p 然后按空格会添加一个段落标记。当然，如果你处于无格式视图（Unformatted view），你会看到这种行为。

回车键的问题在于，当你处于标准视图（Standard view）并使用标记选择工具时，只有当标记当时确实存在于工具中时，回车键才有效。按 \ 键会显示当前基于 usfm.sty 和 custom.sty（以及其他书籍的 frtbak.sty）可用的字符样式。所以如果我按 \ p，我永远不会只看到 \p 选项。我会看到类似 \pn 的东西。如果我输入 \p 然后按回车，我实际上是在选择可用的字符标记之一。然而，由于空格与标记的特性，如果我在输入 p 后按空格，我实际上会得到我想要的标记。

对于段落标记，我通常会按回车，然后输入标记代码。所以如果我按回车然后输入 p，我会看到 \p 选项，当我再次按回车时，我就得到了那个标记。

所以，问题的一部分在于段落样式和字符样式的显示差异，以及根据你是从回车还是空格开始，可见内容的不同。

机器翻译自 English 显示原文

---

davidc78:

对我来说，要么只有 < 空格 > 才能关闭标记对话框，而 < 回车 > 永远不能关闭它；或者更好的是，Paratext 应该将 \marker< 回车 > 视为与 \marker< 空格 > 相同，用于关闭对话框并插入 SF 标记。（除非有非常充分的理由要做出这种区分。）

为了完全清楚。回车和空格都会结束在标记窗口中可见存在的标记。如果标记不存在于窗口中（当你输入标记时，下方的框中没有任何可见内容），那么按回车将没有任何作用。按空格会添加该标记（即使它是一个无效的标记）。

机器翻译自 English 显示原文

---

是的，那非常清楚。我的观点是它不直观。如果我们必须用琐碎的细节来解释某事，那么它不太可能让普通用户明白。不，我们不必改变它。但如果我们要尽量减少混淆，那么 < 回车 > 永远不应该没有任何反应。因为目前，< 回车 > 在那种情况下表现得像 ESC 键——这是反直觉的。

机器翻译自 English 显示原文

---

这解开了从工具栏下拉菜单中选择圣经书卷的谜团。我经常感到沮丧，当我输入，比如说，“ru”，列表中只剩下“RUT”，但我按回车却没有任何反应。我发现如果我按空格，我会得到 RUT，并且章节号选择变为活动状态。我还注意到，当回车确实有效时，它不会将我移动到章节选择，而是直接进入已经填充的章节和节。

顺便说一下，在按回车（并成功移动到我想去的书卷）后，书卷标题（缩写）仍然以蓝色高亮显示，即使光标现在在新选中的书卷中处于活动状态（在这种情况下，是约拿书 1:1）：

不止一次，我假设我的选择失败了，并试图再次输入书卷名称，结果发现我正在向某一节中输入乱码。对我来说，这是一个潜在严重的问题，因为它可能导致节中无意且偶尔未被注意到的编辑。蓝色高亮应该只意味着“准备选择”，而不是“已选择”。

机器翻译自 English 显示原文

---

正是如此。
我也经常发现书卷第一节中有虚假的字母或数字，因为用户以为他们在书卷或章节框中输入，但实际上光标在节文本中处于活动状态。天哪。

正如 viverechristus 指出的，这种行为令人困惑且危险。虽然这很“琐碎”，修复起来可能很麻烦，但它足够危险，以至于现在有两个人提到了它。所以我确信还有其他人也遇到了这个问题。

机器翻译自 English 显示原文

---

是的，我经常看到因错误而添加的额外数字。

机器翻译自 English 显示原文

Answer 2

viverechristus:

有没有什么方法可以克服这个问题？

我认为问题在于你没有为你的自定义标记指定类型。如果缺少类型，Paratext 会假设它是段落样式。
尝试在你的 custom.sty 文件的标记定义中添加以下行：
\StyleType Character

机器翻译自 English 显示原文

Comments

谢谢。指定 StyleType 后，该标记被添加到了上下文选择工具中。

机器翻译自 English 显示原文

---

顺便问一下，我可以在哪里查看有关有效样式表定义的文档？

机器翻译自 English 显示原文

---

要做的一件事是查看（不要编辑）usfm.sty 文件，看看样式是如何定义的。另一件要查看的事情是帮助主题“如何为我的项目实现自定义样式表？”

机器翻译自 English 显示原文

---

谢谢，anon848905。

机器翻译自 English 显示原文

Answer 3

我刚刚将此报告为 PTXS-23210。如果其他人也看到了这个问题，也许你们也可以报告一下。

机器翻译自 English 显示原文