Sioyek, ders kitapları ve araştırma makaleleri için özelleşmiş bir PDF görüntüleyici

 (github.com/ahrm)
1 puan yazan GN⁺ 2024-05-11 | 1 yorum | WhatsApp'ta paylaş
  • Sioyek, ders kitapları ve araştırma makaleleri okumaya odaklanan bir PDF görüntüleyicidir; daha önce açılmış dosyaları hızlıca bulma ve makale yapısı içinde gezinme özellikleri sunar
  • Bağlantı içermeyen PDF'lerde bile şekil ve kaynakça öğelerine atlayabilir; ayrıca kaynakça adlarını Google Scholar veya Libgen üzerinde aramayı destekler
  • İçindekiler arama, hızlı genel bakış, işaretler, yer imleri ve vurgu arama gibi uzun belgeleri okurken gereken gezinti özelliklerine odaklanır
  • Birden fazla monitör kullananlar, Portals ile metin içindeki konumları şekil konumlarına bağlayabilir ve ayrı bir pencerede en yakın portal hedefini otomatik olarak görebilir
  • Windows, macOS ve Linux için resmi kurulum dosyaları ile Homebrew Cask ve çeşitli Linux dağıtımları için üçüncü taraf paketler sunulur; geliştirme dalı derlemeleri için Qt 6.7 veya 6.8 gerekir

Proje genel bakışı

Kurulum yolları

Belge gezinti özellikleri

  • Quick Open, daha önce Sioyek ile etkileşime girilmiş dosyaları hızlıca arayıp açmayı sağlar
  • Table of Contents özelliği, içindekiler öğelerini aramayı ve ilgili konuma gitmeyi sağlar
  • Smart Jump, PDF dosyası bağlantı sunmasa bile atıf verilen şekillere veya kaynakça öğelerine gitmeyi sağlar
    • Bir kaynakça öğesinin adına orta tıklamak veya Shift+orta tıklamak, Google Scholar ya da Libgen üzerinde arama yapabilir
  • Overview, şekiller, kaynakçalar, tablolar ve benzeri öğeleri sağ tıklayarak hızlı genel bakışta açmayı sağlar
    • Smart Jump gibi, belge bağlantı sunmasa da çalışır

Uzun belge okumayı destekleyen özellikler

  • Mark, PDF içindeki adlandırılmış bir konumu kaydetmeyi ve daha sonra bu adla hızla geri dönmeyi sağlar
    • Her işaret a veya m gibi tek karakterli bir ada sahiptir
    • Küçük harfli işaretler belgeye özeldir, büyük harfli işaretler ise geneldir
    • Vim kullanmış olanlara tanıdık gelecek bir çalışma biçimidir
  • Bookmarks, işaretlere benzer ancak metin dizisi adları kullanır ve hepsi geneldir
  • Highlights, metni farklı türlerde vurgularla işaretlemeyi ve tüm vurgular içinde arama yapmayı sağlar
  • Portals, mevcut paragraf ile uzakta bulunan bir şekil gibi bir konumu birbirine bağlamayı sağlar
    • Ayrı bir pencerede en yakın portal hedefini gösterir
    • Bu pencere genellikle ikinci bir monitöre yerleştirilir
    • Kullanıcı belgede gezindikçe en yakın portal hedefine otomatik olarak güncellenir

Yapılandırma ve derleme

  • Configuration, keys_user.config ve prefs_user.config dosyalarını düzenleyerek tüm tuş atamalarını ve bazı arayüz öğelerini özelleştirmeyi sağlar
    • Varsayılan ayarlar keys.config ve prefs.config dosyalarındadır
  • Geliştirme dalını derlerken Qt 5.* derleme hatası oluşursa Qt 6.7 veya 6.8 kullanılmalıdır
  • macOS'ta "sioyek is damaged and cannot be opened. It is recommended to eject the image." mesajı görünürse, bu macOS quarantine ile ilgili bir sorundur ve ilgili tartışma yönlendirilir
  • Linux derlemesi için Fedora komutları ve genel dağıtımlar için prosedürler sunulur
    • Fedora Workstation 36 üzerinde test edilmiş prosedür de dahildir
    • Genel dağıtım prosedürü, Qt 5, qmake, libharfbuzz kurulumunun ardından ./build_linux.sh çalıştırılmasını belirtir
  • Windows derlemesi Visual Studio 2019 üzerinde test edilmiştir ve nispeten daha yeni sürümler de çalışabilir
    • Qt 5 ve qmake hazırlandıktan sonra 64 bit Visual Studio Developer Command Prompt içinde build_windows.bat çalıştırılır
  • Mac derlemesi için Xcode ve Qt6 kurulduktan sonra build_mac.sh çalıştırılır; ardından oluşturulan sioyek.app /Applications/ içine taşınır ve codesign uygulanır

