错误：“脚注调用者不是预期值 (*)”

Question

我所在的团队在标记检查中遇到了大量错误：“Footnote caller is not the expected value (*)”。

我认为我在撰写这条消息时已经解决了这个问题，但我觉得还是值得发送出来，以防其他人遇到同样的问题。

这些错误仅显示包含有效脚注的经文。也就是说，格式为
\f + \fr 2.23 \ft …\f*。

我通过正则表达式（RegEx）确认，+ 是有效脚注中使用的唯一字符。我使用 RegExPal 统计了唯一匹配项（\f . \fr）的数量。这证实了 + 是有效脚注中使用的唯一字符。
settings.xml 中有 +
+

就在发送这条消息之前，我在 RegExPal 中进行了另一次搜索（\f . .），发现新约中有数百个无效脚注，那是十多年前完成的。这些脚注手动定义了调用者（a b c …），但没有经文引用。

我仍然不知道 Paratext 为什么期望 * 作为脚注调用者，也不知道为什么只有有效脚注被报告为错误，但至少我对问题有了更好的理解，并假设解决方案是修正无效的脚注，以便它接受有效的脚注。

我认为他们的第二个错误“Most notes of this type do not have an origin reference.”是相关的。同样，它只列出了看起来像有效脚注的内容。然而，在 700 多个脚注中只有 213 个是有效的，Paratext 是正确的——大多数脚注没有来源引用，但它们应该有！有效的脚注并不是错误。在这种情况下，大多数是错误，只有少数是正确的。

机器翻译自 English 显示原文

Answer 1

我合作的一个团队遇到了相同（几乎）的问题。他们刚刚完成了马可福音，并使用 \x + 插入交叉引用，并在 Language Settings 中定义了数字（1-15）作为要使用的调用者。它运行正常，但当运行 Basic Checks 时，他们收到 54 条（交叉引用的数量）消息，说“Note caller is not the expected value (-)”。为什么 PT 会期望调用者 (-)，而团队在 Language Settings 中定义了不同的调用者集合？更奇怪的是，当我将这本书导入到一个用相同 Language Settings 设置的空“Test”项目时，运行 Basic Checks 不会产生任何错误！

机器翻译自 English 显示原文

Comments

当文本其他地方使用了 \x - 时，会出现此错误。您可以搜索 \x - 并将其更改为 \x +，以便所有引用都具有相同的 \x + 格式。

机器翻译自 English 显示原文

---

谢谢。是在一本书中还是项目中的所有书？我已经对马可福音做了吗？

机器翻译自 English 显示原文

---

Paratext 正在考虑所有的书。

机器翻译自 English 显示原文

Answer 2

我遇到了同样的情况。我们的文本中没有任何 \f *，只有 \f +（普通脚注）和 \f %（一种特殊类型的脚注，在印刷版中省略，但在数字版中保留）。文本中 \f % 的数量多于 \f +，因此 Paratext 认为 \f % 是预期格式，并标记了所有普通的 \f + 脚注。由于数量众多，看起来像是每个脚注都被标记了，但后来我们意识到 \f % 的那些并没有被标记。

让我们误入歧途的是错误消息的实际内容。它显示：
Note caller is not the expected value (*)
这让我们以为它期望的是星号。如果它显示
Note caller is not the expected value (%)
我们就会立刻明白发生了什么。似乎无论您使用什么自定义调用者，如果 Paratext 认为该调用者是预期的，它都会在错误消息中显示 (*) 而不是实际字符。在错误消息中显示实际预期的字符会更清晰。

机器翻译自 English 显示原文

Answer 3

我认为在这种情况下，Paratext 使用 * 作为通配符，而不是代表字符 *。这可能是不幸的，因为有些人确实用 * 标记他们的脚注。在提到的第一种情况中，Paratext 实际上使用的是各种非标准的 + 字符。因此，Paratext 用 * 来指定这一点。即使在所有注释都使用 % 的情况下，Paratext 也将其视为非标准的 +，并用通配符来指定。

机器翻译自 English 显示原文

Answer 4

Hi anon703820

Have you fixed all the
footnotes missing the origin reference, either the \fr marker
or the actual ch/vs reference?

If so, I have created a
regular expression find and replace that

• inserts the missing \fr

  Find:(\\f \S+ )((\\f[^r])|(\d\S+))
Repl:\1\\fr \2

• insert the missing ch.vs reference.
  Find:(?s)(?<=\\c (\d+).*?\\v(\S+).*?\\f \S \\fr )(?!\d)(?=.*\\v)
Repl:\1.\2 for period cv separator
  Repl:\1:\2 for colon cv spearator

I have a third expression to make a reference end with ": " as in
be “ch:vs :”
Find:(\\fr \d+[:.][^ :]+) ?(\\f)
Repl:\1: \2

