Debian Codegraph @

translations/manual/url_scheme.pot

raw
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 ""