notero

Catatan

Notero adalah plugin Zotero untuk menyinkronkan item dan catatan ke dalam Notion. Untuk menggunakannya:

1. ? Konfigurasikan basis data Notion Anda.
2. ? Instal plugin Notero ke Zotero.
3. ? Pilih koleksi Zotero Anda untuk dipantau.
4. Tambahkan atau perbarui item di koleksi Anda.
5. Tonton item Anda disinkronkan ke Notion!

Konsep oleh @arhoff ??‍? | Dibangun dengan? oleh @dvanoni

Daftar isi

• Mengapa Menggunakan Notero?
• Bagaimana Notero Bekerja
• Instalasi dan Pengaturan
• Panduan Penggunaan
• Pertanyaan yang Sering Diajukan
• Contoh Database Gagasan
• Perkembangan

Mengapa Menggunakan Notero?

• Integrasikan manajer referensi Anda, daftar tugas, catatan bacaan, tabel analitis, dan draf di satu lokasi.
• Tautkan ke referensi dengan mudah saat menulis di Notion.
• Buat tampilan khusus untuk memfilter dan mengurutkan daftar referensi besar berdasarkan proyek, tag, penulis, dll.
• Tautan balik memudahkan untuk menemukan catatan dan draf mana pun yang menyebutkan referensi.
• Tautkan referensi ke entri di database lain, seperti proyek, tugas, manuskrip di saluran publikasi Anda, outlet penerbitan, dll.

Bagaimana Notero Bekerja

Plugin Notero mengawasi item Zotero yang ditambahkan atau dimodifikasi dalam koleksi apa pun yang Anda tentukan di preferensi Notero. Setiap kali item ditambahkan atau diubah, Notero melakukan beberapa hal:

• Simpan halaman dengan properti item Zotero (judul, penulis, dll.) ke dalam database Notion yang ditentukan dalam preferensi Notero.
• Tambahkan tag notion ke item Zotero.
• Tambahkan lampiran ke item Zotero yang tertaut ke halaman di Notion.

Selain menyediakan cara mudah untuk membuka halaman Notion dari Zotero, lampiran link juga berfungsi sebagai referensi untuk Notero sehingga dapat memperbarui halaman Notion yang sesuai untuk item Zotero tertentu.

Menyinkronkan Item

Secara default, Notero akan menyinkronkan item dalam koleksi Anda yang dipantau setiap kali item tersebut diubah. Anda dapat menonaktifkan fungsi ini dengan menghapus centang pada opsi Sinkronkan ketika item diubah di preferensi Notero.

Anda juga dapat menyinkronkan item dari menu konteks koleksi atau item (klik kanan):

• Untuk menyinkronkan semua item dalam koleksi, buka menu konteks koleksi dan pilih Sinkronkan Item ke Notion .
• Untuk menyinkronkan satu item atau beberapa item, pilih item di panel utama, buka menu konteks, dan pilih Sinkronkan ke Notion .

Catatan

Untuk mencegah fungsionalitas "sinkronisasi saat modifikasi" disimpan ke Notion beberapa kali, Notero tidak memberi tahu Zotero ketika lampiran tag dan tautan ditambahkan ke item. Ini berarti item tersebut mungkin tidak langsung muncul di Zotero, dan Anda mungkin perlu menavigasi ke item lain dan kembali lagi untuk menampilkannya.

Menyinkronkan Catatan dan Anotasi PDF

Catatan Zotero yang terkait dengan suatu item dapat disinkronkan ke Notion sebagai konten halaman terkait untuk item tersebut. Seperti item biasa, Anda dapat menyinkronkan catatan secara manual menggunakan opsi Sinkronkan ke Notion di menu konteks.

Sinkronisasi catatan secara otomatis dapat diaktifkan melalui opsi Sinkronkan catatan di preferensi Notero. Jika diaktifkan, catatan akan otomatis disinkronkan setiap kali diubah. Selain itu, ketika item biasa disinkronkan, semua catatannya juga akan disinkronkan jika belum disinkronkan.

Untuk menyinkronkan anotasi (catatan dan sorotan) dari PDF, Anda harus mengekstraknya terlebih dahulu ke dalam catatan Zotero:

1. Pilih item atau PDF, buka menu konteks, dan pilih Tambahkan Catatan dari Anotasi .
2. Jika diinginkan, aktifkan warna sorotan dari menu di kanan atas panel catatan.

Contoh membuat catatan dari anotasi PDF

CleanShot.26-07-2023.at.20.41.32-converted.mp4

Instalasi dan Pengaturan

