custom.sty 樣式表中的無效內容

Question

我有一個專案，其 custom.sty 樣式表似乎包含許多舊內容，其中包括以下部分：

...
\Marker pc
\OccursUnder mt3

\Marker b
\OccursUnder mt3

# Custom style file created by the upgrade to Paratext 8.0. It is based upon
# the original style files used by your project.
# These files have been removed, but a backup of the files has been saved to
# usfm.sty.bak and custom.sty.bak.
...

在這個專案中，他們在詩篇中使用 \b 標記來標示段落分隔，但這些標記全都顯示為紅色，表示錯誤：

我推測這是因為這個自訂樣式表規定 \b 只能出現在 \mt3 之下。我想如果我從 custom.sty 中移除 \b 標記的定義，應該就能解決這個問題。

但我想知道這個樣式表中還有其他哪些來自早期版本（提到了升級到 Paratext 8.0……）的內容。如果這個團隊實際上沒有任何自訂樣式需求，我是否可以直接刪除該 custom.sty 檔案，讓它恢復為標準 USFM 樣式？這樣可能對他們更有幫助。有什麼要求或注意事項是我應該知道的嗎？需要管理員權限才能發送該變更嗎？

機器翻譯自 English 顯示原文

Answer 1

有趣……我實際上將 \Marker b 行從 custom.sty 中移除，現在 \b 標記不再顯示為紅色，即不再給出錯誤。這讓我認為 \OccursUnder 行取代了標準定義中的內容。我假設標準定義是位於主要 My Paratext X Projects 資料夾中的 USFM.sty 檔案？該檔案中的 \b 標記只有一個簡單的 \OccursUnder c。那麼為什麼現在 \b 在 \q1 之下也是被接受的？看來我們需要更努力地理解這是如何運作的。

但就我的具體情況而言，我假設如果這個專案沒有任何特殊樣式需求，我應該可以只刪除 custom.sty 檔案，這樣就能恢復預設樣式？

機器翻譯自 English 顯示原文

Comments

If someone would write up a formal description of “OccursUnder”, I would rise up and call them blessed (and that’s something I typically only do for my mother).

As you’ve discovered, the line in a custom.sty sheet replaces what is in the usfm.sty sheet. It doesn’t merely supplement or add to it.

Where the supplement idea comes into play is that in your custom.sty sheet, you don’t have to rewrite every line defined in usfm.sty; if you edit it, it overrides usfm.sty. But if you don’t mention it, then usfm.sty still is in effect.

Where I’m still fuzzy is exactly the scope of OccursUnder. I think what it means is “does this marker fall somewhere in the heirarchy under that other marker?”. So \b falls under something (probably \v), which falls under something else \c–the important one, which falls under something else–maybe \id, etc. It would be nice to see a flow chart or some sort of organization to see what (according to usfm.sty) is considered a subset of what.

---

mnjames:

If someone would write up a formal description of “OccursUnder”, I would rise up and call them blessed (and that’s something I typically only do for my mother).

嗯，看來 Nathan 必須獲得你的祝福了……

How does the stylesheet specify where a marker is allowed to occur? Helps

In a stylesheet, \OccursUnder and \Rank work together to specify where a marker is valid. If a marker does not have an \OccursUnder entry, it can occur anywhere in any order. If a marker has an \OccursUnder entry, then it must have at least one “parent” marker in the OccursUnder list. A “parent” must occur before any occurrence of the marker concerned. For example: marker “\p” says “\OccursUnder c”; this means there must be a preceding chapter marker somewhere before the first \p, and it stop…

機器翻譯自 English 顯示原文

Answer 2

嗨 jeffh。我經常建立 custom.sty 樣式表（事實上，上面的可能就是我建立的其中之一）。那裡給出的定義是對 usfm.sty 中已有內容的補充。usfm.sty 檔案已經包含 \b 的定義，包括它出現在哪些標記之下，因此 custom.sty 中的內容是附加在那之上的（而不是將其限制為「僅」）。在這種情況下，該專案顯然在某個階段希望能在 \mt3 之後有一個額外的空行，當然，更好的做法可能是直接增加 \mt3 樣式定義中的「後間距」。正如你所說，檢查 custom.sty 在專案中是否真的需要的一个好方法是將其從專案資料夾中移除，看看會發生什麼情況（即執行 Run basic checks 後報告的內容）。不過，為了讓 \b 不再顯示為紅色，你應該實際在 custom.sty 中新增：
\Marker b
\OccursUnder q1

機器翻譯自 English 顯示原文