I have user menu options to do these three functions. To use,
edit usermenu.txt in your \My Paratext Projects root directory. If
that does not exist you can add the attached usermenu.txt to that
directory. It gives you many common tasks to perform related to
cleaning up a project.

FO-05 find fnote missing \fr origin ref marker#csd#(\\f \S+)((\\f[^r])|(\d\S+))
FO-05a add missing \fr to footnote#r#(\\f \S+)((\\f[^r])|(\d\S+))#\1\\fr \2

Admin Edit: Attempted to fix formatting from e-mail.

较早的帖子 - 以原始语言显示

Answer 5

我遇到了这个问题，但无法从上面的回复中弄清楚该怎么做。我不懂正则表达式，目前在约翰福音中添加了两个脚注（如果脚注一直报错，我可不想再添加更多了！），这两个脚注都显示以下消息：
“Note caller is not the expected value (*)”
以及
"Most notes of this type do not have an origin reference.

这些脚注是在 Paratext 中使用 Insert Footnote 添加的。

我尝试对路得记运行 Marker check，其中有一个脚注，但没有出现这些错误消息，但我看不出它和约翰福音中被标记为错误的两个脚注有什么不同。

我的 Paratext 可能有一些奇怪的历史遗留问题，因为这个项目已经进行很长时间了，曾在 Shoebox、Toolbox 甚至 Word 中处理过。后来它经历了几次 Paratext 升级，所以里面潜伏着各种各样的东西！

机器翻译自 English 显示原文

Comments

你好 Ro，很高兴在这里见到你。
你收到这些消息可能是因为约翰福音中旧脚注的形式没有使用自动调用者 \f + 和标准来源引用 \fr C:V。通常人们希望保持一致性，因此 Paratext 正在警告你，旧脚注的格式与使用标准方法添加的脚注不同。路得记中可能很少有或没有旧脚注，所以它没有警告你。你可以打开这些书的脚注窗格（F7）来检查脚注并验证这一点。

如果你想为约翰福音添加 \fr 引用以消除 PT 错误消息警告，可以使用一种特殊方法来添加它们：

1. 从项目菜单中的 Project 选择 Advanced>Insert missing origin references
   提示： 如果你看不到 Advanced 菜单项，请点击菜单底部的向下箭头以查看更多选项。
2. 在 Insert missing origin references 窗口中选择 Insert Missing \fr in footnote。
   
3. 点击 Choose Books，然后选择约翰福音
4. 点击 OK，然后点击 OK。
5. \fr 引用将很快被添加。查看约翰福音中的脚注，看看它们是如何更改的。
6. 运行基本检查，“Most notes of this type do not have an origin reference” 错误现在应该已被消除。

如果你运行此操作并希望消除 “Note caller is not the expected value (*)” 错误。这可以通过让所有脚注使用自动调用者来“修复”。你可以使用以下使用正则表达式的 Find/Replace (CTRL-H) 来完成：
查找：
regex:\\f\s+\S+\s*
替换：
\f +
（确保 + 后面有一个空格）

希望这有帮助。

机器翻译自 English 显示原文

---

CrazyRocky:

\f +

你好，CrazyRocky，好久不见！

谢谢回复。我做了你建议的两件事，现在没有关于脚注的错误消息了。谢谢！

机器翻译自 English 显示原文

Answer 6

我不确定 CrazyRocky 提到的步骤是否会自动插入项目历史点。我建议首先这样做：转到 Project 菜单 > Mark point in history。

在 CrazyRocky 的步骤之后，运行 Basic Checks 将有助于您查看是否还有剩余错误。

另外，如果您想快速查看约翰福音中所有脚注的列表，可以使用 Paratext RegEx Pal。有了列表，您可以快速比较并找到看起来与其他脚注不同的脚注。

点击 Paratext 菜单 > Advanced > RegEx Pal

在 RegEx Pal 中：

1. 从 Project 下拉菜单中选择您的项目
2. 在 Find 中输入 \\f .+?\\f\*
3. 转到 Tools 菜单 > Choose Books
4. 选择您想要查找脚注的书卷
5. 点击 OK
6. 转到 Tools > Count/Extract
7. 选择 Extract
8. 选择 Include References
9. 点击 OK

这应该会给出约翰福音（和/或您选择的任何书卷）中所有脚注的列表。

我建议先尝试 CrazyRocky 提到的其他步骤，如果仍有问题，再尝试此方法。

机器翻译自 English 显示原文

Answer 7

正如您发现的，当语法正确时出现错误可能会非常令人困惑。在 Paratext 9 中，检查不仅检查您是否具有正确的语法，还检查您在整个文本中是否保持一致。

机器翻译自 English 显示原文

Answer 8

谢谢。已解决。

机器翻译自 English 显示原文