Aby zachować edytowane reguły CSL Zotero, zapisz je w pliku zastępczym i zachowaj identyfikator własnego stylu na potrzeby późniejszych poprawek. Gdy po raz pierwszy dostosowujesz styl z repozytorium, nadaj mu odrębny tytuł i identyfikator, aby chronić swoje zmiany przed aktualizacjami z repozytorium.

Ten sposób postępowania jest przeznaczony dla użytkowników Zotero na komputerach Mac, którzy mają już własny styl cytowania i chcą zainstalować jego poprawioną wersję bez utraty wprowadzonych zmian w formatowaniu. Kluczowe jest zachowanie zarówno tożsamości stylu, jak i całej jego edytowanej zawartości. Kod instalacyjny Zotero zastępuje istniejący plik stylu; nie scala wcześniejszych zmian w formatowaniu z nowym plikiem. Źródło dotyczące instalacji stylów Zotero

Co powinno pozostać niezmienione podczas zastępowania własnego stylu?

Zdecyduj, czy poprawiasz ten sam własny styl, czy tworzysz osobną alternatywę, zanim zmienisz jego metadane. CSL definiuje identyfikator stylu jako stały, unikatowy identyfikator. Zotero wyraźnie zaleca zmianę tytułu i identyfikatora przy tworzeniu dostosowanej kopii istniejącego stylu, ponieważ zachowanie oryginalnej tożsamości naraża wprowadzone zmiany na zastąpienie przez aktualizacje oryginalnego stylu. Specyfikacja CSL 1.0.2: informacje, Edycja stylów CSL — przewodnik krok po kroku

Twoje zadanie Używana tożsamość Plik do zainstalowania
Pierwsze dostosowanie stylu z repozytorium Odrębny tytuł i identyfikator własnego stylu Cały styl zawierający wprowadzone zmiany
Poprawienie istniejącego własnego stylu Dotychczasowy identyfikator własnego stylu; zachowaj rozpoznawalny tytuł Cały poprawiony własny styl
Osobna wersja eksperymentalna Odrębny tytuł i identyfikator Osobny, kompletny styl
Przyjęcie nowszej wersji stylu z repozytorium Własna tożsamość w gotowym pliku zastępczym Nowsze reguły oraz zmiany własnego stylu, które celowo zachowujesz

Ostatni wiersz potraktuj jako zadanie wymagające ręcznego porównania. Plik zastępczy pobrany z innego źródła nie może zawierać zmian, które istnieją wyłącznie w starszej lokalnej kopii. Zachowaj ten starszy plik, dopóki nie porównasz z nim wyniku pracy nad plikiem zastępczym.

Sama zmiana nazwy pliku nie wystarczy. Obecna implementacja instalacji Zotero wyszukuje istniejący styl według identyfikatora, a dodatkowo sprawdza kolizje nazw plików i tytułów. Nadaj osobnej wersji zarówno odrębny tytuł, jak i identyfikator, a przed kontynuowaniem sprawdź okno dialogowe instalacji. Źródło dotyczące instalacji stylów Zotero

Zapisz właściwe reguły przed przygotowaniem pliku zastępczego

Otwórz działający własny styl i zapisz jego pełną kopię poza edytorem. Praktycznym rozwiązaniem jest plik roboczy o nazwie neutral-notes.csl oraz kopia archiwalna o nazwie neutral-notes-before-revision.csl. Są to jedynie propozycje organizacji plików; tożsamość stylu określa osadzony identyfikator.

Używaj zwykłego tekstu. W TextEdit wybierz Format → Make Plain Text i upewnij się, że zapisana nazwa pliku kończy się na .csl. W przewodniku edycji Zotero zaleca edycję w zwykłym tekście i częste zapisywanie zmian. Edycja stylów CSL — przewodnik krok po kroku

Jeśli zmiany istnieją tylko w Style Editor Zotero, zapisz je, zanim wybierzesz inny styl lub zamkniesz okno. Dokumentacja edytora ostrzega, że każda z tych czynności spowoduje utratę niezapisanych zmian. Dlatego poprawny podgląd jest jedynie wynikiem pośrednim. Edytor stylów Zotero

Sprawdź, czy plik zawiera instrukcje formatowania

Zależny styl CSL jest aliasem: odwołuje się do niezależnego stylu nadrzędnego, którego format cytowań jest używany. Jeśli plik składa się głównie z metadanych i odwołania independent-parent, pobierz styl nadrzędny i użyj go jako podstawy dostosowanej, niezależnej kopii. Zmiana nazwy aliasu nie tworzy miejsca na osobne reguły formatowania. Wprowadzenie — czym jest CSL

W niezależnym stylu sprawdź odpowiednie elementy citation, bibliography i macro. Zawierają one instrukcje renderowania. W przypadku poprawianej wersji własnego stylu zachowaj jego id; w przypadku nowej gałęzi przypisz jej unikatową tożsamość. Obecna stabilna specyfikacja zaleca UUID-y jako nowe identyfikatory stylów, a jednocześnie uwzględnia istniejące identyfikatory oparte na URI. Specyfikacja CSL 1.0.2

Przekształć zmiany w zestaw precyzyjnych oczekiwanych wyników

Zanim cokolwiek zastąpisz, zapisz kilka dokładnych oczekiwanych wyników. Dzięki temu uzyskasz powtarzalną kontrolę, która wykryje brak reguły nawet wtedy, gdy instalacja pliku zastępczego zakończy się pomyślnie. Używaj przykładowych metadanych, aby test był łatwy do sprawdzenia.

