| 1 |
# SOME DESCRIPTIVE TITLE. |
| 2 |
# Copyright (C) Kovid Goyal |
| 3 |
# This file is distributed under the same license as the calibre package. |
| 4 |
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. |
| 5 |
# |
| 6 |
#, fuzzy |
| 7 |
msgid "" |
| 8 |
msgstr "" |
| 9 |
"Project-Id-Version: calibre 9.15.0\n" |
| 10 |
"Report-Msgid-Bugs-To: \n" |
| 11 |
"POT-Creation-Date: 2026-09-18 07:37+0530\n" |
| 12 |
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" |
| 13 |
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" |
| 14 |
"Language-Team: LANGUAGE <[email protected]>\n" |
| 15 |
"MIME-Version: 1.0\n" |
| 16 |
"Content-Type: text/plain; charset=UTF-8\n" |
| 17 |
"Content-Transfer-Encoding: 8bit\n" |
| 18 |
|
| 19 |
#: ../../../home/kovid/work/calibre/manual/url_scheme.rst:2 |
| 20 |
msgid "The calibre:// URL scheme" |
| 21 |
msgstr "" |
| 22 |
|
| 23 |
#: ../../../home/kovid/work/calibre/manual/url_scheme.rst:4 |
| 24 |
msgid "calibre registers itself as the handler program for calibre:// URLs. So you can use these to perform actions like opening books, searching for books, etc from other programs/documents or via the command line. For example, running the following at the command line::" |
| 25 |
msgstr "" |
| 26 |
|
| 27 |
#: ../../../home/kovid/work/calibre/manual/url_scheme.rst:11 |
| 28 |
msgid "Will open calibre with the library named ``Some Library``. Library names are the folder name of the library folder with spaces replaced by underscores. The special value ``_`` means the current library. The various types of URLs are documented below." |
| 29 |
msgstr "" |
| 30 |
|
| 31 |
#: ../../../home/kovid/work/calibre/manual/url_scheme.rst:16 |
| 32 |
msgid "You can even place these links inside HTML files or Word documents or similar and the operating system will automatically run calibre to perform the specified action." |
| 33 |
msgstr "" |
| 34 |
|
| 35 |
#: ../../../home/kovid/work/calibre/manual/url_scheme.rst:26 |
| 36 |
msgid "Switch to a specific library" |
| 37 |
msgstr "" |
| 38 |
|
| 39 |
#: ../../../home/kovid/work/calibre/manual/url_scheme.rst:28 |
| 40 |
#: ../../../home/kovid/work/calibre/manual/url_scheme.rst:47 |
| 41 |
#: ../../../home/kovid/work/calibre/manual/url_scheme.rst:77 |
| 42 |
#: ../../../home/kovid/work/calibre/manual/url_scheme.rst:91 |
| 43 |
#: ../../../home/kovid/work/calibre/manual/url_scheme.rst:122 |
| 44 |
#: ../../../home/kovid/work/calibre/manual/url_scheme.rst:133 |
| 45 |
msgid "The URL syntax is::" |
| 46 |
msgstr "" |
| 47 |
|
| 48 |
#: ../../../home/kovid/work/calibre/manual/url_scheme.rst:32 |
| 49 |
msgid "Library names are the folder name of the library with spaces replaced by underscores. The special value ``_`` means the current library. You can also use :ref:`hex encoding <hex_encoding>` for the library names, useful if the library names have special characters that would otherwise require URL encoding. Hex encoded library names look like::" |
| 50 |
msgstr "" |
| 51 |
|
| 52 |
#: ../../../home/kovid/work/calibre/manual/url_scheme.rst:40 |
| 53 |
msgid "Where the part after the ``_hex_-`` prefix is the library name encoded as UTF-8 and every byte represented by two hexadecimal characters." |
| 54 |
msgstr "" |
| 55 |
|
| 56 |
#: ../../../home/kovid/work/calibre/manual/url_scheme.rst:45 |
| 57 |
msgid "Show a specific book in calibre" |
| 58 |
msgstr "" |
| 59 |
|
| 60 |
#: ../../../home/kovid/work/calibre/manual/url_scheme.rst:51 |
| 61 |
msgid "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 :guilabel:`Click to open` link in the :guilabel:`Book details` panel, it is the number in brackets at the end of the path to the book folder." |
| 62 |
msgstr "" |
| 63 |
|
| 64 |
#: ../../../home/kovid/work/calibre/manual/url_scheme.rst:56 |
| 65 |
msgid "You can copy a link to the current book displayed in calibre by right clicking the :guilabel:`Book details` panel and choosing :guilabel:`Copy link to book`." |
| 66 |
msgstr "" |
| 67 |
|
| 68 |
#: ../../../home/kovid/work/calibre/manual/url_scheme.rst:59 |
| 69 |
msgid "If a search is active and the book is not matched by the search then the search is cleared." |
| 70 |
msgstr "" |
| 71 |
|
| 72 |
#: ../../../home/kovid/work/calibre/manual/url_scheme.rst:61 |
| 73 |
msgid "If a Virtual library is selected, calibre will use it when showing the book. If the book isn't found in that virtual library then the virtual library is cleared." |
| 74 |
msgstr "" |
| 75 |
|
| 76 |
#: ../../../home/kovid/work/calibre/manual/url_scheme.rst:64 |
| 77 |
msgid "If you want to switch to a particular Virtual library when showing the book, use::" |
| 78 |
msgstr "" |
| 79 |
|
| 80 |
#: ../../../home/kovid/work/calibre/manual/url_scheme.rst:70 |
| 81 |
msgid "replacing spaces in the Virtual library name by ``%20``. If the book isn't found in that virtual library then the virtual library is ignored." |
| 82 |
msgstr "" |
| 83 |
|
| 84 |
#: ../../../home/kovid/work/calibre/manual/url_scheme.rst:75 |
| 85 |
msgid "Open a specific book in the E-book viewer at a specific position" |
| 86 |
msgstr "" |
| 87 |
|
| 88 |
#: ../../../home/kovid/work/calibre/manual/url_scheme.rst:81 |
| 89 |
msgid "Here, ``book_format`` is the format of the book, for example, ``EPUB`` or ``MOBI`` and the ``location`` is an optional location inside the book. The easiest way to get these links is to open a book in the viewer, then in the viewer controls select :guilabel:`Go to->Location` and there such a link will be given that you can copy/paste elsewhere." |
| 90 |
msgstr "" |
| 91 |
|
| 92 |
#: ../../../home/kovid/work/calibre/manual/url_scheme.rst:89 |
| 93 |
msgid "Searching for books" |
| 94 |
msgstr "" |
| 95 |
|
| 96 |
#: ../../../home/kovid/work/calibre/manual/url_scheme.rst:96 |
| 97 |
msgid "Here query is any valid :ref:`search expression <search_interface>`. If the search expression is complicated, :ref:`encode it as a hex string <hex_encoding>` and use ``eq`` instead. Leaving out the query will cause the current search to be cleared." |
| 98 |
msgstr "" |
| 99 |
|
| 100 |
#: ../../../home/kovid/work/calibre/manual/url_scheme.rst:101 |
| 101 |
msgid "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::" |
| 102 |
msgstr "" |
| 103 |
|
| 104 |
#: ../../../home/kovid/work/calibre/manual/url_scheme.rst:107 |
| 105 |
msgid "If you want to switch to a particular Virtual library, use::" |
| 106 |
msgstr "" |
| 107 |
|
| 108 |
#: ../../../home/kovid/work/calibre/manual/url_scheme.rst:113 |
| 109 |
msgid "replacing spaces in the Virtual library name by ``%20``." |
| 110 |
msgstr "" |
| 111 |
|
| 112 |
#: ../../../home/kovid/work/calibre/manual/url_scheme.rst:115 |
| 113 |
msgid "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 :guilabel:`Copy search as URL`." |
| 114 |
msgstr "" |
| 115 |
|
| 116 |
#: ../../../home/kovid/work/calibre/manual/url_scheme.rst:120 |
| 117 |
msgid "Open a book details window on a book in some library" |
| 118 |
msgstr "" |
| 119 |
|
| 120 |
#: ../../../home/kovid/work/calibre/manual/url_scheme.rst:126 |
| 121 |
msgid "This opens a book details window on the specified book from the specified library without changing the current library or the selected book." |
| 122 |
msgstr "" |
| 123 |
|
| 124 |
#: ../../../home/kovid/work/calibre/manual/url_scheme.rst:131 |
| 125 |
msgid "Open the notes associated with an author/series/etc." |
| 126 |
msgstr "" |
| 127 |
|
| 128 |
#: ../../../home/kovid/work/calibre/manual/url_scheme.rst:137 |
| 129 |
msgid "This opens a window showing the notes of the specified item. The easiest way to create such URLs is to show the notes you want in calibre and click the :guilabel:`Copy URL` button to copy the URL to the clipboard and paste it wherever you need." |
| 130 |
msgstr "" |
| 131 |
|
| 132 |
#: ../../../home/kovid/work/calibre/manual/url_scheme.rst:142 |
| 133 |
msgid "Here ``Field_Name`` is the name of the columns such as ``authors`` or ``tags``. For user created columns, replace the leading ``#`` in the field name with an underscore, so ``#mytags`` becomes ``_mytags``." |
| 134 |
msgstr "" |
| 135 |
|
| 136 |
#: ../../../home/kovid/work/calibre/manual/url_scheme.rst:146 |
| 137 |
msgid "In addition to specifying items by id using ``Item_Id`` you can also specify them by name using either ``val_Item_Name`` or ``hex_Hex_Encoded_Item_Name``. For example::" |
| 138 |
msgstr "" |
| 139 |
|
| 140 |
#: ../../../home/kovid/work/calibre/manual/url_scheme.rst:156 |
| 141 |
msgid "Hex encoding of URL parameters" |
| 142 |
msgstr "" |
| 143 |
|
| 144 |
#: ../../../home/kovid/work/calibre/manual/url_scheme.rst:158 |
| 145 |
msgid "Hex encoding of URL parameters is done by first encoding the parameter as UTF-8 bytes, and then replacing each byte by two hexadecimal characters representing the byte. For example, the string ``abc`` is the bytes ``0x61 0x62 and 0x63`` in UTF-8, so the encoded version is the string: ``616263``." |
| 146 |
msgstr "" |