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 sul pannello Dettagli libro e scegliendo Copia collegamento al libro.

Se c’è una ricerca attiva e il libro in questione non fa parte dei suoi risultati, la ricerca viene rimossa.

Se è selezionata una biblioteca virtuale, calibre la userà nel mostrare il libro. Se però il libro in questione non viene trovato in quella biblioteca virtuale, la biblioteca virtuale viene chiusa.

Se vuoi passare a una particolare biblioteca virtuale quando mostri il libro, usa:

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

sostituendo gli spazi nel nome della biblioteca virtuale con %20. Se il libro non viene trovato in quella biblioteca virtuale, la biblioteca virtuale viene ignorata.

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.

Apri una finestra con i dettagli del libro per un libro di una data biblioteca¶

La sintassi dell’URL è:

calibre://book-details/Library_Name/book_id

In questo modo si apre una finestra con i dettagli del libro per il libro e la biblioteca specificati, senza cambiare la biblioteca corrente o il libro selezionato.

Apri le note associate ad un autore/serie/ecc.¶

La sintassi dell’URL è:

calibre://book-details/Library_Name/Field_Name/id_Item_Id

Una finestra si aprirà mostrando le note dell’elemento specificato. Il modo più semplice di creare questi URL è di visualizzare le note che ti interessano in calibre e fare clic sul pulsante Copia URL per copiare l’URL negli appunti e incollarlo dove preferisci.

Qui Field_Name è il nome delle colonne, come authors o tags. Per le colonne personalizzate, sostituisci il # iniziale nel nome del campo con un trattino basso, per esempio #imieitag diventa _imieitag.

Oltre a specificare gli elementi con l’id usando Item_Id, puoi specificarli con il loro nome usando o val_Item_Name o hex_Hex_Encoded_Item_Name. Per esempio:

calibre://book-details/Library_Name/authors/val_John%20Doe

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””.