Załóżmy na przykład, że własna reguła bibliografii oddziela wydawcę od miejsca wydania przecinkiem i ujmuje całość w nawiasy. Określ następujące kontrole dla segmentu dotyczącego wydawcy w przykładowej książce o tytule Shape Catalogue:

Test Przykładowe metadane Oczekiwany segment wydawcy
Oba pola wypełnione Wydawca: Example Press; miejsce: Sample Town (Example Press, Sample Town)
Tylko wydawca Wydawca: Example Press; miejsce puste (Example Press)
Tylko miejsce Wydawca pusty; miejsce: Sample Town (Sample Town)
Oba pola puste Wydawca i miejsce puste Brak segmentu wydawcy

Poniższy fragment służy do renderowania tego segmentu; nie jest kompletnym stylem gotowym do instalacji. Umieść go we właściwym miejscu w istniejącym układzie bibliografii lub w wywoływanej przez niego makrze. Zastąp nim stary segment wydawcy zamiast dodawać drugi:

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

Grupa dodaje separator i otaczające znaki interpunkcyjne. CSL pomija grupę, gdy wszystkie użyte w niej zmienne są puste. W przewodniku edycji Zotero pokazuje ten wzorzec jako sposób na uniknięcie problemów z interpunkcją w przypadku brakujących pól. Są to oczekiwane wyniki wyprowadzone ze specyfikacji, a nie rezultaty testu na komputerze wykonane w tym miejscu. Specyfikacja CSL 1.0.2: grupa, Edycja stylów CSL — przewodnik krok po kroku

Przygotuj podobne kontrole dla wprowadzanych zmian: separatorów autorów, formatowania tytułów, umiejscowienia dat lub innej konkretnej reguły. Zapisz, czy każda z oczekiwanych zmian dotyczy cytowania w tekście, wpisu bibliografii, czy obu tych elementów. Zachowaj też jeden niezmieniony przykład, aby wychwycić przypadkowe zmiany poza edytowanym segmentem.

Zainstaluj i sprawdź plik zastępczy na komputerze Mac

Otwórz Zotero → Settings, a następnie wybierz Cite. Menu aplikacji to udokumentowana lokalizacja ustawień na Macu. Jak zmienić ustawienia Zotero?

Wykonaj poniższe kroki, aby oddzielić zapisywanie zmian, testowanie i instalację:

  1. Wybierz przykładowe elementy testowe w bibliotece Zotero.
  2. Otwórz Style Editor w sekcji Cite i wczytaj lub wklej cały poprawiony styl.
  3. Kliknij Refresh, aby użyć wybranych elementów, a następnie porównaj podgląd z zestawem oczekiwanych wyników.
  4. Zapisz cały edytowany plik .csl i sprawdź go pod kątem zgodności ze schematem CSL przed instalacją.
  5. W Menedżerze stylów kliknij + i wybierz zapisany plik.
  6. Sprawdź okno dialogowe instalacji, a następnie zainstaluj odpowiednią poprawioną wersję.
  7. Otwórz ponownie zainstalowany styl i powtórz te same kontrole wyników.

Edytor przetwarza wybrane elementy biblioteki i aktualizuje podgląd w miarę edycji. Może zgłaszać nieprawidłowy XML, ale sam podgląd nie potwierdza zgodności z CSL; dokumentacja edytora zaleca sprawdzenie stylu. Instalowanie pliku lokalnego przez + opisano osobno w instrukcjach Zotero dotyczących stylów. Edytor stylów Zotero, Style cytowania

Przy późniejszych poprawkach zacznij od zapisanego własnego pliku CSL, który przeszedł te kontrole. Jeśli zamiast tego zaczniesz od nowszego pliku z repozytorium, porównaj go z archiwalną kopią własnego stylu i przed instalacją świadomie przenieś do niego wymagane reguły.

Dlaczego Word nadal pokazuje stare formatowanie?

Zainstalowanie stylu i wybranie go w dokumencie Worda to osobne czynności. Na karcie Zotero w Wordzie otwórz Document Preferences i wybierz własny styl. Następnie użyj Refresh i sprawdź cytowanie oraz bibliografię. Zotero opisuje Document Preferences jako ustawienie służące do zmiany stylu cytowania w dokumencie. Korzystanie z wtyczki Zotero do Worda

Nie poprawiaj powtarzającej się reguły stylu przez ręczne edytowanie bibliografii w Wordzie. Zotero informuje, że ręczne zmiany bibliografii są nadpisywane podczas odświeżania. Powtarzalne reguły formatowania przechowuj w pliku CSL. Korzystanie z wtyczki Zotero do Worda

Na podstawie miejsca wystąpienia problemu wybierz, co sprawdzić dalej:

Co obserwujesz Co sprawdzić dalej
W zapisanym pliku zastępczym brakuje zmiany Odzyskaj regułę z archiwalnej kopii roboczej
Podgląd w edytorze nie spełnia oczekiwań Sprawdź regułę renderowania i pola elementów testowych
Podgląd spełnia oczekiwania, ale zainstalowany styl nie Potwierdź, który zapisany plik został zainstalowany, a następnie ponownie otwórz ten zainstalowany styl
Podgląd zainstalowanego stylu w Zotero jest poprawny, ale Word pokazuje coś innego Sprawdź styl wybrany w dokumencie i odśwież go
Osobna wersja niespodziewanie zastępuje inny styl Porównaj osadzone identyfikatory i tytuły

Przechowuj razem kompletny roboczy plik CSL, jego stałą tożsamość własnego stylu i niewielki zestaw oczekiwanych wyników. Gdy pojawi się kolejna poprawiona wersja, te trzy rzeczy pozwolą świadomie przenieść reguły i sprawdzić plik zastępczy przed rozpoczęciem korzystania z niego.

Źródła