Sioyek, penampil PDF yang dikhususkan untuk buku teks dan makalah riset

 (github.com/ahrm)
1 poin oleh GN⁺ 2024-05-11 | 1 komentar | Bagikan ke WhatsApp
  • Sioyek adalah penampil PDF yang berfokus pada membaca buku teks dan makalah riset, dengan fitur untuk cepat menemukan berkas yang pernah dibuka sebelumnya dan berpindah di dalam struktur makalah
  • Bahkan pada PDF yang tidak memiliki tautan, Sioyek dapat melompat ke gambar dan entri referensi, serta mendukung tindakan untuk mencari nama referensi di Google Scholar atau Libgen
  • Dirancang terutama dengan fitur navigasi yang dibutuhkan saat membaca dokumen panjang, seperti pencarian daftar isi, ikhtisar cepat, mark, bookmark, dan pencarian highlight
  • Pengguna beberapa monitor dapat memakai Portals untuk menghubungkan posisi teks utama dengan posisi gambar, lalu secara otomatis melihat tujuan portal terdekat di jendela terpisah
  • Tersedia installer resmi untuk Windows, macOS, dan Linux, serta Homebrew Cask dan paket pihak ketiga untuk berbagai distribusi Linux; build dari branch pengembangan memerlukan Qt 6.7 atau 6.8

Gambaran proyek

Jalur instalasi

Fitur navigasi dokumen

  • Quick Open memungkinkan pengguna mencari dan membuka dengan cepat berkas yang sebelumnya pernah berinteraksi dengan Sioyek
  • Fitur Table of Contents memungkinkan pengguna mencari item daftar isi dan berpindah ke posisi tersebut
  • Smart Jump memungkinkan pengguna berpindah ke gambar yang dirujuk atau entri referensi meskipun berkas PDF tidak menyediakan tautan
    • Dengan mengeklik tengah atau Shift+klik tengah pada nama entri referensi, pengguna dapat mencarinya di Google Scholar atau Libgen
  • Overview memungkinkan pengguna membuka gambar, referensi, tabel, dan lainnya sebagai ikhtisar cepat dengan klik kanan
    • Seperti Smart Jump, fitur ini tetap berfungsi meskipun dokumen tidak menyediakan tautan

Fitur bantu untuk membaca dokumen panjang

  • Mark memungkinkan pengguna menyimpan lokasi bernama di dalam PDF dan kembali dengan cepat ke lokasi tersebut menggunakan namanya di kemudian hari
    • Setiap mark memiliki nama satu karakter seperti a atau m
    • Mark huruf kecil bersifat lokal untuk dokumen, sedangkan mark huruf besar bersifat global
    • Cara kerjanya familier bagi pengguna yang pernah memakai Vim
  • Bookmarks mirip dengan mark, tetapi menggunakan nama berupa string teks dan semuanya bersifat global
  • Highlights memungkinkan pengguna menandai teks dengan beberapa jenis highlight dan mencari semua highlight
  • Portals memungkinkan pengguna menghubungkan paragraf saat ini dengan lokasi yang jauh, seperti gambar
    • Menampilkan tujuan portal terdekat di jendela terpisah
    • Jendela ini biasanya ditempatkan di monitor kedua
    • Saat pengguna menavigasi dokumen, jendela tersebut otomatis diperbarui ke tujuan portal terdekat

Konfigurasi dan build

  • Configuration memungkinkan pengguna menyesuaikan semua key binding dan sebagian elemen UI dengan mengedit keys_user.config dan prefs_user.config
    • Pengaturan default ada di keys.config dan prefs.config
  • Jika terjadi error build Qt 5.* saat membuild branch pengembangan, pengguna harus memakai Qt 6.7 atau 6.8
  • Jika di macOS muncul pesan "sioyek is damaged and cannot be opened. It is recommended to eject the image.", itu adalah masalah terkait quarantine macOS, dan diskusi terkait telah diarahkan
  • Build Linux menyediakan perintah untuk Fedora dan prosedur untuk distribusi umum
    • Termasuk prosedur yang diuji pada Fedora Workstation 36
    • Prosedur distribusi umum mengarahkan pengguna untuk menginstal Qt 5, qmake, dan libharfbuzz, lalu menjalankan ./build_linux.sh
  • Build Windows telah diuji pada Visual Studio 2019, dan versi yang relatif baru juga mungkin dapat berfungsi
    • Setelah menyiapkan Qt 5 dan qmake, jalankan build_windows.bat dari 64-bit Visual Studio Developer Command Prompt
  • Build Mac mengarahkan pengguna untuk menginstal Xcode dan Qt6, menjalankan build_mac.sh, memindahkan sioyek.app hasil build ke /Applications/, lalu menjalankan codesign

