Bibliografi web interaktif dengan zotero
Contoh instalasi
Situs web lab di Penn State
Situs web pribadi
Dokumentasi
http://zot-bib-web.readthedocs.io/
Penulis/Kontak:
David [email protected] http://www.david-reitter.com
Fitur
Alat ini menghasilkan bibliografi web interaktif berdasarkan satu atau lebih koleksi dalam repositori Zotero. Koleksi dapat dikelola oleh kelompok orang, menggunakan antarmuka web Zotero atau aplikasi desktop mereka.
Bibliografi dapat dipesan dengan koleksi, berdasarkan tahun publikasi, atau berdasarkan jenis publikasi (misalnya, artikel jurnal pertama), dapat dicari secara interaktif, dapat ditautkan ke dokumen PDF atau URL lainnya, memiliki catatan untuk Bibtex, Endnote dan Wikipedia, dan dapat diekspor ke HTML atau didorong ke database Wordes.
ZOT_BIB_WEB tidak bergantung pada server web pihak ketiga mana pun. Bibliografi yang dihasilkan memuat dengan cepat karena disimpan sebagai file statis bersama dengan seluruh situs web Anda. Ini membuat sumber yang baik untuk webcrawler, termasuk Google Cendekia dan Citeseer.
Pengaturan mudah bagi siapa saja yang menjalankan situs web mereka sendiri dan tahu cara menggunakan baris perintah (shell). Cara termudah untuk menggunakannya adalah dengan memanggil zot.py dengan kunci koleksi Zotero publik. Ini akan membuat file zotero-bib.html. Salin ini, bersama dengan direktori "situs" dan "file" (jika ada) ke server web Anda.
Demo
Lihat file HTML di folder demo untuk beberapa contoh bibliografi. File pengaturan masing -masing dan file gaya CSS disertakan.
Berlari:
./zot.py --Settings demo/settings3.py
untuk melihatnya beraksi.
Lisensi dan Donasi
- Gunakan dan memodifikasi perangkat lunak ini secara gratis.
- Tidak ada garansi yang disediakan.
- Silakan kirim email ke [email protected] tautan ke daftar pustaka di situs web Anda jika Anda memutuskan untuk menggunakan Zot_BIB_WEB.
- Anda dapat menggunakan perangkat lunak ini secara gratis.
Persyaratan
Python 2.7 atau 3.6+
Pyzotero. Untuk menginstal Pyzotero, perpustakaan untuk Python:
Sudo Pip Instal Pyzotero
atau:
sudo easy_install pyzotero
Koleksi Zotero dengan bibliografi Anda (sebagai pengguna atau sebagai grup)
Opsional: Paket Dateutils untuk Python (meningkatkan tanggal penguraian jika ada)
Pengaturan
Pastikan zot.py dapat dieksekusi (chmod ug+x zot.py)
Cobalah. Dari baris perintah seperti Unix, lakukan ini:
./zot.py --group 160464 dtdtv2ep
Kemudian lihat zotero-bib.html di browser. Jika itu terlihat bagus, lanjutkan ke langkah selanjutnya untuk konfigurasi.
- Dalam file baru yang disebut settings.py, tambahkan konfigurasi seperti yang didokumentasikan dalam file settings_example.py. Pergi ke zotero.org untuk mendapatkan kunci rahasia API Anda dan ID pengguna atau perpustakaan Anda. Mudah: lihat bagian atas settings.example.py untuk detailnya. Jika settings.py diatur, Anda dapat menghubungi zot.py tanpa argumen.
Atau, Anda dapat menggunakan memberikan pengaturan utama dalam argumen untuk program.
Daftar Pustaka di Zotero
- Dengan Zotero, buat daftar pustaka dan perhatikan ID -nya (misalnya, dari URL di antarmuka web Zotero). Contoh:
MGID90AT . ID ini adalah apa yang Anda butuhkan untuk variabel "toplevelfilter" di settings.py. - Anda dapat menambahkan sub-koleksi ke daftar pustaka Anda.
- Jika Anda memformat oleh koleksi, memberi mereka pesanan mungkin membantu. Anda dapat memberi nama koleksi yang dimulai dengan angka: "10 psikologi sosial".
Berikut adalah contoh struktur bibliografi:
Publikasi saya [mgid90at]
10 Pekerjaan Terpilih
15 dalam persiapan / sedang ditinjau
20 Wasit Works berdasarkan topik
Semantik
Penguraian
Dialog
Pembelajaran Mesin
30 tesis
40 pembicaraan (tanpa kertas)
Untuk melihat ini, gunakan settings.py yang disediakan sebagai contoh.
Gambaran Umum Opsi Konfigurasi
- Konfigurasi berlangsung dalam file Pengaturan, secara default bernama settings.py.
- Hubungi ./zot.py --help untuk melihat daftar opsi baris perintah.
- Silakan merujuk ke dokumentasi untuk informasi pada file Pengaturan, atau baca settings_example.py. Beberapa opsi dibahas sebagai berikut.
- Anda dapat memesan bibliografi kami dengan sub-pengumpulan, berdasarkan tahun, atau berdasarkan jenis publikasi (misalnya, artikel jurnal pertama, lalu makalah konferensi). Bahkan dalam kategori tingkat yang lebih tinggi Anda dapat mengurutkan entri bibliografi Anda sesuai keinginan. Gunakan pengaturan "sort_criteria" dan "show_top_section_headings".
- Anda dapat memilih konvensi pemformatan yang berbeda. Default adalah format APA.
- Di bagian atas, kotak pencarian dan satu set pintasan dapat ditampilkan: misalnya, beberapa tahun atau rentang tahun, jenis publikasi, atau subkoleksi yang menunjukkan bidang topik. Seorang pengunjung dapat mengklik ini untuk dengan cepat memfilter daftar pustaka.
- Konfigurasikan pintasan yang ditampilkan di bagian atas menggunakan variabel show_shortcuts. 'Collection', 'Type', 'Year', 'Venue', 'Venue_short', dan 'Tags' adalah nilai yang didukung, di samping daftar nilai yang lebih halus yang dapat Anda buat menggunakan fungsi shortcut (). Anda dapat memberikan daftar nilai atau rentang (selama bertahun -tahun), pesanan mereka, dan beberapa penyaringan untuk hanya menampilkan yang paling umum. Lihat settings.example.py untuk contoh terperinci.
- Ada beberapa opsi lagi. Sekali lagi, lihat settings_example.py.
Penempatan ke situs web
- Unggah folder situs atau isinya ke tempat umum di server web Anda. Secara default, /situs /... adalah URL yang diasumsikan.
Untuk menghasilkan HTML dan memasukkannya ke dalam situs web:
- Jalankan zot.py sekali/sesuai permintaan, atau instal sebagai pekerjaan atau layanan cron di server tidak menjalankannya lebih dari sekali sehari. Konfigurasikannya secara langsung di zot.py, atau di pengaturan file yang terpisah.py untuk membuat peningkatan menjadi sederhana.
- Sertakan file yang dihasilkan zotero-bib.html (atau seperti yang dikonfigurasi) di situs web Anda sesuai keinginan Anda. Anda juga dapat memasukkan file koleksi individual, yang juga dihasilkan. Anda dapat mengonfigurasi zot.py untuk menghasilkan dokumen HTML lengkap, atau hanya sebagian dari itu. Zot_bib_web menghasilkan konten html5.
- Gaya bibliografi Anda menggunakan CSS. File gaya contoh disertakan (lihat Situs/ Direktori).
Dukungan WordPress
Paket ini dapat mendorong langsung ke situs WordPress. Program terpisah "push.py" termasuk untuk melakukan ini.
Ikuti langkah -langkah ini:
- Siapkan zot.py untuk menghasilkan daftar pustaka yang Anda sukai. Hubungi zot.py --full untuk menghasilkan file Zotero-bib.html lengkap untuk tujuan debugging. Konfigurasikan settings.py untuk tidak menghasilkan kode HTML lengkap.
- Pasang plugin WPAutop-Control (atau plugin serupa) untuk memastikan bahwa WP tidak akan memasukkan istirahat paragraf di berbagai tempat dalam daftar pustaka. Dengan plugin ini, Anda perlu menambahkan "bidang khusus" ke halaman yang dibuat pada langkah berikutnya (pilih "Opsi Layar" di bagian atas tampilan halaman, aktifkan bidang khusus. Kemudian temukan bidang khusus di bagian paling bawah halaman dan tambahkan bidang "WPAutop" dengan nilai "No".
- Buat halaman WP atau posting untuk daftar pustaka. Sisipkan [zot_bib_web collection] di mana Anda ingin bibliografi dimasukkan. Ganti koleksi dengan ID koleksi. (Lebih banyak opsi: lihat push.py)
- Salin konten Lembar Gaya (di Situs/) ke tema WordPress Anda (pilih "Editor", atau "CSS tambahan").
- Konfigurasikan settings.py sehingga jQuery dan file lain tersedia di server web. Biasanya, ini akan menjadi jQuery_path = "../wp-includes/js/jquery/jquery.js" clipboard.js dan clippy.svg: Anda dapat merujuk ke URL publik atau melayani file sendiri.
- Konfigurasikan push.py (di atas). Anda perlu mengetahui beberapa detail sederhana tentang instalasi WP Anda.
- Jalankan push.py secara teratur atau sesuai permintaan. Ini akan menghubungi zot.py secara otomatis dan kemudian memperbarui halaman di WP.
