Untuk mempertahankan aturan CSL Zotero yang telah diedit, simpan aturan tersebut dalam file pengganti dan pertahankan ID gaya kustom Anda untuk revisi berikutnya. Saat pertama kali menyesuaikan gaya dari repositori, berikan judul dan ID yang berbeda agar perubahan Anda terlindung dari pembaruan upstream.
Alur kerja ini ditujukan bagi pengguna desktop Mac yang sudah memiliki gaya sitasi kustom dan ingin memasang versi revisi tanpa kehilangan keputusan pemformatannya. Kuncinya adalah mempertahankan identitas gaya dan seluruh isinya yang telah diedit. Kode instalasi Zotero mengganti file gaya yang sudah ada; kode tersebut tidak menggabungkan edit pemformatan sebelumnya ke dalam file yang masuk. Sumber instalasi gaya Zotero
Apa yang harus tetap sama saat Anda mengganti gaya kustom?
Sebelum mengedit metadatanya, tentukan apakah Anda sedang merevisi gaya kustom yang sama atau membuat alternatif terpisah. CSL menetapkan ID gaya sebagai pengenal unik yang stabil. Zotero secara tegas menyarankan untuk mengubah judul dan ID saat membuat salinan kustom dari gaya yang sudah ada, karena mempertahankan identitas asli membuat edit tersebut rentan terhadap pembaruan gaya asli. Spesifikasi CSL 1.0.2: Info, Mengedit Gaya CSL — Panduan Langkah demi Langkah
| Tugas Anda | Identitas yang digunakan | Isi file yang dipasang |
|---|---|---|
| Kustomisasi pertama gaya dari repositori | Judul dan ID kustom yang berbeda | Gaya lengkap dengan edit Anda |
| Revisi gaya kustom yang sudah ada | ID kustom yang sudah ada; pertahankan judulnya yang mudah dikenali | Gaya kustom lengkap yang telah direvisi |
| Alternatif eksperimental terpisah | Judul dan ID yang berbeda | Gaya lengkap yang terpisah |
| Mengadopsi versi upstream yang lebih baru | Identitas kustom Anda dalam file pengganti akhir | Aturan yang lebih baru ditambah edit kustom yang sengaja Anda pertahankan |
Anggap baris terakhir sebagai tugas perbandingan manual. Pengganti yang diunduh dari tempat lain tidak mungkin memuat edit yang hanya ada di salinan lokal Anda yang lebih lama. Simpan file lama itu sampai Anda selesai membandingkan hasil penggantinya.
Mengubah nama file saja tidak cukup. Implementasi instalasi Zotero saat ini memeriksa gaya yang sudah ada berdasarkan ID, serta memeriksa bentrokan nama file dan judul. Berikan judul dan ID yang berbeda untuk varian terpisah, lalu periksa dialog instalasi sebelum melanjutkan. Sumber instalasi gaya Zotero
Simpan aturan sebenarnya sebelum menyiapkan pengganti
Buka gaya kustom yang Anda tahu berfungsi, lalu simpan salinan lengkapnya di luar editor. Pengaturan yang praktis adalah satu file kerja bernama neutral-notes.csl dan salinan arsip bernama neutral-notes-before-revision.csl. Nama file ini hanya saran pengelolaan; ID yang tertanam menentukan identitas gaya.
Gunakan teks biasa. Di TextEdit, pilih Format → Jadikan Teks Biasa, dan pastikan nama file yang disimpan berakhiran .csl. Panduan pengeditan Zotero menyarankan pengeditan teks biasa dan menyimpan sesering mungkin. Mengedit Gaya CSL — Panduan Langkah demi Langkah
Jika perubahan Anda hanya ada di Style Editor Zotero, simpan sebelum memilih gaya lain atau menutup jendela. Dokumentasi editor memperingatkan bahwa kedua tindakan tersebut akan menghilangkan edit yang belum disimpan. Karena itu, pratinjau yang benar hanyalah hasil antara. Editor Gaya Zotero
Periksa apakah file berisi instruksi pemformatan
Gaya CSL dependen adalah alias: gaya ini merujuk ke gaya induk independen yang format sitasinya digunakan. Jika file Anda sebagian besar hanya terdiri dari metadata dan tautan independent-parent, dapatkan gaya induknya sebagai titik awal untuk salinan independen yang Anda kustomisasi. Mengganti nama alias tidak menyediakan tempat untuk aturan pemformatan terpisah. Pengantar — Pengenalan CSL
Pada gaya independen, periksa elemen citation, bibliography, dan macro yang relevan. Elemen-elemen tersebut memuat instruksi perenderan. Untuk revisi kustom yang sudah ada, pertahankan id-nya; untuk fork baru, tetapkan identitas yang unik. Spesifikasi stabil saat ini merekomendasikan UUID untuk ID gaya baru, sembari tetap mengakui ID berbasis URI yang sudah ada. Spesifikasi CSL 1.0.2
Ubah edit Anda menjadi kontrak perenderan singkat
Sebelum mengganti apa pun, catat beberapa hasil yang diharapkan secara tepat. Ini memberi Anda pemeriksaan yang dapat diulang untuk mendeteksi aturan yang hilang, sekalipun penggantinya berhasil dipasang. Gunakan metadata karya sintetis agar pengujiannya mudah diperiksa.
Misalnya, aturan bibliografi kustom Anda memisahkan penerbit dan lokasinya dengan koma, lalu mengapit hasilnya dengan tanda kurung. Tetapkan pemeriksaan berikut untuk bagian penerbit dari buku sintetis berjudul Katalog Bentuk:
| Pengujian | Metadata sintetis | Bagian penerbit yang diharapkan |
|---|---|---|
| Kedua bidang terisi | Penerbit: Example Press; tempat: Sample Town |
(Example Press, Sample Town) |
| Hanya penerbit | Penerbit: Example Press; tempat kosong |
(Example Press) |
| Hanya tempat | Penerbit kosong; tempat: Sample Town |
(Sample Town) |
| Kedua bidang kosong | Penerbit dan tempat kosong | Tidak ada bagian penerbit |
Berikut ini adalah fragmen perenderan untuk bagian tersebut, bukan gaya lengkap yang dapat dipasang. Fragmen ini ditempatkan pada posisi perenderan yang sesuai di dalam tata letak bibliografi Anda yang sudah ada atau makro yang dipanggil olehnya. Ganti bagian penerbit lama, jangan menambahkan salinan kedua:
<group delimiter=", " prefix="(" suffix=")">
<text variable="publisher"/>
<text variable="publisher-place"/>
</group>
Grup tersebut menyediakan pemisah dan tanda baca yang mengapitnya. CSL menyembunyikan grup jika semua variabel yang dirujuknya kosong. Panduan pengeditan Zotero menggunakan pola ini untuk menghindari masalah tanda baca saat suatu bidang kosong. Hasil-hasil ini merupakan ekspektasi yang diturunkan dari spesifikasi, bukan hasil pengujian desktop yang dilakukan di sini. Spesifikasi CSL 1.0.2: Group, Mengedit Gaya CSL — Panduan Langkah demi Langkah
Buat pemeriksaan serupa untuk perubahan Anda yang sebenarnya: pemisah nama penulis, pemformatan judul, penempatan tanggal, atau aturan spesifik lainnya. Catat apakah setiap ekspektasi berlaku untuk sitasi dalam teks, entri bibliografi, atau keduanya. Pertahankan juga satu contoh yang tidak diubah untuk mendeteksi perubahan tak disengaja di luar bagian yang diedit.
Pasang dan verifikasi pengganti di Mac Anda
Buka Zotero → Pengaturan, lalu pilih Cite. Menu aplikasi adalah lokasi pengaturan yang didokumentasikan di Mac. Bagaimana cara mengubah pengaturan Zotero?
Gunakan urutan ini agar penyimpanan, pengujian, dan instalasi tetap menjadi langkah yang terpisah:
- Pilih item pengujian sintetis di pustaka Zotero.
- Buka
Style EditordariCite, lalu muat atau tempel gaya lengkap yang telah direvisi. - Klik
Refreshuntuk menggunakan item yang dipilih, lalu bandingkan pratinjau dengan kontrak perenderan Anda. - Simpan file
.csllengkap yang telah diedit dan validasi file tersebut terhadap skema CSL sebelum pemasangan. - Di Style Manager, klik
+, lalu pilih file yang disimpan itu. - Periksa dialog instalasi, lalu pasang revisi yang dimaksud.
- Buka kembali gaya yang terpasang dan ulangi pemeriksaan hasil yang sama.
Editor memproses item pustaka yang dipilih dan memperbarui pratinjaunya saat Anda mengedit. Editor dapat melaporkan XML yang tidak valid, tetapi pratinjau saja tidak membuktikan bahwa CSL valid; dokumentasinya mengarahkan Anda untuk memvalidasi gaya tersebut. Petunjuk gaya Zotero mendokumentasikan pemasangan file lokal melalui + secara terpisah. Editor Gaya Zotero, Gaya Sitasi
Untuk revisi berikutnya, mulailah dari file kustom yang tersimpan dan lolos pemeriksaan ini. Jika Anda memilih file upstream yang lebih baru, bandingkan dengan salinan kustom yang diarsipkan dan terapkan kembali aturan yang diperlukan dengan sengaja sebelum memasangnya.
Mengapa Word masih menampilkan pemformatan lama?
Memasang gaya dan memilihnya untuk dokumen Word adalah dua langkah terpisah. Di tab Zotero Word, buka Document Preferences dan pilih gaya kustom Anda. Kemudian gunakan Refresh dan periksa sitasi serta bibliografinya. Zotero mendokumentasikan Document Preferences sebagai kontrol untuk mengubah gaya sitasi dokumen. Menggunakan Plugin Zotero untuk Word
Hindari memperbaiki aturan gaya yang berulang dengan mengetik di atas bibliografi di Word. Zotero mendokumentasikan bahwa edit bibliografi manual akan tertimpa saat penyegaran. Simpan aturan pemformatan yang berulang di file CSL. Menggunakan Plugin Zotero untuk Word
Gunakan lokasi kegagalan untuk menentukan pemeriksaan berikutnya:
| Yang Anda amati | Hal yang perlu diperiksa selanjutnya |
|---|---|
| File pengganti yang tersimpan tidak memuat edit Anda | Pulihkan aturan dari salinan kerja yang diarsipkan |
| Pratinjau editor tidak sesuai dengan kontrak Anda | Periksa aturan perenderan dan bidang item pengujian |
| Pratinjau sesuai, tetapi gaya yang terpasang tidak | Pastikan file tersimpan mana yang Anda pasang, lalu buka kembali gaya terpasang tersebut |
| Pratinjau gaya terpasang di Zotero sesuai, tetapi Word berbeda | Periksa gaya yang dipilih untuk dokumen dan segarkan dokumen tersebut |
| Varian terpisah tanpa sengaja mengganti gaya lain | Bandingkan ID dan judul yang tertanam di dalamnya |
Simpan file CSL kerja yang lengkap, identitas kustomnya yang stabil, dan kumpulan kecil hasil yang diharapkan bersama-sama. Saat revisi berikutnya tiba, ketiga hal itu membantu Anda meneruskan aturan dengan sengaja dan memverifikasi penggantinya sebelum mengandalkannya.
Sumber
- Mengedit Gaya CSL — Panduan Langkah demi Langkah — Zotero.
- Gaya Sitasi — Zotero.
- Editor Gaya Zotero — Zotero.
- Bagaimana cara mengubah pengaturan Zotero? — Zotero.
- Menggunakan Plugin Zotero untuk Word — Zotero.
- Spesifikasi CSL 1.0.2 — Citation Style Language.
- Pengantar — Pengenalan CSL — Citation Style Language.
- Sumber instalasi gaya Zotero: style.js — Zotero.