Esquema de URL calibre://

O calibre se registra como programa padrão para abrir URLs calibre://. Assim você pode usar isto para executar ações, como abrir livros, pesquisar por livros, etc. a partir de outros programas/documentos ou por linha de comando. Por exemplo: executar o seguinte na linha de comando:

calibre calibre://switch-library/Some_Library

Irá abrir o calibre com a biblioteca nomeada “Some Library”. Os nomes das bibliotecas são o nome da pasta da biblioteca com espaços substituídos por sublinhados. O valor especial “_” significa a biblioteca atual. Os vários tipos de URLs estão documentados abaixo.

Você pode inserir estes links dentro de arquivos HTML ou documentos do Word ou similares e o sistema operacional irá automaticamente abrir o calibre para executar a ação especificada.

Mudar para uma biblioteca específica

A sintaxe da URL é:

calibre://switch-library/Library_Name

Os nomes das bibliotecas são o nome da pasta da biblioteca com espaços substituídos por sublinhado. O valor especial “_” significa a biblioteca atual. Você também pode usar :ref:`hex encoding <hex_encoding>`para nomes das bibliotecas, útil se os nomes das bibliotecas possuem caracteres especiais que, de alguma forma, exigiria codificação de URL. Os nomes de biblioteca codificados em hexadecimal se parecem com:

_hex_-AD23F4BC

Parte onde após o prefixo `` _hex_-`` é o nome da biblioteca codificado como UTF-8 e cada byte representado por dois caracteres hexadecimais.

Mostrar um livro específico no calibre

A sintaxe da URL é:

calibre://show-book/Library_Name/book_id

This will show the book with book_id (a number) in calibre. The ids for books can be seen in the calibre interface by hovering over the Click to open link in the Book details panel, it is the number in brackets at the end of the path to the book folder.

You can copy a link to the current book displayed in calibre by right clicking the Book details panel and choosing Copy link to book.

Open a specific book in the E-book viewer at a specific position

A sintaxe da URL é:

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

Aqui, `` book_format`` é o formato do livro, por exemplo, ʻEPUB` ou MOBI e location é um local opcional dentro do livro. A maneira mais fácil de obter esses links é abrir um livro no visualizador, em seguida, nos controles do visualizador, selecione Go to → Location e lá será fornecido um link que você poderá copiar/colar em outro lugar.

Procurando por livros

A sintaxe da URL é:

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

Aqui a consulta e qualquer search expresion válida. Se a expressão de busca for complicada, :ref:èncode it as a hex string <hex_encoding>` e use eq em vez disso. Deixar de fora a consulta fará com que a pesquisa atual seja apagada.

By default, if a Virtual library is selected, calibre will clear it before doing the search to ensure all books are found. If you want to preserve the Virtual library, use:

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

If you want to switch to a particular Virtual library, use:

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

replacing spaces in the Virtual library name by %20.

If you perform a search in calibre and want to generate a link for it you can do so by right clicking the search bar and choosing Copy search as URL.

Codificação Hex dos parâmetros da URL

A codificação hex dos parâmetros da URL é feita, primeiro codificando os parâmetros como bytes UTF-8, e então substituindo cada byte por dois caracteres hexadecimais representando cada byte. Por exemplo: a string abc é os bytes 0x61 0x62 e 0x63 em UTF-8, assim a versão codificada é a string: 616263.