Menggunakan Notero memerlukan pengaturan database Notion, menghubungkannya ke Notero, dan menginstal plugin Notero di Zotero. Petunjuk pengaturan terperinci ada di bawah.

Konfigurasikan Gagasan

1. Buat database Notion tempat Anda ingin menyinkronkan item Zotero.

   Lihat contoh di bawah yang dapat Anda duplikasi ke ruang kerja Notion Anda.

2. Buat integrasi internal Notion di https://www.notion.com/my-integrations dan aktifkan semua "kemampuan konten".

   Contoh pengaturan kemampuan integrasi

   

3. Catat "rahasia integrasi internal" dari langkah sebelumnya.

4. Berikan integrasi Anda akses ke database Anda.

   Dari dokumen pengembang Notion:

   1. Buka halaman database di ruang kerja Anda.
   2. Klik menu ••• Lainnya di pojok kanan atas halaman.
   3. Gulir ke bawah dan klik Hubungkan ke .
   4. Cari dan pilih integrasi Anda di menu Cari koneksi....

   Contoh pengaturan koneksi dari dokumentasi Notion

5. Konfigurasikan properti database sesuai keinginan. Lihat bagian properti database di bawah untuk lebih jelasnya.

Properti Basis Data Gagasan

Notero dapat menyinkronkan data untuk properti yang tercantum di bawah. Satu-satunya properti yang diperlukan oleh Notero adalah properti dengan tipe properti Judul . Properti lainnya bersifat opsional, jadi Anda hanya dapat menggunakan properti yang sesuai dengan kebutuhan Anda.

Properti Judul dapat diberi nama selain Name selama tidak bertentangan dengan nama properti lainnya. Nama dan tipe properti lainnya harus dikonfigurasi persis seperti yang ditentukan di sini. Perhatikan bahwa nama properti peka huruf besar-kecil, jadi kapitalisasinya harus sama persis.

Dukungan untuk menyesuaikan properti direncanakan untuk masa depan; lihat edisi #355.

Nama Properti	Tipe Properti	Catatan
Name	Judul	Format dapat dikonfigurasi melalui opsi Judul Halaman Gagasan di preferensi Notero
Abstract	Teks
Authors	Teks
Citation Key	Teks	Membutuhkan BibTeX yang Lebih Baik
Collections	Multi-pilih
Date	Teks
Date Added	Tanggal
Date Modified	Tanggal
DOI	URL
Editors	Teks
Extra	Teks
File Path	Teks
Full Citation	Teks	Format berdasarkan pengaturan Zotero untuk Ekspor → Salin Cepat → Format Item
In-Text Citation	Teks	Format berdasarkan pengaturan Zotero untuk Ekspor → Salin Cepat → Format Item
Item Type	Memilih
Place	Teks
Proceedings Title	Teks
Publication	Teks
Series Title	Teks
Short Title	Teks
Tags	Multi-pilih
Title	Teks
URL	URL
Year	Nomor
Zotero URI	URL	Membuka item di perpustakaan web jika masuk ke Zotero

Instal dan Konfigurasi Plugin Notero

Penting

• Rilis terbaru Notero memerlukan Zotero 7.0 atau lebih tinggi.
• Dukungan untuk Zotero 6.0.27 dan yang lebih baru tersedia di Notero v0.5.17.
• Lihat log perubahan untuk semua catatan rilis.

1. Unduh rilis terbaru file .xpi .
   • Catatan untuk pengguna Firefox: Anda harus mengeklik kanan tautan unduh di atas dan memilih Simpan Tautan Sebagai... untuk mengunduh berkas dengan benar.
   • Jika link download di atas tidak berfungsi, Anda dapat mendownload file .xpi dari bagian Aset pada halaman rilis terbaru.
2. Buka Zotero Plugins Manager melalui item menu Tools → Plugins .
3. Instal file .xpi dengan:
   • menyeret dan melepaskannya ke jendela Plugins Manager atau
   • memilihnya menggunakan opsi Instal Plugin Dari File... di menu roda gigi di sudut kanan atas jendela
4. Buka preferensi Notero dari item menu Alat → Preferensi Notero... , dan masukkan preferensi yang diperlukan.
   • Catatan untuk pengguna Zotero 7: Preferensi Notero telah dipindahkan ke bagian di jendela preferensi utama Zotero.

Panduan Penggunaan

Untuk panduan visual lebih lanjut tentang pengaturan dan penggunaan Notero, lihat sumber daya berikut yang dibuat oleh anggota komunitas yang luar biasa:

