Debian Codegraph @

translations/manual/server.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/server.rst:2
20 msgid "The calibre Content server"
21 msgstr ""
22
23 #: ../../../home/kovid/work/calibre/manual/server.rst:4
24 msgid "The calibre :guilabel:`Content server` allows you to access your calibre libraries and read books directly in a browser on your favorite mobile phone or tablet device. As a result, you do not need to install any dedicated book reading/management apps on your phone. Just use the browser. The server downloads and stores the book you are reading in an off-line cache so that you can read it even when there is no internet connection."
25 msgstr ""
26
27 #: ../../../home/kovid/work/calibre/manual/server.rst:13
28 msgid "Contents"
29 msgstr ""
30
31 #: ../../../home/kovid/work/calibre/manual/server.rst:15
32 msgid "To start the server, click the :guilabel:`Connect/share` button and choose :guilabel:`Start Content server`. You might get a message from your computer's firewall or anti-virus program asking if it is OK to allow access to ``calibre.exe``. Click the ``Allow`` or ``OK`` button. Then open a browser (preferably Chrome or Firefox) in your computer and type in the following address:"
33 msgstr ""
34
35 #: ../../../home/kovid/work/calibre/manual/server.rst:22
36 msgid "http://127.0.0.1:8080"
37 msgstr ""
38
39 #: ../../../home/kovid/work/calibre/manual/server.rst:24
40 msgid "This will open a page in the browser showing you your calibre libraries, click on any one and browse the books in it. Click on a book, and it will show you all the metadata about the book, along with buttons to :guilabel:`Read` and :guilabel:`Download` the book. Click the :guilabel:`Read` button to start reading the book."
41 msgstr ""
42
43 #: ../../../home/kovid/work/calibre/manual/server.rst:30
44 msgid "The address used above ``http://127.0.0.1:8080`` will only work on the computer that is running calibre. To access the server from other computers/phones/tablets/etc. you will need to do a little more work, as described in the next section."
45 msgstr ""
46
47 #: ../../../home/kovid/work/calibre/manual/server.rst:37
48 msgid "Accessing the Content server from other devices"
49 msgstr ""
50
51 #: ../../../home/kovid/work/calibre/manual/server.rst:39
52 msgid "There are two types of remote device access that you will typically need. The first, simpler kind is from within your home network. If you are running calibre on a computer on your home network and you have also connected your other devices to the same home network, then you should be easily able to access the server on those devices."
53 msgstr ""
54
55 #: ../../../home/kovid/work/calibre/manual/server.rst:46
56 msgid "Accessing the server from devices on your home network"
57 msgstr ""
58
59 #: ../../../home/kovid/work/calibre/manual/server.rst:48
60 msgid "After starting the server in calibre as described above, click the :guilabel:`Connect/share` button again. Instead of the :guilabel:`Start Content server` action, you should see a :guilabel:`Stop Content server` action instead. To the right of this action will be listed an IP address and port number. These look like a bunch of numbers separated by periods. For example::"
61 msgstr ""
62
63 #: ../../../home/kovid/work/calibre/manual/server.rst:57
64 msgid "These numbers tell you what address to use to connect to the server in your devices. Following the example above, the address becomes::"
65 msgstr ""
66
67 #: ../../../home/kovid/work/calibre/manual/server.rst:62
68 msgid "The first part of the address is always ``http://`` the next part is the IP address, which is the numbers before the comma and finally we have the port number which must be added to the IP address with a colon (``:``). If you are lucky, that should be all you need and you will be looking at the calibre libraries on your device. If not, read on."
69 msgstr ""
70
71 #: ../../../home/kovid/work/calibre/manual/server.rst:70
72 msgid "Trouble-shooting the home network connection"
73 msgstr ""
74
75 #: ../../../home/kovid/work/calibre/manual/server.rst:72
76 msgid "If you are unable to access the server from your device, try the following steps:"
77 msgstr ""
78
79 #: ../../../home/kovid/work/calibre/manual/server.rst:75
80 msgid "Check that the server is running by opening the address ``http://127.0.0.1:8080`` in a browser running on the same computer as the server."
81 msgstr ""
82
83 #: ../../../home/kovid/work/calibre/manual/server.rst:79
84 msgid "Check that your firewall/anti-virus is allowing connections to your computer on the port ``8080`` and to the calibre program. The easiest way to eliminate the firewall/anti-virus as the source of problems is to temporarily turn them both off and then try connecting. You should first disconnect from the internet, before turning off the firewall, to keep your computer safe."
85 msgstr ""
86
87 #: ../../../home/kovid/work/calibre/manual/server.rst:86
88 msgid "Check that your device and computer are on the same network. This means they should both be connected to the same wireless router. In particular neither should be using a cellular or ISP provided direct-WiFi connection."
89 msgstr ""
90
91 #: ../../../home/kovid/work/calibre/manual/server.rst:90
92 msgid "If you have non-standard networking setup, it might be that the IP address shown on the :guilabel:`Connect/share` menu is incorrect. In such a case you will have to figure out what the correct IP address to use is, yourself. Unfortunately, given the infinite diversity of network configurations possible, it is not possible to give you a roadmap for doing so."
93 msgstr ""
94
95 #: ../../../home/kovid/work/calibre/manual/server.rst:97
96 msgid "If you have set up a username and password, first try it without that to see if it is causing issues. Some e-ink devices have browsers that do not handle authentication. You can sometimes workaround this by including the username and password in the URL, for example: ``http://username:[email protected]:8080``."
97 msgstr ""
98
99 #: ../../../home/kovid/work/calibre/manual/server.rst:103
100 msgid "If you are stuck, you can always ask for help in the `calibre user forums`_."
101 msgstr ""
102
103 #: ../../../home/kovid/work/calibre/manual/server.rst:107
104 msgid "Accessing the server from anywhere on the internet"
105 msgstr ""
106
107 #: ../../../home/kovid/work/calibre/manual/server.rst:111
108 msgid "Before doing this you should turn on username/password protection in the server, otherwise anyone in the world will be able to access your books. Go to :guilabel:`Preferences->Sharing->Sharing over the net` and enable the option to :guilabel:`Require username and password to access the content server`."
109 msgstr ""
110
111 #: ../../../home/kovid/work/calibre/manual/server.rst:117
112 msgid "While the particular details on setting up internet access vary depending on the network configuration and type of computer you are using, the basic schema is as follows."
113 msgstr ""
114
115 #: ../../../home/kovid/work/calibre/manual/server.rst:121
116 msgid "Find out the external IP address of the computer you are going to run the server on. You can do that by visiting the site `What is my IP address <https://www.whatismyip.com/>`_ in a browser running on the computer."
117 msgstr ""
118
119 #: ../../../home/kovid/work/calibre/manual/server.rst:125
120 msgid "If the computer is behind a router, enable port forwarding on the router to forward the port ``8080`` (or whatever port you choose to run the calibre Content server on) to the computer."
121 msgstr ""
122
123 #: ../../../home/kovid/work/calibre/manual/server.rst:129
124 msgid "Make sure the calibre server is allowed through any firewalls/anti-virus programs on your computer."
125 msgstr ""
126
127 #: ../../../home/kovid/work/calibre/manual/server.rst:132
128 msgid "Now you should be able to access the server on any internet-connected device using the IP address you found in the first step. For example, if the IP address you found was ``123.123.123.123`` and the port you are using for the calibre server is ``8080``, the address to use on your device becomes: ``http://123.123.123.123:8080``."
129 msgstr ""
130
131 #: ../../../home/kovid/work/calibre/manual/server.rst:138
132 msgid "Optionally, use a service like `no-ip <https://www.noip.com/free>`_ to setup an easy to remember address to use instead of the IP address you found in the first step."
133 msgstr ""
134
135 #: ../../../home/kovid/work/calibre/manual/server.rst:146
136 msgid "For maximum security, you should also enable HTTPS on the Content server. You can either do so directly in the server by providing the path to the HTTPS certificate to use in the advanced configuration options for the server, or you can set up a reverse proxy as described below, to use an existing HTTPS setup."
137 msgstr ""
138
139 #: ../../../home/kovid/work/calibre/manual/server.rst:154
140 msgid "The server interface"
141 msgstr ""
142
143 #: ../../../home/kovid/work/calibre/manual/server.rst:156
144 msgid "The server interface is a simplified version of the main calibre interface, optimised for use with touch screens. The home screen shows you books you are currently reading as well as allowing you to choose a calibre library you want to browse. The server in calibre gives you access to all your libraries, not just a single one, as before."
145 msgstr ""
146
147 #: ../../../home/kovid/work/calibre/manual/server.rst:163
148 msgid "The book list"
149 msgstr ""
150
151 #: ../../../home/kovid/work/calibre/manual/server.rst:165
152 msgid "The server book list is a simple grid of covers. Tap on a cover to see the detailed metadata for a book, or to read the book. If you prefer a more detailed list, you can change the default view by clicking the three vertical dots in the top right corner."
153 msgstr ""
154
155 #: ../../../home/kovid/work/calibre/manual/server.rst:170
156 msgid "Sorting and searching of the book list should be familiar to calibre users. They can be accessed by clicking their icons in the top right area. They both work exactly the same as in the main calibre program. The search page even allows you to construct search queries by clicking on authors/tags/etc., just as you can using the Tag browser in the main program."
157 msgstr ""
158
159 #: ../../../home/kovid/work/calibre/manual/server.rst:176
160 msgid "A much loved feature of the main program, :guilabel:`Virtual libraries` is present in the server interface as well. Click the three vertical dots in the top right corner to choose a Virtual library."
161 msgstr ""
162
163 #: ../../../home/kovid/work/calibre/manual/server.rst:181
164 msgid "The book viewer"
165 msgstr ""
166
167 #: ../../../home/kovid/work/calibre/manual/server.rst:183
168 msgid "You can read any book in your calibre library by simply tapping on it and then tapping the :guilabel:`Read` button. The book viewer is very simple to operate. You can both tap and swipe to turn pages. Swiping up/down skips between chapters. Tapping the top quarter of the screen gets you the detailed controls and viewer preferences."
169 msgstr ""
170
171 #: ../../../home/kovid/work/calibre/manual/server.rst:189
172 msgid "If you leave the Content server running, you can even open the same book on multiple devices and it will remember your last read position. If it does not you can force a sync by tapping in the top quarter and choosing :guilabel:`Sync`."
173 msgstr ""
174
175 #: ../../../home/kovid/work/calibre/manual/server.rst:195
176 msgid "Browser support"
177 msgstr ""
178
179 #: ../../../home/kovid/work/calibre/manual/server.rst:197
180 msgid "The new calibre server makes lots of use of advanced HTML 5 and CSS 3 features. As such it requires an up-to-date browser to use. It has been tested on Android Chrome and iOS Safari as well as Chrome and Firefox on the desktop."
181 msgstr ""
182
183 #: ../../../home/kovid/work/calibre/manual/server.rst:201
184 msgid "The server is careful to use functionality that has either been already standardised or is on the standards track. As such if it does not currently work with your favorite browser, it probably will once that browser has caught up."
185 msgstr ""
186
187 #: ../../../home/kovid/work/calibre/manual/server.rst:206
188 msgid "If you are using a particularly old or limited browser or you don't like to run JavaScript, you can use the *mobile* view, by simply adding ``/mobile`` to the server address."
189 msgstr ""
190
191 #: ../../../home/kovid/work/calibre/manual/server.rst:211
192 msgid "On iOS, Apple allows only a single browser engine, so Firefox, Chrome and Safari are all actually the same browser under the hood. The new server interface requires iOS 10.3.2 or newer. On Android, the server has been tested with Chrome version 58 and newer."
193 msgstr ""
194
195 #: ../../../home/kovid/work/calibre/manual/server.rst:217
196 msgid "Enabling offline support"
197 msgstr ""
198
199 #: ../../../home/kovid/work/calibre/manual/server.rst:219
200 msgid "The server has full support for offline mode, you can open a book and once it is loaded, continue reading it offline. However, typical browsers require the use of HTTPS connections to enable offline mode (service workers). So :ref:`setup HTTPS support <cs_https_mode>` as described above. Scroll to the bottom of the home page and you will see a message about the status of offline mode."
201 msgstr ""
202
203 #: ../../../home/kovid/work/calibre/manual/server.rst:226
204 msgid "Alternately, you can open a book and keep the browser tab open. As long as the tab stays open you can continue reading the book, even when offline."
205 msgstr ""
206
207 #: ../../../home/kovid/work/calibre/manual/server.rst:230
208 msgid "Managing user accounts from the command-line only"
209 msgstr ""
210
211 #: ../../../home/kovid/work/calibre/manual/server.rst:232
212 msgid "The calibre program has a nice section in :guilabel:`Preferences` to allow you to manage user accounts for the server. However, if you want to run the standalone server and cannot run the main calibre program on the same computer/user account, you can also manage users using just the command-line."
213 msgstr ""
214
215 #: ../../../home/kovid/work/calibre/manual/server.rst:237
216 msgid "You can manage user accounts using the ``--manage-users`` option to the standalone ``calibre-server`` program. Suppose you want to store the user database in the folder ``/srv/calibre``, then you create it by running::"
217 msgstr ""
218
219 #: ../../../home/kovid/work/calibre/manual/server.rst:244
220 msgid "Just follow the prompts to create user accounts, set their permissions, etc. Once you are done, you can run the server as::"
221 msgstr ""
222
223 #: ../../../home/kovid/work/calibre/manual/server.rst:249
224 msgid "It will use the user accounts you created in the previous step."
225 msgstr ""
226
227 #: ../../../home/kovid/work/calibre/manual/server.rst:253
228 msgid "Integrating the calibre Content server into other servers"
229 msgstr ""
230
231 #: ../../../home/kovid/work/calibre/manual/server.rst:255
232 msgid "Here, we will show you how to integrate the calibre Content server into another server. The most common reason for this is to make use of SSL or to serve the calibre library as part of a larger site. The basic technique is to run the calibre server and set up a reverse proxy to it from the main server."
233 msgstr ""
234
235 #: ../../../home/kovid/work/calibre/manual/server.rst:260
236 msgid "A reverse proxy is when your normal server accepts incoming requests and passes them onto the calibre server. It then reads the response from the calibre server and forwards it to the client. This means that you can simply run the calibre server as normal without trying to integrate it closely with your main server."
237 msgstr ""
238
239 #: ../../../home/kovid/work/calibre/manual/server.rst:267
240 msgid "Using a full virtual host"
241 msgstr ""
242
243 #: ../../../home/kovid/work/calibre/manual/server.rst:269
244 msgid "The simplest configuration is to dedicate a full virtual host to the calibre server. In this case, run the calibre server as::"
245 msgstr ""
246
247 #: ../../../home/kovid/work/calibre/manual/server.rst:274
248 msgid "Now setup the virtual host in your main server, for example, for nginx::"
249 msgstr ""
250
251 #: ../../../home/kovid/work/calibre/manual/server.rst:289
252 msgid "Or, for Apache::"
253 msgstr ""
254
255 #: ../../../home/kovid/work/calibre/manual/server.rst:304
256 msgid "Using a URL prefix"
257 msgstr ""
258
259 #: ../../../home/kovid/work/calibre/manual/server.rst:306
260 msgid "If you do not want to dedicate a full virtual host to calibre, you can have it use a URL prefix. Start the calibre server as::"
261 msgstr ""
262
263 #: ../../../home/kovid/work/calibre/manual/server.rst:311
264 msgid "The key parameter here is ``--url-prefix /calibre``. This causes the Content server to serve all URLs prefixed by ``/calibre``. To see this in action, visit ``http://localhost:8080/calibre`` in your browser. You should see the normal Content server website, but now it will run under ``/calibre``."
265 msgstr ""
266
267 #: ../../../home/kovid/work/calibre/manual/server.rst:313
268 msgid "With nginx, the required configuration is::"
269 msgstr ""
270
271 #: ../../../home/kovid/work/calibre/manual/server.rst:330
272 msgid "For Apache, first enable the proxy modules in Apache, by adding the following to :file:`httpd.conf`::"
273 msgstr ""
274
275 #: ../../../home/kovid/work/calibre/manual/server.rst:335
276 msgid "The exact technique for enabling the proxy modules will vary depending on your Apache installation. Once you have the proxy modules enabled, add the following rules to :file:`httpd.conf` (or if you are using virtual hosts to the conf file for the virtual host in question)::"
277 msgstr ""
278
279 #: ../../../home/kovid/work/calibre/manual/server.rst:342
280 msgid "That's all, you will now be able to access the calibre Content server under the ``/calibre`` URL in your main server. The above rules pass all requests under ``/calibre`` to the calibre server running on port 8080 and thanks to the ``--url-prefix`` option above, the calibre server handles them transparently."
281 msgstr ""
282
283 #: ../../../home/kovid/work/calibre/manual/server.rst:347
284 msgid "When using a reverse proxy, you should tell the calibre Content server to only listen on localhost, by using ``--listen-on 127.0.0.1``. That way, the server will only listen for connections coming from the same computer, i.e. from the reverse proxy."
285 msgstr ""
286
287 #: ../../../home/kovid/work/calibre/manual/server.rst:354
288 msgid "If you have set up SSL for your main server, you should tell the calibre server to use basic authentication instead of digest authentication, as it is faster. To do so, pass the ``--auth-mode=basic`` option to ``calibre-server``."
289 msgstr ""
290
291 #: ../../../home/kovid/work/calibre/manual/server.rst:363
292 msgid "Creating a service for the calibre server on a modern Linux system"
293 msgstr ""
294
295 #: ../../../home/kovid/work/calibre/manual/server.rst:365
296 msgid "You can easily create a service to run calibre at boot on a modern (`systemd <https://www.freedesktop.org/wiki/Software/systemd/>`_) based Linux system. Just create the file ``/etc/systemd/system/calibre-server.service`` with the contents shown below::"
297 msgstr ""
298
299 #: ../../../home/kovid/work/calibre/manual/server.rst:384
300 msgid "Change ``mylinuxuser`` and ``mylinuxgroup`` to whatever user and group you want the server to run as. This should be the same user and group that own the files in the calibre library folder. Note that it is generally not a good idea to run the server as root. Also change the path to the calibre library folder to suit your system. You can add multiple libraries if needed. See the help for the ``calibre-server`` command."
301 msgstr ""
302
303 #: ../../../home/kovid/work/calibre/manual/server.rst:391
304 msgid "Now run::"
305 msgstr ""
306
307 #: ../../../home/kovid/work/calibre/manual/server.rst:395
308 msgid "to start the server. Check its status with::"
309 msgstr ""
310
311 #: ../../../home/kovid/work/calibre/manual/server.rst:399
312 msgid "To make it start at boot, run::"
313 msgstr ""
314
315 #: ../../../home/kovid/work/calibre/manual/server.rst:405
316 msgid "The calibre server *does not* need a running X server, but it does need the X libraries installed as some components it uses link against them."
317 msgstr ""
318
319 #: ../../../home/kovid/work/calibre/manual/server.rst:410
320 msgid "The calibre server also supports systemd socket activation, so you can use that, if needed, as well."
321 msgstr ""