Zmeniť jazykSchéma URL calibre://¶
calibre sa zaregistruje ako program obsluhujúci URL adresy calibre://. Môžete ich teda použiť na vykonávanie akcií, ako je otváranie kníh, vyhľadávanie kníh atď., z iných programov alebo dokumentov, prípadne z príkazového riadka. Napríklad spustením nasledujúceho príkazu v príkazovom riadku:
calibre calibre://switch-library/Some_Library
sa otvorí calibre s knižnicou s názvom Some Library. Názvy knižníc sú názvy priečinka knižnice s medzerami nahradenými podčiarknikmi. Špeciálna hodnota _ znamená aktuálnu knižnicu. Jednotlivé typy URL adries sú popísané nižšie.
Tieto odkazy môžete dokonca umiestniť do HTML súborov alebo dokumentov Word či podobne a operačný systém automaticky spustí calibre na vykonanie zadanej akcie.
Prepnúť na konkrétnu knižnicu¶
Syntax URL je:
calibre://switch-library/Library_Name
Názvy knižníc sú názvy priečinka knižnice s medzerami nahradenými podčiarknikmi. Špeciálna hodnota _ znamená aktuálnu knižnicu. Pre názvy knižníc môžete použiť aj hexadecimálne kódovanie, čo je užitočné, ak názvy knižníc obsahujú špeciálne znaky, ktoré by inak vyžadovali kódovanie URL. Hexadecimálne kódované názvy knižníc vyzerajú takto:
_hex_-AD23F4BC
Časť za predponou _hex_- je názov knižnice zakódovaný v UTF-8 a každý bajt je reprezentovaný dvoma hexadecimálnymi znakmi.
Zobraziť konkrétnu knihu v calibre¶
Syntax URL je:
calibre://show-book/Library_Name/book_id
Týmto sa v calibre zobrazí kniha s book_id (číslo). ID kníh môžete v rozhraní calibre vidieť tak, že podržíte kurzor nad odkazom Kliknutím otvoríte v paneli Podrobnosti o knihe; je to číslo v zátvorkách na konci cesty k priečinku knihy.
Odkaz na aktuálnu knihu zobrazenú v calibre môžete skopírovať kliknutím pravým tlačidlom na panel Podrobnosti o knihe a výberom možnosti Kopírovať odkaz na knihu.
Ak je aktívne vyhľadávanie a kniha nezodpovedá vyhľadávaniu, vyhľadávanie sa vymaže.
Ak je vybraná virtuálna knižnica, calibre ju použije pri zobrazovaní knihy. Ak sa kniha v tejto virtuálnej knižnici nenájde, virtuálna knižnica sa vymaže.
Ak chcete pri zobrazovaní knihy prepnúť na konkrétnu virtuálnu knižnicu, použite:
calibre://show-book/Library_Name/book_id?virtual_library=Library%20Name
or
calibre://show-book/Library_Name/book_id?encoded_virtual_library=hex_encoded_virtual_library_name
pričom medzery v názve virtuálnej knižnice nahraďte znakmi %20. Ak sa kniha v tejto virtuálnej knižnici nenájde, virtuálna knižnica sa ignoruje.
Otvoriť konkrétnu knihu v prehliadači e-kníh na konkrétnej pozícii¶
Syntax URL je:
calibre://view-book/Library_Name/book_id/book_format?open_at=location
Tu je book_format formát knihy, napríklad EPUB alebo MOBI, a location je voliteľná pozícia vnútri knihy. Najjednoduchší spôsob, ako získať tieto odkazy, je otvoriť knihu v prehliadači, potom v ovládacích prvkoch prehliadača vybrať Prejsť na → Pozícia, kde sa zobrazí takýto odkaz, ktorý môžete skopírovať a vložiť inde.
Vyhľadávanie kníh¶
Syntax URL je:
calibre://search/Library_Name?q=query
calibre://search/Library_Name?eq=hex_encoded_query
Tu je query ľubovoľný platný vyhľadávací výraz. Ak je vyhľadávací výraz komplikovaný, zakódujte ho ako hexadecimálny reťazec a namiesto neho použite eq. Vynechanie dotazu spôsobí vymazanie aktuálneho vyhľadávania.
V predvolenom nastavení, ak je vybraná virtuálna knižnica, calibre ju pred vyhľadávaním vymaže, aby sa našli všetky knihy. Ak chcete virtuálnu knižnicu zachovať, použite:
calibre://search/Library_Name?q=query&virtual_library=_
Ak chcete prepnúť na konkrétnu virtuálnu knižnicu, použite:
calibre://search/Library_Name?virtual_library=Library%20Name
or
calibre://search/Library_Name?encoded_virtual_library=hex_encoded_virtual_library_name
pričom medzery v názve virtuálnej knižnice nahraďte znakmi %20.
Ak v calibre vykonáte vyhľadávanie a chcete preň vygenerovať odkaz, môžete tak urobiť kliknutím pravým tlačidlom na vyhľadávací panel a výberom možnosti Kopírovať vyhľadávanie ako URL.
Otvoriť okno s podrobnosťami o knihe pre knihu v niektorej knižnici¶
Syntax URL je:
calibre://book-details/Library_Name/book_id
Týmto sa otvorí okno s podrobnosťami o určenej knihe z určenej knižnice bez zmeny aktuálnej knižnice alebo vybranej knihy.
Hexadecimálne kódovanie parametrov URL¶
Hexadecimálne kódovanie parametrov URL sa vykonáva tak, že sa parameter najprv zakóduje ako bajty UTF-8 a potom sa každý bajt nahradí dvoma hexadecimálnymi znakmi reprezentujúcimi daný bajt. Napríklad reťazec abc sú v UTF-8 bajty 0x61 0x62 a 0x63, takže zakódovaná verzia je reťazec: 616263.