Схема 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, щёлкнув правой в Панели описания книги и выбрав Копировать ссылку на книгу.

Если поиск активен и книга не соответствует поиску, поиск очищается.

Если выбрана виртуальная библиотека, calibre будет использовать её при показе книги. Если книга не найдена в этой виртуальной библиотеке, виртуальная библиотека очищается.

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

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

замена пробелов в имени виртуальной библиотеки на %20. Если книга не найдена в этой виртуальной библиотеке, виртуальная библиотека игнорируется.

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

Синтаксис 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-адресов:

calibre://book-details/Library_Name/book_id

Это открывает окно сведений о книге для указанной книги из указанной библиотеки без изменения текущей библиотеки или выбранной книги.

Открыть примечания, связанные с автором/серией/и т.д.

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

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

Это открывает окно, показывающее примечания указанного элемента. Самый простой способ создать такие URL-адреса - показать примечания, желаемые в calibre, и нажать кнопку Copy URL, чтобы скопировать URL в буфер обмена и вставить его туда, где вам нужно.

Здесь Field_Name - это имя столбцов, таких как authors или tags. Для созданных пользователем столбцов замените ведущий символ # в имени столбца на подчеркивание, так что #mytags станет _mytags.

Дополнительно к указанию элементов по идентификатору с помощью Item_Id, вы также можете указывать их по имени с использованием val_Item_Name или hex_Hex_Encoded_Item_Name. Например:

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

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

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