Le système d’URL calibre://

calibre s’enregistre en tant que programme de gestion des URL de calibre://. Vous pouvez donc les utiliser pour effectuer des actions telles que l’ouverture de livres, la recherche de livres, etc. à partir d’autres programmes/documents ou via la ligne de commande. Par exemple, en exécutant ce qui suit sur la ligne de commande

calibre calibre://switch-library/Some_Library

S’ouvrira dans calibre avec la bibliothèque nommée Une certaine bibliothèque. Les noms de bibliothèque sont le nom du dossier de la bibliothèque avec des espaces remplacés par des traits de soulignement. La valeur spéciale _ signifie la bibliothèque actuelle. Les différents types d’URL sont documentés ci-dessous.

Vous pouvez même placer ces liens à l’intérieur de fichiers HTML ou de documents Word ou similaires et le système d’exploitation exécutera automatiquement calibre pour effectuer l’action spécifiée.

Passer à une bibliothèque spécifique

La syntaxe de l’URL est

calibre://switch-library/Library_Name

Les noms des bibliothèques sont le nom du dossier de la bibliothèque avec des espaces remplacés par des traits de soulignement. La valeur spéciale _ signifie la bibliothèque actuelle. Vous pouvez aussi utiliser :ref:`hex encoding ` pour les noms de bibliothèques, utile si les noms de bibliothèques ont des caractères spéciaux qui nécessiteraient un autre encodage d’URL. Les noms de bibliothèques codés en hexadécimal ressemblent à

_hex_-AD23F4BC

Où la partie après le préfixe _hex_- est le nom de la bibliothèque encodé en UTF-8 et chaque octet représenté par deux caractères hexadécimaux.

Montrer un livre spécifique dans calibre

La syntaxe de l’URL est

calibre://show-book/Library_Name/book_id

Cela montrera le livre avec book_id (un numéro) dans calibre. Les identifiants des livres peuvent être vus dans l’interface de calibre en passant le curseur sur le lien Cliquer pour ouvrir dans le panneau Détails du livre, c’est le numéro entre parenthèses à la fin du chemin d’accès au dossier du livre.

Vous pouvez copier un lien vers le livre actuel affiché dans calibre en faisant un clic droit sur le panneau Détails du livre et en choisissant Copier le lien vers le livre.

Si une recherche est active et que le livre ne correspond pas à la recherche, la recherche est annulée.

Si une bibliothèque virtuelle est sélectionnée, calibre l’utilisera pour afficher le livre. Si le livre n’est pas trouvé dans cette bibliothèque virtuelle, celle-ci est effacée.

Si vous souhaitez passer à une bibliothèque virtuelle particulière lorsque vous montrez le livre, utilisez :

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

en remplaçant les espaces dans le nom de la bibliothèque virtuelle par %20. Si le livre ne se trouve pas dans cette bibliothèque virtuelle, la bibliothèque virtuelle est ignoré.

Ouvrir un livre spécifique dans la visionneuse de livre numérique à un emplacement spécifique

La syntaxe de l’URL est

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

Ici, book_format est le format du livre, par exemple, EPUB ou MOBI et location est un emplacement optionnel à l’intérieur du livre. La façon la plus simple d’obtenir ces liens est d’ouvrir un livre dans la visionneuse, puis dans les commandes de la visionneuse, sélectionnez Aller à → Emplacement et là un tel lien sera donné que vous pourrez copier/coller ailleurs.

Recherche des livres

La syntaxe de l’URL est

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

Ici, toute requête est valide expression de recherche. Si l’expression de recherche est compliquée, code la comme une chaîne hexadécimale et utilise eq à la place. L’omission de la requête entraînera l’annulation de la recherche en cours.

Par défaut, si une Bibliothèque virtuelle est sélectionnée, calibre l’effacera avant de faire la recherche pour s’assurer que tous les livres sont trouvés. Si vous souhaitez préserver la bibliothèque virtuelle, utilisez

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

Si vous souhaitez passer à une Bibliothèque virtuelle particulière, utilisez

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

en remplaçant les espaces dans le nom de la bibliothèque virtuelle par %20.

Si vous effectuez une recherche dans calibre et souhaitez générer un lien pour celle-ci, vous pouvez le faire en cliquant avec le bouton droit de la souris sur la barre de recherche et en choisissant Copier la recherche en tant qu’URL.

Ouvrir une fenêtre de détails du livre pour un livre dans une bibliothèque

La syntaxe de l’URL est

calibre://book-details/Library_Name/book_id

Cette opération permet d’ouvrir une fenêtre de détails du livre spécifié dans la bibliothèque spécifiée sans modifier la bibliothèque actuelle ou le livre sélectionné.

Codage hexadécimal des paramètres d’URL

Le codage hexadécimal des paramètres d’URL se fait en codant d’abord le paramètre en UTF-8 octets, puis en remplaçant chaque octet par deux caractères hexadécimaux représentant l’octet. Par exemple, la chaîne abc correspond aux octets 0x61 0x62 et 0x63 en UTF-8, donc la version codée est la chaîne : 616263.