El esquema de URL calibre://

calibre se registra como el programa encargado de los URL calibre://. Por lo tanto, podrá usarlos para realizar operaciones como abrir libros, buscar libros, etc. desde otros programas o documentos o mediante la línea de órdenes. Por ejemplo, si ejecuta lo siguiente en la línea de órdenes:

calibre calibre://switch-library/Some_Library

calibre se abrirá con la biblioteca llamada Some Library. Los nombres de biblioteca son el nombre de la carpeta correspondiente, con los espacios sustituidos por guiones bajos. El valor especial _ significa la biblioteca actual. Los distintos tipos de URL se documentan a continuación.

También puede poner estos enlaces en archivos HTML, documentos de Word u otros parecidos y el sistema operativo ejecutará calibre automáticamente para realizar la acción especificada.

Cambiar a una biblioteca específica

La sintaxis de URL es:

calibre://switch-library/Library_Name

Library_Name es el nombre de la carpeta de la biblioteca, con los espacios sustituidos por guiones bajos. El valor especial _ significa la biblioteca actual. También puede usar la codificación hexadecimal para los nombres de biblioteca, lo que es útil si los nombres de biblioteca tienen caracteres especiales que requerirían usar codificación de URL. Los nombres de biblioteca con codificación hexadecimal son algo como:

_hex_-AD23F4BC

Donde la parte tras el prefijo _hex_- es el nombre de biblioteca codificado como UTF-8 y cada byte está representado por dos caracteres hexadecimales.

Mostrar un libro específico en calibre

La sintaxis de URL es:

calibre://show-book/Library_Name/book_id

Esto mostrará el libro con identificador book_id (un número) en calibre. Los identificadores de los libros pueden verse en la interfaz de calibre pasando el cursor sobre el enlace Pulsar para abrir en el panel de detalles del libro, es el número entre paréntesis al final de la ruta a la carpeta del libro.

Puede copiar un enlace al libro que se muestra actualmente en calibre pulsando con el botón derecho sobre el panel de detalles del libro y eligiendo Copiar enlace al libro.

Si una búsqueda está activa y el libro no coincide con la búsqueda, la búsqueda se borra.

Si hay una biblioteca virtual seleccionada, calibre la usará al mostrar el libro. Si el libro no se encuentra en la biblioteca virtual, se desactiva la biblioteca virtual.

Si quiere cambiar a una biblioteca virtual concreta al mostrar el libro, use:

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

sustituyendo los espacios en el nombre de la biblioteca virtual por %20. Si el libro no se encuentra en esa biblioteca virtual, se ignora la biblioteca virtual.

Abrir un libro específico en el visor de libros electrónicos en una posición específica

La sintaxis de URL es:

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

Aquí, book_format es el formato del libro, por ejemplo, EPUB o MOBI, y location es una ubicación opcional dentro del libro. La manera más sencilla de obtener estos enlaces es abrir el libro en el visor, seleccionar Ir a > Ubicación en los controles del visor, y allí se mostrará el enlace que podrá copiar y pegar en otra parte.

Buscar libros

La sintaxis de URL es:

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

Aquí query es cualquier expresión de búsqueda válida. Si la expresión de búsqueda es complicada, use eq y la codificación hexadecimal. Si se omite la consulta, se limpiará la búsqueda actual.

De manera predeterminada, si hay una biblioteca virtual seleccionada, calibre la desactivará antes de realizar la búsqueda para asegurarse de que se encuentran todos los libros. SI desea mantener la biblioteca virtual, use:

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

Si quiere cambiar a una biblioteca virtual concreta, use:

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

sustituyendo los espacios en el nombre de la biblioteca virtual por %20.

Si realiza una búsqueda en calibre y quiere generar un enlace para ella, puede hacerlo pulsando con el botón derecho sobre la barra de búsqueda y eligiendo Copiar búsqueda como URL.

Abrir la ventana de detalles de un libro en alguna biblioteca

La sintaxis de URL es:

calibre://book-details/Library_Name/book_id

Esto abre la ventana de detalles del libro para el libro especificado de la biblioteca especificada, sin cambiar la biblioteca actual o el libro seleccionado.

Abrir las notas asociadas con un autor, serie, etc.

La sintaxis de URL es:

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

Esto abre una ventana que muestra las notas del elemento especificado. La manera más sencilla de crear un URL así es mostrar las notas que desee en calibre y pulsar el botón Copiar URL para copiar el URL al portapapeles y pegarlo donde lo necesite.

Aquí Field_Name es el nombre de las columnas, como authors o etiquetas. Para columnas creadas por el usuario sustituya el # inicial en el nombre de campo por un guión bajo, de manera que #misetiquetas se hace _misetiquetas.

Además de especificar elementos por id usando Item_Id, también puede especificarlos por nombre usando bien val_Item_Name o hex_Hex_Encoded_Item_Name. Por ejemplo:

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

Codificación hexadecimal de parámetros de URL

La codificación hexadecimal de los parámetros de URL se hace codificando en primer lugar el parámetro como bytes en UTF-8, y luego sustituyendo cada byte por dos caracteres hexadecimales que lo representan. Por ejemplo, el texto abc corresponde a los bytes 0x61 0x62 0x63 en UTF-8, así que la versión codificada del texto será 616263.