• Menggunakan Notion dan Zotero untuk membuat pelacak literatur (postingan blog) oleh Jewel Johnson
• Cara Menyinkronkan Zotero → Gagasan // Alur Kerja Makalah Penelitian (Tutorial 2023) (video) oleh Holly Jane
• Pencatatan cerdas dengan memulai dengan mengintegrasikan Zotero dan Notion: Langkah pertama (video) oleh Dr. Jingjing Lin

Jika Anda ingin berbagi cara Anda menggunakan Notero dan ingin dicantumkan di sini, silakan kirimkan PR atau hubungi saya!

Pertanyaan yang Sering Diajukan

Cara menyinkronkan dari Notion kembali ke Zotero

Meskipun ini bagus, sayangnya hal ini berada di luar cakupan plugin ini. Mendapatkan pembaruan dari Notion ke Zotero memerlukan pengaturan layanan yang dihosting yang berlangganan webhook dari Notion dan kemudian menggunakan API Zotero untuk memperbarui item di Zotero. Notion belum merilis dukungan webhook resmi, tetapi ada beberapa alat pihak ketiga yang dapat digunakan untuk ini. Secara teori, hal ini secara teknis mungkin dilakukan, tetapi ini akan menjadi proyek terpisah.

Cara menyinkronkan file terlampir ke Notion

Saat ini tidak ada cara yang baik untuk menyinkronkan file atau menautkan ke file lokal karena keterbatasan Notion berikut:

• Notion API saat ini tidak mendukung pengunggahan file.
• Notion hanya mendukung URL http: dan https: jadi tidak mungkin untuk menautkan langsung ke file menggunakan file: URL.

Untuk saat ini, solusi terbaik adalah:

• Gunakan properti File Path untuk mengarahkan Anda ke lokasi file lokal.
• Jika Anda menyinkronkan file ke akun Zotero Anda, Anda dapat membuka antarmuka web Zotero dari properti Zotero URI dan kemudian membuka file dari sana.

Cara menyinkronkan item yang ada secara massal

Untuk menyinkronkan beberapa item yang sudah ada dalam koleksi yang dipantau, Anda dapat melakukannya dari menu konteks koleksi atau item. Lihat bagian Menyinkronkan Item di atas.

Cara memperbaiki kesalahan Notion API

Tidak dapat menemukan basis data

Jika Anda menerima kesalahan berikut:

APIResponseError: Tidak dapat menemukan database dengan ID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Ini kemungkinan besar berarti Anda belum memberikan Notero akses ke database Notion Anda. Pastikan Anda mengikuti semua langkah dari bagian Konfigurasi Gagasan. Mengklik tombol ••• di sudut kanan atas database Anda akan menampilkan koneksi untuk integrasi yang Anda buat untuk Notero.

Contoh pengaturan koneksi

Tidak dapat memperbarui halaman yang diarsipkan

Jika Anda menerima kesalahan berikut:

APIResponseError: Tidak dapat memperbarui halaman yang diarsipkan. Anda harus membatalkan pengarsipan halaman sebelum memperbarui.

Hal ini dapat terjadi ketika Notero mencoba menyinkronkan item yang sudah memiliki halaman Notion yang dibuat dari sinkronisasi sebelumnya, namun halaman tersebut telah dihapus. (Perhatikan bahwa menghapus halaman Notion akan memindahkannya ke tempat sampah, dan Notion API menyebutnya sebagai "diarsipkan".)

Seperti dijelaskan di bagian Cara Kerja Notero, Notero mengaitkan item Zotero dengan halaman Notion melalui tautan bernama Notion yang dilampirkan pada item tersebut. Untuk mengatasi masalah ini, hapus lampiran tautan ini pada item yang melanggar lalu lakukan sinkronisasi lagi.

Bukan properti yang ada

Jika Anda menerima kesalahan berikut:

APIResponseError: properti bukanlah properti yang ada

Hal ini dapat terjadi jika sebelumnya Anda menyinkronkan item ke dalam satu database Notion dan kemudian mengubah preferensi Notero Anda untuk menentukan database yang berbeda. Notero mungkin mencoba memperbarui halaman di database lama alih-alih membuat halaman di database baru, dan kesalahan ini bisa terjadi jika properti berbeda dikonfigurasi di database berbeda.

Untuk mengatasinya, Anda harus menghapus database lama di Notion dan kemudian menghapusnya secara permanen dari Sampah di Notion.

Contoh Database Gagasan

Kami memberikan beberapa contoh database Notion yang telah dikonfigurasi dengan semua properti yang disinkronkan oleh Notero.

Setelah Anda membuka salah satu contoh, klik tombol Duplikat di sudut kanan atas halaman untuk menduplikasinya ke ruang kerja Notion Anda.

Contoh Dasar

Database kosong yang hanya berisi properti yang disinkronkan oleh Notero. Berguna jika Anda ingin memulai dari awal dan menyesuaikannya sendiri.

