Схема URL-адресов calibre://

calibre регистрируется как программа-обработчик для URL-адресов calibre://. Таким образом, вы можете использовать их для выполнения таких действий, как открытие книг, поиск книг и т. д. из других программ / документов или через командную строку. Например, запустив в командной строке следующее:

calibre calibre://switch-library/Some_Library

Откроет calibre с библиотекой под названием Some Library. Имена библиотек - это имя папки библиотеки с пробелами, заменёнными подчеркиванием. Специальное значение _ означает текущую библиотеку. Ниже описаны различные типы URL-адресов.

Вы можете размещать такие ссылки даже внутри HTML-файлов, документов Word или чего-то подобного, и операционная система автоматически запустит calibre для выполнения указанного действия.

Переключение на определённую библиотеку

Синтаксис URL-адресов:

calibre://switch-library/Library_Name

Имена библиотеки - это имя папки библиотеки с пробелами, замененными подчеркиванием. Специальное значение``_`` означает текущую библиотеку. Вы также можете использовать: hex encoding для имен библиотек, это полезно, если в именах библиотек есть специальные символы, которые потребовали бы URL-кодирования имён. Имена библиотек в шестнадцатеричном формате выглядят так:

_hex_-AD23F4BC

Где часть после _hex_- префикса - это имя библиотеки, закодированное в UTF-8, каждый байт представлен двумя шестнадцатеричными символами.

Отображение определённой книги в calibre

Синтаксис URL-адресов:

calibre://show-book/Library_Name/book_id

Показ книги с `` book_id „“ (число) в calibre. Идентификаторы книг можно увидеть в интерфейсе calibre, наведя курсор на ссылку Нажмите, чтобы открыть на панели Book details. Это число в скобках в конце пути к папке с книгами.

Вы можете скопировать ссылку на текущую книгу, показанную в calibre, щёлкнув правой в Панели описания книги и выбрав Копировать ссылку на книгу.

Открытие определённой книги в читалке электронных книг в указанном месте

Синтаксис URL-адресов:

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

Здесь book_format - это формат книги, например, EPUB или MOBI, а location - это опциональное местоположение внутри книги. Простейший способ получить эти ссылки - открыть книгу в просмотрщике, затем в элементах управления просмотрщиком выбрать Go to → Location, и там будет ссылка, которую вы можете скопировать/вставить где-либо.

Поиск книг

Синтаксис URL-адресов:

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

Здесь допустим любой запрос search expression. Если поисковое выражение сложное, encode it as a hex string и используйте вместо этого eq. Если не указать запрос, текущий поиск будет очищен.

По умолчанию, если выбрана Виртуальная библиотека, calibre очистит её перед выполнением поиска, чтобы убедиться, что все книги найдены. Если вы хотите сохранить Виртуальную библиотеку, используйте:

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

Если вы хотите переключиться на определённую виртуальную библиотеку, используйте::

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

заменяя пробелы в названии виртуальной библиотеки на %20.

Если вы выполняете поиск в calibre и хотите сгенерировать для него ссылку, щёлкните правой кнопкой мыши по строке поиска и выберите Копировать поиск как URL.

Шестнадцатеричное кодирование параметров URL-адреса

Шестнадцатеричное кодирование параметров URL-адреса выполняется сначала путем кодирования параметра как байтов UTF-8, а затем замены каждого байта двумя шестнадцатеричными символами, представляющими байт. Например, строка «abc» - это байты «0x61 0x62 и 0x63» в UTF-8, поэтому закодированная версия - это строка: «616263».