Чтобы сохранить изменённые правила 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. Это лишь рекомендации по организации файлов; идентификатор стиля задаётся внутри файла.

Используйте обычный текст. В TextEdit выберите Формат → Преобразовать в простой текст и убедитесь, что сохранённый файл имеет расширение .csl. В руководстве Zotero по редактированию рекомендуется работать с простым текстом и часто сохранять изменения. Редактирование стилей CSL — пошаговое руководство

Если ваши изменения существуют только в Редакторе стилей Zotero, сохраните их, прежде чем выбирать другой стиль или закрывать окно. В документации редактора предупреждается, что оба действия приводят к потере несохранённых правок. Поэтому корректное отображение в предварительном просмотре — лишь промежуточный результат. Редактор стилей Zotero

Проверьте, содержит ли файл правила форматирования

Зависимый стиль CSL — это псевдоним: он ссылается на независимый родительский стиль, формат которого применяется к цитатам. Если ваш файл состоит в основном из метаданных и ссылки independent-parent, возьмите за основу родительский стиль и создайте из него независимую пользовательскую копию. Переименование псевдонима не создаёт места для отдельных правил форматирования. Введение — знакомство с CSL

В независимом стиле проверьте соответствующие элементы citation, bibliography и macro. В них содержатся инструкции рендеринга. Для обновления существующего пользовательского стиля сохраните его id; для новой ветки задайте уникальный идентификатор. В актуальной стабильной спецификации для новых ID стилей рекомендуются UUID, при этом существующие ID в формате URI также допускаются. Спецификация CSL 1.0.2

Составьте краткий список ожидаемых результатов рендеринга

Прежде чем что-либо заменять, запишите несколько точных ожидаемых результатов. Это позволит вам повторять проверку и обнаруживать отсутствующее правило, даже если замена установилась успешно. Используйте вымышленные метаданные, чтобы результаты было легко проверить.

Например, предположим, что правило вашей пользовательской библиографии разделяет издателя и место издания запятой и заключает результат в круглые скобки. Задайте следующие проверки для блока издателя у вымышленной книги под названием Каталог форм:

Проверка Вымышленные метаданные Ожидаемый блок издателя
Заполнены оба поля Издательство: Пример Пресс; место: Образцовый Город (Example Press, Sample Town)
Указано только издательство Издательство: Пример Пресс; место пусто (Example Press)
Указано только место Издательство пусто; место: Образцовый Город (Sample Town)
Оба поля пусты Издательство и место пусты Блок издателя отсутствует

Ниже приведён фрагмент рендеринга этого блока, а не полный стиль, готовый к установке. Его нужно поместить в соответствующее место макета библиографии или в макрос, который этот макет вызывает. Замените старый блок издателя, а не добавляйте второй экземпляр:

<group delimiter=", " prefix="(" suffix=")">
  <text variable="publisher"/>
  <text variable="publisher-place"/>
</group>

Группа задаёт разделитель и окружающую пунктуацию. CSL не отображает группу, если все упомянутые в ней переменные пусты. В руководстве Zotero по редактированию этот приём используется для предотвращения проблем с пунктуацией при отсутствии поля. Это ожидаемые результаты, выведенные из спецификации, а не результаты проведённого здесь теста в настольном приложении. Спецификация CSL 1.0.2: Group, Редактирование стилей CSL — пошаговое руководство

Составьте такие же проверки для своих изменений: разделителей авторов, форматирования заглавий, расположения даты или других конкретных правил. Укажите, относится ли каждое ожидание к внутритекстовой цитате, записи в библиографии или к обоим вариантам. Также сохраните один неизменённый пример, чтобы выявить случайные изменения за пределами отредактированного блока.

Установите замену и проверьте её на Mac

Откройте Zotero → Настройки, затем выберите Цитирование. В документации указано, что на Mac настройки находятся в меню приложения. Как изменить настройки Zotero?

Соблюдайте следующий порядок, чтобы сохранение, проверка и установка шли отдельными этапами:

  1. Выберите в библиотеке Zotero тестовые записи с вымышленными данными.
  2. Откройте Редактор стилей в разделе Цитирование и загрузите или вставьте полный обновлённый стиль.
  3. Нажмите Обновить, чтобы применить выбранные записи, затем сравните предварительный просмотр со списком ожидаемых результатов рендеринга.
  4. Сохраните полный отредактированный файл .csl и проверьте его на соответствие схеме CSL перед установкой.
  5. В диспетчере стилей нажмите + и выберите сохранённый файл.
  6. Проверьте диалог установки, затем установите нужную версию.
  7. Снова откройте установленный стиль и повторите те же проверки результатов.

Редактор обрабатывает выбранные записи библиотеки и обновляет предварительный просмотр по мере редактирования. Он может сообщать о некорректном XML, однако одного предварительного просмотра недостаточно, чтобы подтвердить корректность CSL: документация редактора предписывает проверить стиль. Установка из локального файла с помощью + отдельно описана в инструкциях Zotero по стилям. Редактор стилей Zotero, Стили цитирования

Для последующих обновлений начинайте с сохранённого пользовательского файла CSL, который прошёл эти проверки. Если вы начинаете с более нового файла исходного стиля, сравните его с архивной пользовательской копией и намеренно повторно внесите необходимые правила перед установкой.

Почему Word по-прежнему показывает старое форматирование?

Установка стиля и его выбор для документа Word — разные действия. На вкладке Word Zotero откройте Настройки документа и выберите пользовательский стиль. Затем нажмите Обновить и проверьте цитату и библиографию. В документации Zotero указано, что параметр Настройки документа позволяет менять стиль цитирования в документе. Использование плагина Zotero для Word

Не исправляйте повторяющееся правило стиля, вручную редактируя библиографию в Word. В документации Zotero указано, что при обновлении ручные правки библиографии перезаписываются. Постоянные правила форматирования следует хранить в файле CSL. Использование плагина Zotero для Word

Определите следующую проверку по месту, где возникла ошибка:

Что вы наблюдаете Что проверить дальше
В сохранённом файле замены нет вашей правки Восстановите правило из архивной рабочей копии
Предварительный просмотр в редакторе не соответствует вашим ожиданиям Проверьте правило рендеринга и поля тестовой записи
Предварительный просмотр соответствует ожиданиям, но установленный стиль работает иначе Убедитесь, какой именно сохранённый файл вы установили, затем снова откройте установленный стиль
Предварительный просмотр установленного стиля в Zotero соответствует ожиданиям, но Word показывает другое Проверьте выбранный для документа стиль и обновите документ
Отдельный вариант неожиданно заменил другой стиль Сравните встроенные в них ID и названия

Храните полный рабочий файл CSL, постоянный пользовательский идентификатор и небольшой набор ожидаемых результатов вместе. Когда появится следующая версия, эти материалы позволят осознанно перенести правила и проверить замену, прежде чем полагаться на неё.

Источники