Obsidian / Plugin Obsidian / Plugin

Obsidian Kitap

Kitapyurdu üzerinden Türkçe kitapların bibliyografik verilerini (JSON-LD) çekerek Obsidian kasasında zengin şablonlar ve Dataview takibiyle notlar oluşturan eklenti.

Obsidian plugin to search Turkish books and metadata from Kitapyurdu and create structured reading notes with Dataview progress tracking.

#TypeScript#Obsidian API#JSON-LD#Dataview#Templater
GitHub Deposu GitHub Repository Tüm Projeler All Projects

Proje Hakkında

Obsidian Kitap, popüler Türkçe kitap platformu Kitapyurdu üzerinden kitap ve bibliyografik meta verilerini çeken; Obsidian bilgi kasasında zengin, şablonlanabilir ve DataviewJS ile dinamik okuma takip çubukları barındıran notlar üreten bir topluluk eklentisidir.

Dış sunuculara veya ücretli API anahtarlarına ihtiyaç duymaksızın, doğrudan schema.org/Book JSON-LD yapısal verisini ve sayfa DOM’unu ayrıştırarak eksiksiz kitap kartları oluşturur.

Temel Özellikler

  • Zengin Bibliyografik Veri: Kitap adı, yazar(lar), çevirmen(ler), yayınevi, 13 haneli ISBN, sayfa sayısı, basım tarihi, liste fiyatı, cilt tipi, tür/kategoriler, orijinal ad, puan ve kapak görseli.
  • Esnek Şablon Modları:
    • Statik Şablon: Temiz YAML frontmatter ve klasik Markdown düzeni.
    • Reaktif Şablon: DataviewJS ile dinamik okuma ilerleme çubuğu, tarihli okuma günlükleri ve etkileşimli alanlar.
    • Özel Şablon: Kasanızdaki herhangi bir .md dosyasını şablon olarak kullanma desteği.
  • Yerel Kapak İndirme: Kitap kapaklarını harici sunuculardan yüklemek yerine kasanızdaki yerel dizine (örn. Kitaplar/Kapaklar/) otomatik indirir ve Obsidian wikilink (![[kapak.jpg]]) olarak bağlar.
  • Templater Entegrasyonu: Not oluşturulduğunda Templater sözdizimini tetikler ve ham kitap nesnesine (<%* const b = book; %>) erişim sağlar.
  • İstemci Taraflı & Çevrimdışı: Obsidian’ın yerel requestUrl mekanizmasını kullanır; üçüncü parti ara sunucu barındırmaz.

About the Project

Obsidian Kitap is an Obsidian plugin to search Turkish books and metadata from Kitapyurdu and create structured reading notes with rich bibliographic data, customizable templates, Dataview reactive progress tracking, and Templater integration.

It parses structured schema.org/Book JSON-LD data and HTML directly on the client side without relying on external proxy servers or paid API credentials.

Key Features

  • Rich Book Metadata: Title, author(s), translator(s), publisher, 13-digit ISBN, page count, publish date, list price ({{price}}), format/binding, categories/genres, original title, reader rating, synopsis, and cover image.
  • Flexible Template Modes:
    • Static Template: Clean YAML frontmatter and standard Markdown layout.
    • Reactive Template: DataviewJS reading progress bar, reading logs, and dynamic inline fields.
    • Custom Template: Select any .md template from your vault or edit custom templates in settings.
  • Local Cover Image Download: Automatically downloads book covers locally into your vault (e.g., Kitaplar/Kapaklar/) and embeds them as Obsidian wikilinks (![[cover.jpg]]).
  • Templater Integration: Automatically triggers Templater syntax upon creation and exposes the raw book object (<%* const b = book; %>).
  • Client-Side & Offline Friendly: Built strictly on top of Obsidian’s native requestUrl API.