Contoh Lanjutan

Basis data dengan banyak tampilan dan beberapa entri sampel. Lihat di bawah untuk penjelasan tentang bagaimana Anda dapat menggunakan tampilan yang berbeda.

Tampilan Tabel Info Bibliografi

• Tampilan tabel memungkinkan pengeditan entri dengan mudah.
• Navigasikan dengan mudah ke sumber asli dengan mengklik properti DOI atau URL .
  • DOI untuk buku mungkin perlu disalin & ditempel secara manual dari kolom Extra di Zotero.
• Klik pada properti Zotero URI untuk melihat/mengedit entri di Zotero atau mengekspor entri bibliografi dalam gaya kutipan yang berbeda.

Tampilan Papan Status Membaca

• Pantau terus referensi-referensi menjanjikan yang perlu Anda temukan, buku-buku dan artikel-artikel yang Anda minta melalui peminjaman antar perpustakaan, dan karya-karya yang cukup relevan sehingga memerlukan catatan mendalam atau menulis memo.

Tampilan Tabel Tinjauan Pustaka

• Analisis dan bandingkan dengan cepat atribut literatur yang Anda ulas (misalnya, kerangka teoritis, sampel, metode yang digunakan, temuan utama, dll.)
• Tautkan dengan mudah ke karya lain menggunakan properti Related References (misalnya, artikel dalam terbitan khusus yang sama, bab buku dalam buku yang sama yang telah diedit, kajian dan komentar yang merespons atau memperluas karya lain).

Tampilan Galeri Buku

• Tambahkan gambar sampul (misal, klik kanan → salin alamat gambar dari Amazon).
• Pantau buku mana yang Anda miliki, pinjam, dan pinjamkan kepada orang lain.
  • Tambahkan tanggal jatuh tempo dan pengingat untuk buku perpustakaan dan pinjaman antar perpustakaan.

Perkembangan

Notero dibuat dengan generator-zotero-plugin dan menggunakan skrip build yang sangat terinspirasi oleh zotero-plugin. Terima kasih banyak kepada @retorquere karena telah membuat ini.

Pengaturan Lokal

Langkah-langkah di bawah ini didasarkan pada dokumentasi Pengembangan Plugin Zotero dan memungkinkan Anda membuat dan menjalankan Notero sendiri.

1. Untuk menghindari potensi kerusakan pada profil default Zotero Anda, Anda dapat membuat profil baru untuk tujuan pengembangan.

2. Buat file bernama zotero.config.json yang berisi opsi konfigurasi yang digunakan untuk memulai Zotero. Lihat zotero.config.example.json untuk contoh file yang berisi deskripsi semua opsi konfigurasi yang tersedia.

3. Instal dependensi:

    npm ci
   

4. Bangun Notero dan mulai Zotero dengan plugin terpasang:

    npm start
   

   Alternatifnya, Anda dapat memulai Zotero versi beta yang Anda inginkan:

    npm run start-beta
   

   Skrip start melakukan sejumlah langkah:

   1. Jalankan npm run build untuk membangun plugin ke dalam direktori build .

   2. Jika ditentukan, jalankan perintah scripts.prestart yang ditentukan di zotero.config.json .

   3. Tulis file yang berisi path absolut ke direktori build ke dalam direktori extensions di direktori profil Zotero.

   4. Hapus baris extensions.lastAppBuildId dan extensions.lastAppVersion dari prefs.js di direktori profil Zotero.

   5. Mulai Zotero dengan profil yang ditentukan di zotero.config.json dan argumen baris perintah berikut:

       -purgecaches -ZoteroDebugText -jsdebugger -datadir profile
      

   6. Jika ditentukan, jalankan perintah scripts.poststart yang ditentukan dalam zotero.config.json , dengan menyediakan variabel lingkungan ZOTERO_PID .

Merilis Versi Baru

Rilis dilakukan melalui GitHub Actions. Alur kerja release mendefinisikan pekerjaan berikut:

release-please

Pekerjaan ini menggunakan tindakan rilis-mohon untuk membuat PR rilis ketika komitmen baru yang dihadapi pengguna didorong ke cabang main . PR rilis akan mengubah versi paket dan memperbarui log perubahan. Ketika PR digabungkan, pekerjaan ini kemudian membuat tag versi baru dan rilis GitHub.

publish-artifacts

Pekerjaan ini berjalan ketika rilis baru dibuat oleh pekerjaan release-please . Itu membangun file .xpi dan menerbitkannya ke rilis. Itu juga menghasilkan file manifes yang diperbarui dan menerbitkannya ke rilis release .