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

Isso mostrará o livro com book_id (um número) no calibre. Os ids para os livros podem ser vistos na interface do calibre ao passar o mouse sobre o link Clique para abrir no painel Detalhes do livro, é o número entre colchetes no final do caminho para a pasta do livro.

Você pode copiar um link para o livro atual exibido no calibre clicando com o botão direito no painel “Detalhes do livro” e escolhendo “Copiar link para o livro”.

Se uma pesquisa estiver ativa e o livro não for correspondido pela pesquisa, então a pesquisa é limpa.

Se uma biblioteca virtual for selecionada, o calibre a usará ao mostrar o livro. Se o livro não for encontrado nessa biblioteca virtual, a biblioteca virtual será limpa.

Se você quiser alternar para uma biblioteca virtual específica ao mostrar o livro, 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

substituindo espaços no nome da biblioteca virtual por ‘’%20’’. Se o livro não for encontrado nessa biblioteca virtual, a biblioteca virtual será ignorada.

Abra um livro específico no visualizador de e-books em uma posição específica

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.

Por padrão, se uma biblioteca virtual for selecionada, o calibre irá limpá-la antes de fazer a pesquisa para garantir que todos os livros sejam encontrados. Se você deseja preservar a biblioteca virtual, use:

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

Se você quiser alternar para uma biblioteca virtual específica, use:

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

substituindo espaços no nome da biblioteca virtual por %20.

Se você realizar uma busca no calibre e quiser gerar um link para ela, você pode fazer isso clicando com o botão direito na barra de pesquisa e escolhendo “Copiar busca como URL”.

Abra uma janela de detalhes do livro em um livro em alguma biblioteca

A sintaxe da URL é:

calibre://book-details/Library_Name/book_id

Isso abre uma janela de detalhes do livro no livro especificado da biblioteca especificada sem alterar a biblioteca atual ou o livro selecionado.

Abra as notas associadas a um autor/seri/etc.

A sintaxe da URL é:

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

Isso abre uma janela mostrando as notas do item especificado. A maneira mais fácil de criar URLs desse tipo é mostrar as notas desejadas no calibre e clicar no botão Copy URL para copiar a URL para a área de transferência e colá-la onde você precisar.

Aqui Field_Name é o nome das colunas, como authors ou tags. Para colunas criadas pelo usuário, substitua o # inicial no nome do campo por um sublinhado, então #mytags se torna _mytags.

Além de especificar itens por id usando Item_Id, você também pode especificá-los por nome usando val_Item_Name ou hex_Hex_Encoded_Item_Name. Por exemplo:

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

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.