編集済みのZotero CSLルールを維持するには、置き換え用ファイルに保存し、後で改訂できるようカスタムスタイルのIDを保持してください。リポジトリのスタイルを初めてカスタマイズするときは、上流の更新によって変更が失われないよう、固有のタイトルとIDを付けてください。

この手順は、すでにカスタム引用スタイルを使っているMacデスクトップユーザーが、書式設定の決定を失わずに改訂版をインストールしたい場合を想定しています。重要なのは、スタイルの識別情報と編集済みの全内容の両方を保持することです。Zoteroのインストールコードは既存のスタイルファイルを置き換えます。以前に行った書式編集を新しいファイルに統合することはありません。Zoteroスタイルのインストールに関するソース

カスタムスタイルを置き換えるとき、何を変えずに保つべきですか？

メタデータを編集する前に、同じカスタムスタイルを改訂するのか、別の選択肢を作るのかを決めてください。CSLでは、スタイルIDを安定した一意の識別子として定義しています。Zoteroは、既存スタイルのカスタマイズ版を作るとき、タイトルとIDを変更するよう明示的に勧めています。元の識別情報を保持すると、元スタイルの更新によって編集内容が失われるおそれがあるためです。CSL 1.0.2仕様：Info、CSLスタイルの編集 — ステップバイステップガイド

作業 使用する識別情報 インストールするファイルの内容
リポジトリスタイルを初めてカスタマイズする 固有のカスタムタイトルとID 編集内容を含むスタイル全体
既存のカスタムスタイルを改訂する 既存のカスタムID。認識しやすいタイトルも保持 改訂済みのカスタムスタイル全体
別の実験的な選択肢を作る 固有のタイトルとID 別個の完全なスタイル
新しい上流バージョンを採用する 完成した置き換え用ファイルにカスタム識別情報を設定 新しいルールと、意図的に引き継ぐカスタム編集

最後の行は手動で比較する作業です。別の場所からダウンロードした置き換え用ファイルには、古いローカルコピーにしか存在しない編集は含まれません。置き換え後の内容を比較するまで、古いファイルを保管しておいてください。

ファイル名だけを変更しても不十分です。Zoteroの現在のインストール実装では、既存スタイルをIDで確認し、さらにファイル名とタイトルの重複も確認します。別のバリエーションには、固有のIDだけでなく固有のタイトルも付け、インストールを続ける前にダイアログを確認してください。Zoteroスタイルのインストールに関するソース

置き換え用ファイルを準備する前に、実際のルールを保存する

動作確認済みのカスタムスタイルを開き、エディターの外に完全なコピーを保存してください。たとえば、作業用ファイルをneutral-notes.csl、アーカイブ用コピーをneutral-notes-before-revision.cslという名前にします。これらのファイル名は整理のための提案です。スタイルの識別情報を決めるのは埋め込まれたIDです。

プレーンテキストを使ってください。TextEditでフォーマット → 標準テキストにするを選び、保存するファイル名が.cslで終わるようにします。Zoteroの編集ガイドは、プレーンテキストで編集し、こまめに保存することを勧めています。CSLスタイルの編集 — ステップバイステップガイド

変更内容がZoteroのスタイルエディターにしかない場合は、別のスタイルを選択したりウィンドウを閉じたりする前に保存してください。エディターのドキュメントによると、どちらの操作でも未保存の編集は失われます。したがって、プレビューが正しく表示されるだけでは、途中段階にすぎません。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仕様：Group、CSLスタイルの編集 — ステップバイステップガイド

実際の変更内容についても、同様の確認項目を作成してください。著者の区切り方、タイトルの書式、日付の配置など、具体的なルールを対象にします。それぞれの期待値が本文中の引用、参考文献の項目、またはその両方に関するものかも記録してください。編集した部分以外が誤って変わっていないか確認するため、変更しない例も1つ残してください。

Macに置き換え用ファイルをインストールして確認する

Zotero → 設定を開き、引用を選択します。Macで設定を開く場所として、アプリケーションメニューがドキュメントに記載されています。Zoteroの設定を変更するには？

保存、テスト、インストールをそれぞれ行うには、次の手順を使います。

  1. Zoteroライブラリで架空のテスト項目を選択します。
  2. 引用からスタイルエディターを開き、改訂後のスタイル全体を読み込むか貼り付けます。
  3. 更新をクリックして選択項目を使い、プレビューを出力仕様と比較します。
  4. 編集済みの.cslファイル全体を保存し、インストール前にCSLスキーマに照らして検証します。
  5. スタイルマネージャーで+をクリックし、保存済みのファイルを選択します。
  6. インストールダイアログを確認してから、目的の改訂版をインストールします。
  7. インストール済みのスタイルを再度開き、同じ出力項目をもう一度確認します。

エディターは選択したライブラリ項目を処理し、編集に応じてプレビューを更新します。無効なXMLは報告できますが、プレビューが表示されるだけでは有効なCSLであるとは確認できません。ドキュメントでは、スタイルを検証するよう案内しています。+を使ったローカルファイルのインストールについては、Zoteroのスタイルに関する説明に別途記載されています。Zoteroスタイルエディター、引用スタイル

以後の改訂では、これらの確認に合格した保存済みカスタムファイルを出発点にしてください。代わりに新しい上流ファイルから始める場合は、アーカイブ済みのカスタムコピーと比較し、必要なルールを意図的に再適用してからインストールしてください。

Wordに古い書式が表示されるのはなぜですか？

スタイルのインストールとWord文書での選択は別の手順です。WordのZoteroタブで文書設定を開き、カスタムスタイルを選択してください。その後、更新を使い、引用と参考文献の両方を確認します。Zoteroのドキュメントによると、文書の引用スタイルを変更するには文書設定を使います。Zotero Wordプラグインの使用

繰り返し適用するスタイルルールを直すために、Wordで参考文献の文字を直接書き換えるのは避けてください。Zoteroのドキュメントによると、参考文献を手動で編集しても、更新時に上書きされます。繰り返し使う書式ルールはCSLファイルに記述してください。Zotero Wordプラグインの使用

問題が起きている場所に応じて、次に確認する内容を選んでください。

観察されたこと 次に確認すること
保存済みの置き換え用ファイルに編集内容がない アーカイブした作業用コピーからルールを復元する
エディターのプレビューが出力仕様を満たさない レンダリングルールとテスト項目のフィールドを確認する
プレビューは仕様を満たすが、インストールしたスタイルでは失敗する どの保存済みファイルをインストールしたかを確認し、そのインストール済みスタイルを開き直す
Zoteroのインストール済みスタイルのプレビューは仕様を満たすが、Wordでは異なる 文書で選択されているスタイルを確認し、更新する
別のバリエーションが予期せず別のスタイルを置き換える 埋め込まれたIDとタイトルを比較する

作業用CSLファイル全体、安定したカスタム識別情報、期待する出力項目をまとめて保管してください。次の改訂版が届いたとき、この3つがあればルールを意図的に引き継ぎ、置き換えに依存する前に確認できます。

出典