我是專案管理員，但無法將 \+xt 標記為有效

Question

我想列印利未記某一章的測試副本（草稿，轉為 PDF），在將 \xt 標記改為 +xt 之後，但列印任務因標記無效而被拒絕，不過我還是把它列印出來了。當我前往標記清單（inventory of markers）時，發現新標記已列出，但我無法勾選確認它們是有效的。

機器翻譯自 English 顯示原文

Answer 1

請使用說明 > 回報問題（Help > Report a problem）向我們回報此問題。這將包含一些日誌檔案，可能有助於診斷問題。

機器翻譯自 English 顯示原文

Comments

我會針對此問題發送另一份錯誤報告，供您比較。在我擔任管理員的專案中，我在 PT8 和 PT9 中都觀察到相同的行為。

機器翻譯自 English 顯示原文

---

哎呀，抱歉，我想我在另一個說明主題（Introduction to inventories for checking）中找到了答案。看來標記的有效性是在樣式表（style sheet）中設定的，而不是在清單工具（inventory tool）中。

機器翻譯自 English 顯示原文

---

BruceBeatham，

您回報的問題是無法驗證標記。這一直是 Paratext 的運作方式。標記清單（marker inventory）不允許驗證——它只是提供專案中使用的標記列表。

詳細說明
驗證是由樣式表（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:

看來標記的有效性是在樣式表中設定的，而不是在清單工具中。

是的，我很抱歉。我忘了標記清單（Marker Inventory）只是標記列表，不允許使用者選擇其是否有效。抱歉誤導了你們兩位。

機器翻譯自 English 顯示原文

---

再次您好，

我回到這個討論串，詢問處理這些以及其他在基本檢查（basic checks）中出現的標記相關錯誤的最佳實務。由於它們的有效性是在 .sty 檔案中定義的，這讓我認為需要在該處進行設定以解決錯誤，但如果應該在其他地方進行變更，我不想在內部機制（under the hood）中亂動。

我已經忽略/拒絕標記錯誤一段時間了，但現在我正在準備一本書提交給 DBL，這些錯誤似乎應該更恰當地解決。有三種我無法解決的一般標記錯誤：

• \xt 不允許在引言段落（\ip）中；
• \ior 不允許在引言大綱段落（\io#）中；以及
• 嵌入標記被報告為「未知」（例如，嵌入在耶穌話語中的詞彙表連結，帶有 \+w 標記）。

專案屬性（Project Properties）進階標籤頁中的樣式表資訊顯示它正在使用 usfm.sty 樣式表，並註明它是「已自訂」（Customized）。我將 USFM 版本改為 3，但基本檢查的結果沒有變化。當我在「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 後，進階標籤頁不再報告「已自訂」樣式表）。我不再擁有我們習慣的自訂顏色樣式，但當我在那種設定下執行基本檢查時，\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 檔案中這些標記的資訊。正如預期，我確實恢復了自訂顏色樣式，但基本檢查的結果與我移除 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，
我想讓我困惑的是標記清單（Markers Inventory）視窗頂部的警告，上面寫著「這只能由專案管理員執行。」這讓我以為驗證功能不可用，是因為 Paratext 沒有識別我為管理員。也許最好替換該警告，或包含另一條註解，讓使用者知道有效標記及其順序是在樣式表中定義的。
再次感謝，
BruceBeatham

機器翻譯自 English 顯示原文

Comments

是的，BruceBeatham，那個「警告」（Alert）也讓我困惑了！

anon200667

機器翻譯自 English 顯示原文

Answer 3

感謝這些提示。

透過註解掉 custom.sty 檔案中 \xt、\ior 和 \w 的部分，以移除對標準 usfm 的任何修改，我能夠解決我的三個問題中的兩個：我不再看到任何「occurs under」錯誤，但仍然有很多與 \w 相關的錯誤：「Unknown marker \+w」和「Unknown atributes (lemma): \+w」

CrazyRocky:

您正在使用 USFM 3.0 嗎？

是的，該專案現在使用 USFM 3。我最近嘗試解決這些錯誤時，將其從 2 改為 3。

在我擁有的 usfm.sty 中，\w 部分的 \OccursUnder 屬性確實包含末尾的 NEST。我注意到該部分還有一行被註解掉的內容，寫著：
#!\Attributes ?lemma ?strong ?srcloc
這讓我懷疑這是否與「Unknown attributes error」有關

機器翻譯自 English 顯示原文

Comments

檢查以確保 \+w …\+w* 僅用於嵌入情況，例如在腳註中或 \wj …\wj* 內部。如果未正確標記，您將得到「Unknown marker +w」錯誤。

該行
#!\Attributes ?lemma ?strong ?srcloc
是 USFM 3.0 的 \Attributes 屬性。（USFM 2.0 將其視為註解。）
它定義了標記為 \w 的字詞的「字詞層級屬性」（Word Level Attributes）（Lemma、Strong’s Number 和 Source Location）。例如：
\w gracious|strong="H1234,G5485"\w*
它不應該導致「Unknown attributes error」。
請參閱：

• 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」錯誤。

是的！就是那個！

機器翻譯自 English 顯示原文