將舊版交叉引用檔案轉換為可匯入 Paratext 8-9 的格式

Question

有人問我是否有辦法將舊版的交叉引用檔案匯出或轉換成 Paratext 8-9 可用的格式。以下是原始檔案的格式：

\id Cross References Canonical Sequence
\rem B.C, S.C
\rem Updated 24.4 2003; 14.7 2003 S.C
\rem Added OT, USFM compliant, updated 24.9.07; 16.5.08 I.R.

\ref GEN 1:3
\x - \xo 1:3 \xt 2CO 4:6\x*
\ref GEN 1:6
\x - \xo 1:6-8 \xt 2PE 3:5\x*
\ref GEN 1:26
\x - \xo 1:26 \xt 1CO 11:7\x*
\ref GEN 1:27
\x - \xo 1:27 \xt MAT 19:4; MRK 10:6\x*
\ref GEN 1:27
\x - \xo 1:27-28 \xt GEN 5:1-2\x*
\ref GEN 2:2
\x - \xo 2:2 \xt HEB 4:4, 10\x*
\ref GEN 2:2
\x - \xo 2:2-3 \xt EXO 20:11\x*

我從 Paratext 9 專案中擷取了交叉引用，並發現了這種格式：

GEN.1:3 {2CO.4:6}
GEN.1:6 {2PE.3:5}
GEN.1:26 {1CO.11:7}
GEN.1:27 {MAT.19:4 MRK.10:6}
GEN.1:27 {GEN.5:1-2}
GEN.2:2 {HEB.4:4,10}

我對「引言」行仍有疑問：

Model=BootCmpB
Versification=English
VerseSegmentCount=1

「Model」是必要的嗎？
VerseSegmentCount 是如何運作的？

另外，是否有可能將此格式（包含節範圍）轉換為 PT8-9 格式？

\ref GEN 2:2
\x - \xo 2:2-3 \xt EXO 20:11\x*

謝謝！

james_post

機器翻譯自 English 顯示原文

Answer 1

使用正則表達式（Regex）來：

• 刪除 \ref
• 將 \s*\\x - \\xo\s\S+\s*\\xt\s=> { 進行替換
• 將書名後面的空格替換為 .：\b(\w{3})\s(?=\d+:)=>\1.
• 將 \\x*=>} 進行替換
• 刪除分號 ;

我不確定 Model= 是否為必填項，但我認為其設定值並不關鍵。

您很可能會使用 VerseSegmentCount = 1。當 VerseSegmentCount > 1 時，適用於設計為加入文本中兩個或更多節段（verse segments）的交叉引用。VerseSegmentCount 為 2 時看起來像這樣：MAT.17:5 {MAT.3:17 2PE.1:17} {ACT.3:22,23}。VerseSegmentCount 的數字代表交叉引用資料中節段的最大數量。

我認為 GEN.2:2-3 {EXO.20:11} 原樣即是合法的。

機器翻譯自 English 顯示原文

Comments

謝謝！

有辦法進行跨章節的交叉引用嗎？（指的是實際的 \xo 引用，而非 \xt）

例如這樣：EZR.4:24–EZR.5:1 {HAG.1:1 ZEC.1:1}

我似乎無法讓它運作。

機器翻譯自 English 顯示原文

---

我擔心您無法在左側使用多章節引用。我的變通方法是為需要匯入後額外處理的引用添加 %。
EZR.4:24% {HAG.1:1 ZEC.1:1}
EZR.5:1% {HAG.1:1 ZEC.1:1}
在添加交叉引用之前，您需要將 % 添加到專案的 Extra Material（額外材料）欄位中，該欄位位於 Scripture reference settings（經文引用設定）中。% 會被匯入，然後您可以使用搜尋功能找到它們並建立正確的引用。
其他需要注意的事項：

• 如果您的經文引用設定中有替代語法，例如 ,| and ，則需要在匯入前暫時移除替代語法，否則您將匯入整個替代語法字串。
• 對單章節書卷的引用需要包含第 1 章：
  PSA.73:8 {PSA.1:1 PSA.17:10 JUD.1:16}
  匯入後，您可以搜尋引用中的單章節書卷並移除 1。
