Cambiar idiomaEl 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.
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.