İlgili okumalar

1 yorum

 
GN⁺ 2024-05-11
Hacker News yorumları

  • Özellik listesini sonuna kadar okumadan kuracak kadar beğendim, ama örneğin 2 sayfa görünümü gibi iyileştirmeler gerekli görünüyor
    Klavye tabanlı arayüz harika, ancak menü komutlarının olmaması eksiklik. Program içinde yardım ekranını yeniden açmanın bir yolu olmaması da tuhaf geldi. İlk açıldığında yardım görünüyor ama bir dosya açınca kayboluyor; sonuçta web sitesindeki dokümantasyon sayfasına gitmek zorunda kaldım
    Yine de araştırma için optimize edilmiş o kadar çok iyi özellik var ki bu tür rahatsızlıklara katlanmaya değer

    • Ben Sioyek geliştiricisiyim. Geliştirme dalına 2 sayfa modu ekledim
    • : ile komut paletini açıp komutları ve kısayolları arayabilirsiniz

  • Okuduğum içerikle kendi notlarımı daha iyi entegre etme yönünde çalışıyordum. Literatürde bir fikrin nerede geliştirildiğini ya da çürütüldüğünü toplamak, ayrıca iyi fikirleri de bir araya getirmek istiyorum
    Geliştirdiğim Cahier(https://getcahier.com), okunan PDF’lerdeki belirli pasajlara referans veren kartlar oluşturabiliyor
    Son birkaç yılda bu alanda yaşanan gelişmeleri görmek ilginç

    • Cahier, uzun zamandır istediğim şeye neredeyse tam uyuyor gibi görünüyor. Son birkaç yılda bilgi yönetimini ciddiye alan bir akım oluştu ve Obsidian, Zotero, Anki gibi harika araçlar ortaya çıktı; ancak bir belgeyi düzgün şekilde vurgulayıp notlandırdıktan sonra bu içeriği belgenin dışına çıkarıp notların daha geniş bağlamına bağlayan iyi bir çözüm hâlâ eksik
      Sonuçta makaleler Zotero’da, notlar Obsidian’da ayrı ayrı sıkışıp kalıyor ve birden fazla silo oluşuyor. Cahier, bilgi yönetimine okuma, not alma, notları düzenleme, yeni içgörüler üretme ve yazmaya uzanan entegre bir iş akışı olarak bakması açısından kesinlikle doğru yönde görünüyor
      Yine de bazı alanlarda tekerleği yeniden icat etmek zorunda kalacağınızdan endişe ediyorum. Örneğin Zotero’nun web entegrasyonlu toplayıcısı gibi işlevleri de tamamen entegre etmeyi planlayıp planlamadığınızı merak ediyorum. Bu muazzam bir iş yükü olurdu; ama olmazsa Zotero’nun yerine geçen tam bir kaynakça yönetim çözümü olmak zor. Yol haritasını, nihai özellik kapsamını ve kullanıcı iş akışını merak ediyorum
    • Güzel görünüyor. Diğerleri gibi ben de bir süre daha Zotero kullanmaya devam edecek gibiyim. Zotero’daki en önemli özellik cihazlar arası senkronizasyon
      Genelde iPad’de makale okuyup not düşüyorum; vurguların ve notların senkronize olması, sonra MacBook veya Windows masaüstünde yazarken onlara hemen başvurabilmem çok iyi
      Ama not alma çözümü açısından Cahier çok daha iyi görünüyor. Bazen farklı yazılımları birleştirip herkesin kendine tam uyan bir araç yapabilmesi keşke mümkün olsa diye düşünüyorum
    • Hangi gelişmeleri ilginç bulduğunu biraz daha anlatabilir misin? Orijinal bağlantıya, bu bağlantıya ve başlıktaki diğer araçlara da bakmam gerekecek
      Bunu kişisel kullanım için ciddi biçimde incelememin üzerinden birkaç yıl geçti ama o zamanki seçenekler beni epey hayal kırıklığına uğratmıştı. PDF okuma veya düzenleme konusunda Zotero ile org-noter, tamamen farklı şekillerde de olsa en iyi seçenekler arasındaydı
      OneNote’u da bir yıl kullandım ve o anda hoşuma gitmişti, ancak bilgi arama, keşif ve tekrar desteklemediği için bilgi tabanı oluşturma ya da literatür taraması için uzun vadede dayanmadı
      PDF, HTML, video gibi hangi biçimde olursa olsun belge bilgisini okuyup birbirine bağlayan yazılımların, bugün her gün kullandığım şeylerden çok daha iyi olabileceğini düşünüyorum
    • Siteye bakmak istedim ama SSL sertifikasının bugün süresinin dolduğunu fark ettim. Sanırım yenisini almanız gerekiyor :)
    • Oldukça ilginç görünüyor. Benim için vazgeçilmez özellik, notlar ve açıklamalar dahil verilerin on yıllar sonra bile kullanılabilir durumda kalması
      Aksi halde bugün yaptığım çalışma kaybolur. Bir gün Cahier geliştirmeyi bırakırsanız ya da ben başka bir sisteme geçmek zorunda kalırsam ne olacağını merak ediyorum

  • Bu uygulamayı sürekli kullanıyorum. Güzel bir uygulama. Atıfa atlama gibi bazı özellikler Chrome için Google Scholar eklentisinde de var, ama uygulamanın Vim gibi kullanılabilmesi fikri gerçekten çok iyi
    Sioyek’ten önce macOS Preview’de j/k gibi Vim tuşlarıyla gezinmek için Karabiner ayarlıyordum, ama süreç zahmetliydi ve Sioyek’in sunduğu birçok özellik yoktu. Ayrıca göz yorgunluğunu azaltmak için PDF arka plan rengini solarized kullanıyorum; bu uygulama PDF içindeki grafiklerde de gece modu destekliyor
    Birkaç şikâyetim de var. PDF’yi yan yana iki sütun panelde göstermeye yarayan bir eklenti var ama gerçek PDF dosyasının kendisini değiştiriyor. Eklenti kurmak genel olarak zor ve bir geçici çözüm bulup bildirdim, ama bunun uygulamayı iyileştirmede kullanılıp kullanılmadığını bilmiyorum. Ayar dosyası sanki uygulamanın Applications dizininde tutuluyor gibi; ~/.config altında olsa daha iyi olurdu. Dizinden dosyaları hızlı açma özelliği iCloud dahil bulut sürücülerinde çalışmıyor

    • Ben Sioyek geliştiricisiyim. Geliştirme dalına yerel iki panel modu ekledim
      Eklenti tarafında da geliştirme dalında yerel JavaScript uzantı desteği sağladım. Qt’nin dahili JavaScript motorunu kullandığı için harici bağımlılığı yok ve çok daha kolay yönetilebilir olacaktır
      Ayar dosyaları için de geliştirme dalında ~/.config kullanılabildiğini düşünüyorum, ama %100 emin değilim
    • Uzantı kurulumunun karmaşık olduğuna katılıyorum
      sioyek adını bir türlü aklımda tutamadığım için ona xpdf takma adı verdim

  • Araştırma makalelerini okuyup tartışmak için biraz daha işbirlikçi bir yaklaşım denedim. https://www.scholars.io veya https://app.scholars.io üzerinden insanların araştırmalara açıklama eklemesini, yorum yapmasını ve birlikte çalışmasını sağlıyoruz

  • PDF'de içindekiler tablosu olmasa bile içindekiler özelliğinin çalışıp çalışmadığını merak ediyorum. Bir PDF okuyucunun yapmasını hep istediğim bir özellik

    • Bir dereceye kadar çalışıyor. Sioyek metni ayrıştırıp içindekiler oluşturmaya çalışıyor, ancak özgün PDF'yi değiştirmiyor ve doğruluğu ile kullanışlılığı tutarsız olabiliyor
      Makalelerde oldukça iyi çalıştığı oluyor; bazen bazı bölümleri kaçırıyor ya da gereksiz maddeler ekliyor. Ders kitaplarında, özellikle denklem dizgisi yoğun olanlarda, işe yaramayan maddeler veya eksikler çok fazla olabiliyor
      Yalnızca makalenin ya da ders kitabının bir kısmı gerekiyorsa, otomatik oluşturulan içindekiler ve yer imleri çoğunlukla yeterli oluyor. Bunun dışında, doğru bir içindekiler oluşturmak için yarı manuel olarak pdf.tocgen(https://github.com/Krasjet/pdf.tocgen) kullanmayı tercih ediyorum
    • Mümkün
      Dosyada içindekiler yoksa ve ayar açıksa, sezgisel bir yöntemle içindekiler oluşturuyor. max_created_toc_size ile aşırı büyük içindekiler oluşturulması engellenebiliyor
      https://sioyek-documentation.readthedocs.io/en/latest/config...
    • Web sitesinde mümkün olduğu yazıyor: https://sioyek.info/
      Bence bağlantının web sitesine gitmesi daha doğru

  • Kâğıt kitapta kolay ama bilgisayarda zor olan iki sayfa arasında gidip gelme işlevi için basit bir geçici çözüm olarak, yazılım iki örneğe izin veriyorsa PDF'yi iki kez açıyorum
    Fazla akıllı olup buna izin vermiyorsa, PDF'yi kopyalayıp ikinci kopyayı açıyor, farklı konumlara kaydırıyor ve sonra alt-tab ile aralarında geçiş yapıyorum
    Telefonda ise Acrobat Reader ve Koreader'ı aynı anda kullanabilirsiniz

  • Sioyek'te güzel özellikler var ama epey hatasıyla karşılaştım. Hata düzeltmek ve test yazmak ciddi emek gerektirebilir

  • Biraz konu dışı ama, LLM tabanlı arama entegre edilmiş iyi bir PDF okuyucu bilen var mı diye merak ediyorum. Belgede “cities in USA” diye aradığımda örneğin New York, Los Angeles, Chicago gibi tüm eşleşmeleri göstermesi güzel olurdu

    • PDFgear içinde LLM entegre geliyor ve şu anda ücretsiz

  • Bu okuyucunun Zotero ile entegre olması güzel olurdu. Eklenti biçiminde de mümkün görünüyor

  • Sioyek'i, daha fazla özellik sunan bir Zathura gibi, epey beğenmiştim ama iki nedenle varsayılan PDF okuyucum yapamadım
    Birincisi, aynı anda birden fazla PDF açılamıyor. Zaten bir PDF açıkken ikinci bir PDF açmaya çalışınca iki örnek de çöküyor
    İkincisi, açıklamalar PDF'nin kendisine değil ayrı bir belgeye kaydediliyor
    Başkaları da bunların ikisini daha önce yazmıştı. 1 numara için kolay bir çözüm bulamadım; 2 numara içinse bir eklenti kısmi çözüm sağlıyor ama hatırladığım kadarıyla yine de açıklamaları PDF belgesinin kendisine taşımak için komutu elle çalıştırmak gerekiyordu

    • Birden fazla PDF meselesine katılıyorum. Bunun üzerinde çalışıldığını sanıyorum. Ama açıklamaların PDF'ye gömülmeyip ayrı bir belgede tutulmasını aslında tercih ediyorum
      İdeal olarak Zotero ve bahsedilen eklentide olduğu gibi iki seçeneği de sunması iyi olurdu, ancak PDF'nin temiz bir kopyasını koruyup başkalarıyla paylaşabilmek açısından açıklamaların ayrı olması daha iyi
      Ayrıca şu anda açıklama destekleyen her PDF görüntüleyici bunu kendine özgü bir şekilde ele alıyor ve programlar, başka programların oluşturduğu vurguları veya notları özgün içerikten iyi ayıramıyor
      Yine de Zotero ve bazı okuyucular, ortak bir açıklama saklama mekanizması olarak Web Annotation Data Model(https://www.w3.org/TR/annotation-model/) kullanmaya başladı. Umarım bir gün Sioyek'te oluşturulan vurguları ve notları e-kitap okuyucu KOReader'da görüp düzenleyebilir, ardından aynı PDF'nin ayrı bir kopyasına sahip Zotero veya Obsidian/PMK kullanan bir iş arkadaşıma açıklama dosyasını gönderebilirim. Henüz çok erken aşamada ama üzerinde çalışılıyor. https://hypothes.is de buna biraz benzer çalışıyor
    • En güncel 2.0.0 sürümünde 1 numara için bir ayar olduğu görünüyor, ancak verilen yapılandırma dosyasındaki yorumlar yanıltıcı olabilir
      should_launch_new_instance ayarını 1 yaptığımda Sioyek'te aynı anda birden fazla PDF açabildim, ama yalnızca ilkinden sonraki PDF'leri terminalden açtığımda. Sioyek içinden ya da dmenu ile açınca zaten açık olan PDF'nin yerini alıyor. Yine de hiç çökme yaşamadım. Debian üzerinde dwm kullanıyorum
      2 numaranın ise tercih edilir olduğunu düşünüyorum
    • Sioyek geliştiricisiyim. Elbette birden fazla PDF açılabilmeli. Örneğin new-window komutunu kullanabilir ya da --new-window komut satırı seçeneğini verebilirsiniz
      Çökme oluyorsa GitHub'da bir issue açarsanız memnun olurum