若要保留已編輯的 Zotero CSL 規則，請將它們儲存在替換檔案中，並保留自訂樣式的 ID 以供日後修訂。首次自訂儲存庫中的樣式時，請為它指定不同的標題和 ID，以免上游更新覆蓋您的變更。
本工作流程適用於已經有自訂引用樣式，並想安裝修訂版本而不遺失格式設定的 Mac 桌面使用者。關鍵在於保留樣式的識別資訊及其完整的編輯內容。Zotero 的安裝程式碼會取代現有的樣式檔案，不會將您先前的格式編輯合併至新檔案中。Zotero 樣式安裝原始碼
替換自訂樣式時，哪些內容應保持不變？
在編輯中繼資料前，先決定您要修訂同一個自訂樣式，還是建立另一個獨立版本。CSL 將樣式 ID 定義為穩定且唯一的識別碼。Zotero 明確建議，建立現有樣式的自訂副本時，應變更標題和 ID；若保留原始識別資訊，您的編輯就容易受到原樣式更新的影響。CSL 1.0.2 規格：資訊、編輯 CSL 樣式 — 逐步指南
| 您的工作 | 使用的識別資訊 | 要安裝的檔案內容 |
|---|---|---|
| 首次自訂儲存庫中的樣式 | 不同的自訂標題和 ID | 包含您編輯內容的完整樣式 |
| 修訂現有的自訂樣式 | 保留現有的自訂 ID；標題維持可辨識 | 完整的修訂版自訂樣式 |
| 建立獨立的實驗版本 | 不同的標題和 ID | 獨立的完整樣式 |
| 採用較新的上游版本 | 在完成的替換版本中使用您的自訂識別資訊 | 較新的規則，以及您有意保留的自訂編輯 |
請將最後一列視為手動比對工作。從其他地方下載的替換檔案，不會包含只存在於您舊版本機副本中的編輯內容。請保留舊檔，直到您比對完替換版本的輸出。
只變更檔名並不足夠。Zotero 目前的安裝實作會依 ID 檢查是否已有相同樣式，並另外檢查檔名和標題衝突。為不同版本指定不同的標題和 ID，並在繼續前檢查安裝對話框。Zotero 樣式安裝原始碼
準備替換版本前，先儲存實際規則
開啟您確認可正常使用的自訂樣式，並在編輯器外儲存完整副本。實用的做法是將工作檔命名為 neutral-notes.csl，並將封存副本命名為 neutral-notes-before-revision.csl。這些檔名只是整理建議；嵌入的 ID 才是樣式識別資訊的依據。
請使用純文字。在 TextEdit 中，選擇 格式 → 製作純文字，並確認儲存的檔名以 .csl 結尾。Zotero 的編輯指南建議使用純文字編輯，並經常儲存。編輯 CSL 樣式 — 逐步指南
如果您的變更只存在於 Zotero 的 Style Editor 中，請在選取其他樣式或關閉視窗前儲存。編輯器文件提醒，這兩種操作都會讓未儲存的編輯內容遺失。因此，預覽正確只是中間結果。Zotero 樣式編輯器
檢查檔案是否包含格式指示
相依 CSL 樣式是別名：它會指向一個獨立樣式，並使用該父樣式的引用格式。如果您的檔案主要由中繼資料和 independent-parent 連結組成，請取得父樣式，並以它作為自訂獨立副本的起點。重新命名別名不會產生可放置獨立格式規則的空間。入門指南 — CSL 簡介
對於獨立樣式，請檢查相關的 citation、bibliography 和 macro 元素。它們包含呈現指示。修訂現有自訂樣式時，請保留其 id；建立新的分支版本時，請指定唯一識別資訊。現行穩定版規格建議新樣式 ID 使用 UUID，同時也承認既有的 URI 型 ID。CSL 1.0.2 規格
將您的編輯整理成精簡的呈現檢核表
替換任何內容前，先記下幾個明確的預期輸出。這樣便能反覆檢查，即使替換樣式安裝成功，也能發現規則是否遺失。使用合成的作品中繼資料，讓測試結果容易檢視。
例如，假設您的自訂書目規則會以逗號分隔出版者和出版地，並將結果放在括號內。請為名為 Shape Catalogue 的合成書籍，設定以下出版者區段檢查：
| 測試 | 合成中繼資料 | 預期的出版者區段 |
|---|---|---|
| 兩個欄位都有內容 | 出版者：Example Press；出版地：Sample Town |
(Example Press, Sample Town) |
| 只有出版者 | 出版者：Example Press；出版地為空 |
(Example Press) |
| 只有出版地 | 出版者為空；出版地：Sample Town |
(Sample Town) |
| 兩個欄位都空白 | 出版者和出版地皆為空 | 不顯示出版者區段 |
以下是該區段的呈現片段，不是可完整安裝的樣式。它應放在現有書目版面中適當的呈現位置，或放在由該版面呼叫的巨集中。請以它取代舊的出版者區段，不要再新增一份：
<group delimiter=", " prefix="(" suffix=")">
<text variable="publisher"/>
<text variable="publisher-place"/>
</group>
這個群組會提供分隔符號和周圍的標點符號。若群組參照的所有變數皆為空，CSL 會省略該群組。Zotero 的編輯指南使用此模式，以避免欄位缺漏時出現標點問題。這些輸出是根據規格推導出的預期結果，並非此處進行桌面測試所得的結果。CSL 1.0.2 規格：群組、編輯 CSL 樣式 — 逐步指南
請針對實際變更建立相同的檢查：作者分隔符號、標題格式、日期位置，或其他特定規則。記錄每項預期結果適用於文中引用、書目項目，還是兩者皆適用。另外保留一個未變更的範例，以便發現編輯區段以外的意外變動。
在 Mac 上安裝並驗證替換版本
開啟 Zotero → 設定，然後選擇 引用。文件記載，Mac 上的設定位於應用程式選單中。如何變更 Zotero 設定？
請依照以下順序，分別進行儲存、測試和安裝：
- 在 Zotero 資料庫中選取合成測試項目。
- 從
引用開啟Style Editor，並載入或貼上完整的修訂版樣式。 - 按一下
Refresh以使用選取的項目，然後將預覽與呈現檢核表比對。 - 儲存完整編輯版
.csl檔案，並在安裝前依 CSL 結構描述驗證。 - 在樣式管理員中，按一下
+，然後選取剛才儲存的檔案。 - 檢查安裝對話框，然後安裝預期的修訂版本。
- 重新開啟已安裝的樣式，並重複相同的輸出檢查。
編輯器會處理選取的資料庫項目，並在編輯時更新預覽。它可以回報無效的 XML，但預覽本身無法證明 CSL 有效；文件指示您驗證樣式。Zotero 的樣式說明另有記載如何透過 + 安裝本機檔案。Zotero 樣式編輯器、引用樣式
日後修訂時，請從通過這些檢查的已儲存自訂檔案開始。如果您改從較新的上游檔案開始，請將它與封存的自訂副本比對，並在安裝前刻意重新套用必要規則。
為什麼 Word 仍顯示舊格式？
安裝樣式和在 Word 文件中選取樣式是兩個不同步驟。在 Word 的 Zotero 索引標籤中，開啟 Document Preferences，並選取您的自訂樣式。接著使用 Refresh，並檢查一則引用和書目。Zotero 文件指出，可透過 Document Preferences 變更文件的引用樣式。使用 Zotero Word 外掛程式
請勿在 Word 中直接覆寫書目，藉此修正重複出現的樣式規則。Zotero 文件指出，重新整理時會覆寫手動修改的書目。請將可重複使用的格式規則保留在 CSL 檔案中。使用 Zotero Word 外掛程式
根據問題出現的位置，選擇接下來要檢查的項目：
| 您觀察到的情況 | 接下來要檢查的項目 |
|---|---|
| 已儲存的替換檔案缺少您的編輯 | 從封存的工作副本中還原規則 |
| 編輯器預覽不符合檢核表 | 檢查呈現規則和測試項目的欄位 |
| 預覽符合預期，但已安裝的樣式不符合 | 確認安裝的是哪個已儲存檔案，然後重新開啟該已安裝樣式 |
| Zotero 中已安裝樣式的預覽符合預期，但 Word 不同 | 檢查文件選取的樣式，並重新整理 |
| 不同版本意外取代了另一個樣式 | 比對兩者嵌入的 ID 和標題 |
請將完整的工作用 CSL 檔案、穩定的自訂識別資訊，以及少量預期輸出一併保存。下次收到修訂版時，這三項資料能讓您有意識地保留規則，並在依賴替換版本前先驗證。
來源
- 編輯 CSL 樣式 — 逐步指南 — Zotero。
- 引用樣式 — Zotero。
- Zotero 樣式編輯器 — Zotero。
- 如何變更 Zotero 設定？ — Zotero。
- 使用 Zotero Word 外掛程式 — Zotero。
- CSL 1.0.2 規格 — 引用樣式語言。
- 入門指南 — CSL 簡介 — 引用樣式語言。
- Zotero 樣式安裝原始碼：style.js — Zotero。