在 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」。實際上，它允許我輸入，但如果我按下 Enter，它不會做任何事情——它無法找到進入文字的路徑。

有沒有辦法克服這個問題？

謝謝！

機器翻譯自 English 顯示原文

Answer 1

viverechristus，

當您在視窗中輸入標記時，可以按下空格鍵來接受該標記。只有當該標記是該列表中有效的標記時，按下 Enter 才會起作用。例如，如果您按下 \，它會顯示字元樣式。如果您嘗試輸入 \p 然後按 Enter，應該不會發生任何事情（或者它會給您類似 \pn 的東西）。但是，如果您按下 \p 然後按空格，它會添加一個段落標記。在您的情況下，如果您按下 \zkh 然後按空格，它應該會添加正確的標記。

請注意，如果您在按下 \ 之前選中了單詞，它應該會在選中的單詞周圍添加開始和結束標記。

機器翻譯自 English 顯示原文

Comments

謝謝。我本應該早就知道這一點，很高興現在知道了。

機器翻譯自 English 顯示原文

---

anon848905:

只有當該標記是該列表中有效的標記時，按下 Enter 才會起作用。

感謝您的說明。聽到這個 Paratext 的細節非常不錯。但我認為讓 Paratext 對 \marker< Enter > 和 \marker< Space > 採取不同的處理方式並不直覺。（像 Shoebox 和 Toolbox 這樣的舊 SF 程式對這些的處理是相同的。）

viverechristus 的困惑表明，他也覺得按下 < Enter > 後 什麼都沒發生 很奇怪/令人沮喪。

那麼，這種不同的行為有什麼優點是我沒看到的嗎？

對我來說，要麼只有 < Space > 才能關閉標記對話框，而 < Enter > 永遠不能關閉它；或者更好的是，Paratext 應該將 \marker< Enter > 視為與 \marker< Space > 相同，以關閉對話框並插入 SF 標記。（除非有非常充分的理由要做出這種區分。）

因為我認為普通用戶不會記住這種程度的區分（如果他們曾經知道的話）。當它不按預期運作時，他們只會以為自己搞錯了什麼。

機器翻譯自 English 顯示原文

---

您說得對，這確實有點奇怪。以下是我的理解。無論在添加標記的上下文中如何，您總可以透過空格鍵來結束它。因此，輸入 \p 然後按空格會添加一個段落標記。這當然是在無格式檢視（Unformatted view）中會看到的行為。

Enter 鍵的問題在於，當您處於標準檢視（Standard view）並使用標記選擇工具時，只有當該標記當時實際存在於工具中時，Enter 鍵才會起作用。按下 \ 鍵會顯示根據 usfm.sty 和 custom.sty（以及其他書籍的 frtbak.sty）當前可用的字元樣式。因此，如果我按下 \ p，我永遠不會只看到 \p 選項。我會看到類似 \pn 的東西。如果我輸入 \p 然後按 Enter，我實際上是在選擇可用的字元標記之一。然而，由於空格與標記的特性，如果我在輸入 p 後按空格，我實際上會得到我想要的標記。

對於段落標記，我通常會按下 Enter，然後輸入標記代碼。因此，如果我按下 Enter 然後輸入 p，我會看到 \p 選項，當我再次按下 Enter 時，我就得到了該標記。

因此，問題的一部分在於段落樣式和字元樣式的顯示差異，以及根據您是從 Enter 還是 Space 開始而可見的內容差異。

機器翻譯自 English 顯示原文

---

davidc78:

對我來說，要麼只有 < Space > 才能關閉標記對話框，而 < Enter > 永遠不能關閉它；或者更好的是，Paratext 應該將 \marker< Enter > 視為與 \marker< Space > 相同，以關閉對話框並插入 SF 標記。（除非有非常充分的理由要做出這種區分。）

為了完全清楚。Enter 和 Space 都會結束在標記視窗中可見的標記。如果標記不存在於視窗中（當您輸入標記時，下方的框中沒有可見內容），那麼按下 Enter 不會做任何事情。按下 Space 會添加該標記（即使它是無效的標記）。

機器翻譯自 English 顯示原文

---

是的，這說得非常清楚。我的觀點是這不直覺。如果我們必須用瑣碎的細節來解釋某事，那麼它不太可能對普通用戶來說永遠是清楚的。不，我們不需要改變它。但如果我們希望將混淆降到最低，那麼 < Enter > 永遠不應該什麼都不做。因為就目前而言，在那種情況下 < Enter > 的行為就像 ESC 一樣——這是不直覺的。

機器翻譯自 English 顯示原文

---

這解開了從工具列下拉選單中選擇聖經書卷的謎團。當我輸入，例如，“ru”時，列表中只剩下“RUT”，但我按下 Enter 卻什麼都沒發生，這讓我經常感到沮喪。我發現如果我按下空格，我會得到 RUT，並且章節號選擇變得活躍。我還注意到，當 Enter 確實起作用時，它不會將我移動到章節選擇，而是直接跳到已經填充的章節和節。

順便說一下，在按下 Enter（並成功移動到我想要的書卷）後，書卷標題（縮寫）仍然以藍色高亮顯示，即使游標現在已經在新選擇的書卷中處於活躍狀態（在本例中是約拿書 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 顯示原文