Bacaan terkait

1 komentar

 
GN⁺ 2024-05-11
Opini Hacker News

  • Saya sangat menyukainya sampai-sampai memasangnya bahkan sebelum selesai membaca daftar fiturnya, tetapi tampaknya masih perlu perbaikan, misalnya tampilan 2 halaman
    Antarmuka kontrol keyboard-nya bagus, tetapi sayang tidak ada perintah menu. Aneh juga karena tidak ada cara untuk menampilkan kembali bantuan dari dalam program. Saat pertama dibuka, bantuan terlihat, tetapi begitu membuka file, bantuan itu hilang, sehingga akhirnya harus pergi ke halaman dokumentasi di situs web
    Meski begitu, ada begitu banyak fitur bagus yang dioptimalkan untuk riset sehingga ketidaknyamanan seperti ini masih layak ditoleransi

    • Saya pengembang Sioyek. Saya telah menambahkan mode 2 halaman di branch pengembangan
    • Dengan : Anda bisa membuka command palette dan mencari perintah serta shortcut

  • Saya telah mengerjakan cara untuk mengintegrasikan konten yang saya baca dengan catatan saya dengan lebih baik. Saya ingin mengumpulkan lokasi di literatur tempat suatu ide dikembangkan atau dibantah, sekaligus mengumpulkan ide-ide yang bagus
    Cahier yang sedang saya kembangkan (https://getcahier.com) memungkinkan pembuatan kartu yang merujuk ke bagian tertentu dari PDF yang dibaca
    Menarik melihat perkembangan yang terjadi di bidang ini dalam beberapa tahun terakhir

    • Cahier terlihat hampir persis seperti sesuatu yang sudah lama saya inginkan. Dalam beberapa tahun terakhir, ada arus yang mulai menangani manajemen pengetahuan secara serius, sehingga muncul banyak alat bagus seperti Obsidian, Zotero, dan Anki, tetapi masih kurang solusi yang baik untuk menyorot dan memberi anotasi dokumen dengan benar lalu mengeluarkan isinya dari dokumen asli dan menghubungkannya dengan konteks catatan yang lebih luas
      Pada akhirnya, muncul beberapa silo: makalah terkurung di Zotero, catatan terkurung di Obsidian, dan seterusnya. Cahier jelas terlihat menuju arah yang benar karena memandang manajemen pengetahuan sebagai workflow terpadu yang berlanjut dari membaca, menulis catatan, mengorganisasi catatan, hingga menghasilkan insight baru dan menulis
      Namun saya khawatir beberapa area akan berujung pada menciptakan ulang roda. Misalnya, saya penasaran apakah ada rencana untuk mengintegrasikan semua fitur seperti web integrated collector milik Zotero. Itu akan menjadi pekerjaan yang sangat besar, tetapi tanpa itu, sulit menggantikan Zotero sepenuhnya sebagai solusi manajemen referensi. Saya penasaran dengan roadmap, cakupan fitur akhirnya, dan workflow pengguna
    • Terlihat bagus. Seperti orang lain, saya rasa untuk sementara saya akan tetap memakai Zotero. Fitur terpenting Zotero adalah sinkronisasi antarperangkat
      Biasanya saya membaca dan memberi anotasi makalah di iPad, dan saya suka karena highlight serta catatan tersinkron sehingga bisa langsung dirujuk saat menulis di MacBook atau desktop Windows
      Namun solusi penulisan catatan Cahier terlihat jauh lebih baik. Kadang saya berharap bisa menggabungkan beberapa software untuk membuat alat yang benar-benar pas bagi masing-masing orang
    • Bisakah Anda menjelaskan lebih jauh perkembangan apa yang menurut Anda menarik? Saya perlu mengecek tautan asli, tautan ini, dan alat-alat lain di thread ini
      Sudah beberapa tahun sejak saya serius meninjaunya untuk penggunaan pribadi, tetapi saat itu saya cukup kecewa dengan pilihannya. Untuk membaca atau mengorganisasi PDF, Zotero dan org-noter termasuk yang terbaik, meski dengan pendekatan yang sangat berbeda
      Saya juga memakai OneNote selama setahun dan menyukainya saat itu, tetapi karena tidak mendukung pencarian, penemuan, dan peninjauan ulang informasi, sulit bertahan untuk membangun basis pengetahuan atau melakukan kajian literatur
      Saya rasa software untuk membaca dan menghubungkan informasi dokumen dalam bentuk apa pun—PDF, HTML, video, dan sebagainya—bisa jauh lebih baik daripada yang kita gunakan setiap hari sekarang
    • Saya mencoba memeriksa situs webnya dan melihat sertifikat SSL-nya kedaluwarsa hari ini. Sepertinya perlu diterbitkan ulang :)
    • Terlihat cukup menarik. Fitur yang wajib bagi saya adalah data, termasuk catatan dan anotasi, tetap bisa digunakan bahkan puluhan tahun kemudian
      Kalau tidak, pekerjaan hari ini akan hilang. Saya penasaran apa yang terjadi jika suatu hari pengembangan Cahier dihentikan atau saya harus pindah ke sistem lain

  • Saya selalu memakai aplikasi ini. Aplikasi yang bagus. Beberapa fitur, seperti lompat ke sitasi, juga ada di ekstensi Google Scholar untuk Chrome, tetapi gagasan membuat aplikasi bisa dikendalikan seperti Vim benar-benar bagus
    Sebelum Sioyek, saya memakai Karabiner untuk mengatur j/k dan lainnya di macOS Preview agar bisa berpindah dengan tombol Vim, tetapi prosesnya merepotkan dan tidak memiliki banyak fitur yang disediakan Sioyek. Selain itu, untuk mengurangi kelelahan mata saya memakai warna latar PDF solarized, dan aplikasi ini juga mendukung mode malam untuk grafik di dalam PDF
    Ada juga beberapa keluhan. Ada ekstensi untuk melihat PDF berdampingan dalam panel dua kolom, tetapi ekstensi itu benar-benar mengubah file PDF-nya sendiri. Instalasi plugin secara umum sulit, dan saya sudah mencari workaround lalu melaporkannya, tetapi tidak tahu apakah itu sudah tercermin dalam perbaikan aplikasi. File konfigurasi sepertinya disimpan di direktori Applications milik aplikasi, padahal akan lebih baik jika ada di ~/.config. Fitur membuka file dengan cepat dari direktori tidak berfungsi di cloud drive termasuk iCloud

    • Saya pengembang Sioyek. Saya telah menambahkan mode dua panel native di branch pengembangan
      Untuk plugin, di branch pengembangan sudah didukung ekstensi JavaScript native. Karena memakai mesin JavaScript internal Qt, tidak ada dependensi eksternal dan seharusnya jauh lebih mudah ditangani
      Saya rasa file konfigurasi juga bisa memakai ~/.config di branch pengembangan, tetapi saya tidak 100% yakin
    • Saya setuju bahwa pemasangan ekstensi itu rumit
      Saya benar-benar tidak bisa mengingat nama sioyek, jadi saya membuatnya sebagai alias untuk xpdf

  • Saya mencoba pendekatan yang lebih kolaboratif untuk membaca dan mendiskusikan makalah riset. Di https://www.scholars.io atau https://app.scholars.io, orang-orang bisa memberi anotasi pada riset, berkomentar, dan berkolaborasi

  • Penasaran apakah fitur daftar isi berfungsi meskipun PDF tidak menyertakan daftar isi. Ini fitur yang selalu saya harapkan disediakan oleh pembaca PDF

    • Sampai batas tertentu, bisa. Sioyek mem-parsing teks dan mencoba membuat daftar isi, tetapi tidak mengubah PDF asli, dan akurasi serta kegunaannya tidak konsisten
      Untuk paper, biasanya bekerja cukup baik; kadang hanya melewatkan beberapa bagian atau memasukkan item tidak penting. Untuk buku teks, terutama yang banyak typesetting rumus, sering kali ada terlalu banyak item yang tidak berguna atau bagian yang terlewat
      Jika hanya membutuhkan sebagian paper atau buku teks, daftar isi yang dibuat otomatis dan bookmark umumnya sudah cukup. Di luar itu, saya lebih suka membuat daftar isi yang akurat secara semi-manual dengan pdf.tocgen(https://github.com/Krasjet/pdf.tocgen)
    • Bisa
      Jika file tidak memiliki daftar isi dan pengaturannya diaktifkan, daftar isi dibuat dengan metode heuristik. max_created_toc_size dapat dipakai untuk mencegah pembuatan daftar isi yang terlalu besar
      https://sioyek-documentation.readthedocs.io/en/latest/config...
    • Di situs webnya tertulis bisa: https://sioyek.info/
      Menurut saya tautannya memang sebaiknya mengarah ke situs web

  • Sebagai solusi sederhana untuk fitur bolak-balik di antara dua halaman, yang mudah di buku kertas tetapi sulit di komputer, jika perangkat lunaknya mengizinkan dua instance, buka PDF yang sama dua kali
    Jika terlalu pintar sehingga itu tidak bisa, salin PDF tersebut lalu buka salinan kedua, gulir keduanya ke posisi berbeda, lalu berpindah dengan alt-tab
    Di ponsel, Acrobat Reader dan Koreader bisa dipakai bersamaan

  • Sioyek punya fitur-fitur bagus, tetapi cukup banyak bug. Memperbaiki bug dan menulis pengujian bisa membutuhkan banyak usaha

  • Sedikit melenceng, tetapi penasaran apakah ada yang tahu pembaca PDF bagus dengan pencarian berbasis LLM terintegrasi. Akan bagus kalau saat mencari “cities in USA” di dokumen, ia menampilkan semua kemunculan seperti New York, Los Angeles, Chicago, dan sebagainya

    • PDFgear memiliki integrasi LLM dan saat ini gratis

  • Akan bagus kalau pembaca ini terintegrasi dengan Zotero. Sepertinya bisa juga dalam bentuk plugin

  • Saya cukup menyukai Sioyek sebagai semacam Zathura yang lebih kaya fitur, tetapi ada dua hal yang membuat saya tidak bisa menjadikannya pembaca PDF utama
    Pertama, tidak bisa membuka beberapa PDF sekaligus. Jika suatu PDF sudah terbuka lalu mencoba membuka PDF kedua, kedua instance akan crash
    Kedua, anotasi disimpan di dokumen terpisah, bukan di PDF itu sendiri
    Pengguna lain juga pernah mencatat keduanya. Saya tidak menemukan solusi mudah untuk poin 1, dan solusi parsial untuk poin 2 memakai ekstensi, tetapi seingat saya tetap harus menjalankan perintah secara manual untuk memindahkan anotasi ke dokumen PDF itu sendiri

    • Saya setuju soal masalah beberapa PDF. Saya pikir itu masih sedang dikerjakan. Namun, untuk penyimpanan anotasi di dokumen terpisah alih-alih disematkan ke PDF, saya justru lebih suka begitu
      Idealnya, seperti Zotero dan ekstensi yang disebutkan, kedua opsi disediakan, tetapi saya lebih suka anotasi dipisahkan karena bisa mempertahankan salinan bersih PDF untuk dibagikan kepada orang lain
      Selain itu, setiap penampil PDF yang saat ini mendukung anotasi menanganinya dengan caranya sendiri, dan program-program tersebut tidak bisa membedakan dengan baik highlight atau catatan yang dibuat program lain dari yang asli
      Meski begitu, Zotero dan beberapa pembaca mulai memakai Web Annotation Data Model(https://www.w3.org/TR/annotation-model/) sebagai mekanisme penyimpanan anotasi yang umum. Saya berharap suatu hari bisa melihat dan mengedit highlight serta catatan yang dibuat di Sioyek lewat KOReader di pembaca ebook, lalu mengirim file anotasi kepada rekan pengguna Zotero atau Obsidian/PMK yang memiliki salinan terpisah dari PDF yang sama. Ini masih sangat awal, tetapi sedang dikerjakan. https://hypothes.is juga bekerja kurang lebih seperti ini
    • Berdasarkan versi terbaru 2.0.0, tampaknya ada pengaturan untuk poin 1, tetapi komentar di file konfigurasi yang disediakan bisa menyesatkan
      Dengan mengatur should_launch_new_instance ke 1, saya bisa membuka beberapa PDF sekaligus di Sioyek, tetapi hanya jika PDF setelah yang pertama dibuka dari terminal. Jika dibuka dari dalam Sioyek atau dari dmenu, PDF yang sudah terbuka akan diganti. Meski begitu, saya tidak pernah mengalami crash. Saya memakai dwm di Debian
      Menurut saya poin 2 memang diinginkan
    • Saya pengembang Sioyek. Beberapa PDF tentu saja seharusnya bisa dibuka. Misalnya, gunakan perintah new-window atau berikan opsi command line --new-window
      Jika terjadi crash, mohon buka issue di GitHub