• 對多章節引用的引用會在第二個章節引用中包含書卷名稱：
  MAT.11:21-22 {ISA.23:1-8 EZK.26:1--EZK.28:26% JOL.3:4-8 AMO.1:9-10
  我會用 % 標記這些，以便稍後返回並從第二個引用中刪除書卷名稱。
• 您無法僅引用一個章節。您必須包含節範圍：
  LUK.18:31 {PSA.22:1-31%}
  我會用 % 標記這些，以便稍後返回並在匯入後刪除節範圍……

機器翻譯自 English 顯示原文

---

我遇到了另一個問題。這是原始引用：

\ref PSA 34:1
\x - \xo 34:0 \xt 1SA 21:13-15\x*

我嘗試將其匯入到 PSA 34:0，但失敗了。它實際上沒有給我錯誤訊息，只是沒有放入交叉引用。

像這樣的引用是否只需要指向 PSA 34:1？

謝謝，

james_post

機器翻譯自 English 顯示原文

---

感謝提供這些資訊。

有某個「官方」地方發布這些資訊嗎？

有辦法在 XRF 檔案中加入註解嗎？

機器翻譯自 English 顯示原文

---

感謝 @CrazyRocky 提供這些具體範例。我很感激。

我有幾個問題。我也有一些好消息要分享，這些問題似乎實際上不需要使用 % 進行變通處理或返回修改！

有辦法在 .xrf 檔案中加入註解嗎？

為 \xo 引用添加 % 變通方法：我嘗試在引用和額外素材欄位中添加 %，但它沒有被匯入。Paratext 將該引用作為普通引用匯入，沒有 %。我不確定該怎麼辦，但在此分享一個針對變通方法的變通方法。

例如：EZR.4:24% {HAG.1:1 ZEC.1:1}
被匯入為 \x \xo 4:24 \xt Hag 1:1; Sek 1:1\x*

我可以在 \xt 節引用中添加內容以標記以便稍後處理，但不能在 \xo 引用中添加。因此，目前我打算添加 # 以將其與 % 區分開。

例如：EZR.4:24 {HAG.1:1# ZEC.1:1}

對多章引用的引用：Paratext 會自動移除多餘的書名，因此不需要 %。

例如：MAT.11:23-24 {EZK.26:1--EZK.28:26}
被匯入為：\x - \xo 11:23 \xt Ese 26:1—28:26\x*

以及：2CH.1:4 {2SA.6:1-17 1CH.13:5-14 1CH.15:25--1CH.16:1}
被匯入為：\x - \xo 1:4 \xt 2 Sml 6:1-17; 1 Sto 13:5-14; 15:25—16:1\x*

允許整章引用：Paratext 將 :0 匯入為整章，無論是在範圍中還是單獨的章節，因此如果您確實想要引用整章（沒有節範圍），則不需要 %：

範例：1SA.21:12 {PSA.56:0}
被匯入為：\x \xo 21:12 \xt Sng 56\x*

以及：MAT.11:21-22 {EZK.26:0--EZK.28:0}
被匯入為 \x - \xo 11:21 \xt Ese 26—28\x*

機器翻譯自 English 顯示原文

---

james_post:

有辦法在 .xrf 檔案中加入註解嗎？

抱歉，沒有。該檔案格式並非設計為手動編輯/建立，因此沒有註解機制。

機器翻譯自 English 顯示原文

Answer 2

您可以在檔案開頭的版權聲明中加入一般註解。例如：

Copyright=This file contains references taken from The Life Application Study Bible © 1988 by Tyndale 
House Publishers, Inc. The symbols † and % have been included in this file to allow further -import 
processing. They must be added to the project’s Scripture Reference Settings as Extra Material following 
a reference. A † indicates a reference with particular Christological significance. In the LASB this symbol 
precedes these special references. Due to technical limitations this symbol is placed at the end of 
references. It can be moved after import if desired. A % marks references that have a more compact form 
in the LASB but technical limitations do not allow the reference to be imported exactly as the appear. 
After import refer to a printed LASB to see how these should be modified. It is also acceptable to simply 
remove the % on these references.
Model=NLT
Versification=English-NLT
VerseSegmentCount=1
GEN.1:1 {PSA.89:11 PSA.102:25 JHN.1:1-2}

機器翻譯自 English 顯示原文