Lo schema degli URL calibre://¶

calibre si registra come programma di gestione per gli URL calibre:// . Quindi puoi usarli per eseguire azioni come aprire libri, cercare libri, ecc. Da altri programmi/documenti o tramite la riga di comando. Ad esempio, eseguendo quanto segue dalla riga di comando:

calibre calibre://switch-library/Some_Library

Si aprirĂ  calibre con la biblioteca denominata Una biblioteca. I nomi delle biblioteche sono il nome della cartella in cui si trova la biblioteca con gli spazi sostituiti da trattini bassi. Il valore speciale _ indica la biblioteca corrente. I vari tipi di URL sono documentati di seguito.

Puoi persino inserire questi collegamenti all’interno di file HTML o documenti Word o simili ed il sistema operativo avvierà automaticamente calibre per eseguire l’azione specificata.

Passa ad una biblioteca specifica¶

La sintassi dell’URL è:

calibre://switch-library/Library_Name

I nomi delle biblioteche sono il nome della cartella della biblioteca con spazi sostituiti da trattini bassi. Il valore speciale _ indica la biblioteca corrente. Si può anche usare la codifica esadecimale per i nomi delle biblioteche, utile se i nomi delle biblioteche hanno dei caratteri speciali che possono richiesti dala codifica dell’URL. Le biblioteche con codifica esadecimale sono visualizzate come:

_hex_-AD23F4BC

Dove la parte dopo il prefisso _hex_- è il nome della biblioteca codificato come UTF-8 ed ogni byte è rappresentato da due caratteri esadecimali.

Mostra un libro specifico in calibre¶

La sintassi dell’URL è:

calibre://show-book/Library_Name/book_id

Questo mostrerà il libro con book_id (un numero) in calibre. Gli id dei libri possono essere visualizzati nell’interfaccia di calibre passando con il mouse sul collegamento Fai clic per aprire nel pannello Dettagli libro, è il numero tra parentesi alla fine del percorso della cartella del libro.

Puoi copiare un collegamento al libro attualmente visualizzato in calibre facendo clic con il tasto destro il pannello Dettagli libro e scegliendo Copia collegamento al libro.

Apri un libro specifico nel Lettore e-book a una posizione specifica¶

La sintassi dell’URL è:

calibre://view-book/Library_Name/book_id/book_format?open_at=location

Qui, ``book_format”” è il formato del libro, ad esempio, ``EPUB”” o ``MOBI”” e la ``posizione”” è una posizione opzionale all’interno del libro. Il modo più semplice per ottenere questi collegamenti è aprire un libro nel visualizzatore, quindi nei controlli del visualizzatore selezionare Vai a → Posizione e verrà fornito un collegamento che è possibile copiare/incollare altrove.

Ricerca di libri¶

La sintassi dell’URL è:

calibre://search/Library_Name?q=query
calibre://search/Library_Name?eq=hex_encoded_query

Qui la query è una qualunque espressione di ricerca valida. Se l’espressione di ricerca è complessa, codificala come una stringa esadecimale e usa eq al suo posto. Tralasciando la query, la ricerca corrente verrà cancellata.

Per impostazione predefinita, se una Biblioteca virtuale è selezionata, calibre la deselezionerà prima di effettuare la ricerca per assicurare che tutti i libri vengano trovati. Se vuoi mantenere la Biblioteca virtuale, usa:

calibre://search/Library_Name?q=query&virtual_library=_

Se vuoi passare a una specifica Biblioteca virtuale, usa:

calibre://search/Library_Name?virtual_library=Library%20Name
or
calibre://search/Library_Name?encoded_virtual_library=hex_encoded_virtual_library_name

sostituendo gli spazi nel nome della Biblioteca virtuale con %20.

Se effettui una ricerca in calibre e desideri generare un collegamento che la richiami, puoi farlo facendo clic con il tasto destro nella barra di ricerca e scegliendo Copia ricerca come URL.

Codifica esadecimale dei parametri dell’URL¶

La codifica esadecimale dei parametri URL viene eseguita codificando prima il parametro come byte UTF-8, quindi sostituendo ogni byte con due caratteri esadecimali che rappresentano il byte. Ad esempio, la stringa ``abc”” è i byte ``0x61 0x62 e 0x63”” in UTF-8, quindi la versione codificata è la stringa: ``616263””.