Debian Codegraph @

translations/manual/edit.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/edit.rst:4
20 msgid "Editing e-books"
21 msgstr ""
22
23 #: ../../../home/kovid/work/calibre/manual/edit.rst:6
24 msgid "calibre has an integrated e-book editor that can be used to edit books in the EPUB, KEPUB (Kobo) and AZW3 (Kindle) formats. The editor shows you the HTML and CSS that is used internally inside the book files, with a live preview that updates as you make changes. It also contains various automated tools to perform common cleanup and fixing tasks."
25 msgstr ""
26
27 #: ../../../home/kovid/work/calibre/manual/edit.rst:12
28 msgid "You can use this editor by right clicking on any book in calibre and selecting :guilabel:`Edit book`."
29 msgstr ""
30
31 #: ../../../home/kovid/work/calibre/manual/edit.rst:15
32 #: ../../../home/kovid/work/calibre/manual/edit.rst:230
33 msgid "The Edit book tool"
34 msgstr ""
35
36 #: ../../../home/kovid/work/calibre/manual/edit.rst:23
37 msgid "Contents"
38 msgstr ""
39
40 #: ../../../home/kovid/work/calibre/manual/edit.rst:26
41 msgid "Basic workflow"
42 msgstr ""
43
44 #: ../../../home/kovid/work/calibre/manual/edit.rst:29
45 msgid "A video tour of the calibre E-book editor is available :website:`here <demo#tutorials>`."
46 msgstr ""
47
48 #: ../../../home/kovid/work/calibre/manual/edit.rst:31
49 msgid "When you first open a book with the Edit book tool, you will be presented with a list of files on the left. These are the individual HTML files, stylesheets, images, etc. that make up the content of the book. Simply double click on a file to start editing it. Note that if you want to do anything more sophisticated than making a few small tweaks, you will need to know `HTML Tutorial <https://www.w3schools.com/Html/default.asp>`_ and `CSS Tutorial <https://www.w3schools.com/css/default.asp>`_."
50 msgstr ""
51
52 #: ../../../home/kovid/work/calibre/manual/edit.rst:39
53 msgid "As you make changes to the HTML or CSS in the editor, the changes will be previewed, live, in the preview panel to the right. When you are happy with how the changes you have made look, click the :guilabel:`Save` button or use :guilabel:`File->Save` to save your changes into the e-book."
54 msgstr ""
55
56 #: ../../../home/kovid/work/calibre/manual/edit.rst:44
57 msgid "One useful feature is :guilabel:`Checkpoints`. Before you embark on some ambitious set of edits, you can create a checkpoint. The checkpoint will preserve the current state of your book, then if in the future you decide you don't like the changes you have made, you can go back to the state when you created the checkpoint. To create a checkpoint, use :guilabel:`Edit->Create checkpoint`. Checkpoints will also be automatically created for you whenever you run any automated tool like global search and replace. The checkpointing functionality is in addition to the normal undo/redo mechanism when editing individual files. Checkpoints are needed for when changes are spread over multiple files in the book."
58 msgstr ""
59
60 #: ../../../home/kovid/work/calibre/manual/edit.rst:55
61 msgid "That is the basic work flow for editing books -- Open a file, make changes, preview and save. The rest of this manual will discuss the various tools and features present to allow you to perform specific tasks efficiently."
62 msgstr ""
63
64 #: ../../../home/kovid/work/calibre/manual/edit.rst:60
65 msgid "The File browser"
66 msgstr ""
67
68 #: ../../../home/kovid/work/calibre/manual/edit.rst:62
69 msgid "The File browser showing files in the book"
70 msgstr ""
71
72 #: ../../../home/kovid/work/calibre/manual/edit.rst:66
73 msgid "The :guilabel:`File browser` gives you an overview of the various files inside the book you are editing. The files are arranged by category, with text (HTML) files at the top, followed by stylesheet (CSS) files, images and so on. Simply double click on a file to start editing it. Editing is supported for HTML, CSS and image files. The order of text files is the same order that they would be displayed in, if you were reading the book. All other files are arranged alphabetically."
74 msgstr ""
75
76 #: ../../../home/kovid/work/calibre/manual/edit.rst:74
77 msgid "By hovering your mouse over an entry, you can see its size, and also, at the bottom of the screen, the full path to the file inside the book. Note that files inside e-books are compressed, so the size of the final book is not the sum of the individual file sizes."
78 msgstr ""
79
80 #: ../../../home/kovid/work/calibre/manual/edit.rst:79
81 msgid "Many files have special meaning, in the book. These will typically have an icon next to their names, indicating the special meaning. For example, in the picture to the left, you can see that the files :guilabel:`cover_image.jpg` and :guilabel:`titlepage.xhtml` have the icon of a cover next to them, this indicates they are the book cover image and titlepage. Similarly, the :guilabel:`content.opf` file has a metadata icon next to it, indicating the book metadata is present in it and the :guilabel:`toc.ncx` file has a T icon next to it, indicating it is the Table of Contents."
82 msgstr ""
83
84 #: ../../../home/kovid/work/calibre/manual/edit.rst:88
85 msgid "You can perform many actions on individual files, by right clicking them."
86 msgstr ""
87
88 #: ../../../home/kovid/work/calibre/manual/edit.rst:91
89 msgid "Renaming files"
90 msgstr ""
91
92 #: ../../../home/kovid/work/calibre/manual/edit.rst:93
93 msgid "You can rename an individual file by right clicking it and selecting :guilabel:`Rename`. Renaming a file automatically updates all links and references to it throughout the book. So all you have to do is provide the new name, calibre will take care of the rest."
94 msgstr ""
95
96 #: ../../../home/kovid/work/calibre/manual/edit.rst:98
97 msgid "You can also bulk rename many files at once. This is useful if you want the files to have some simple name pattern. For example you might want to rename all the HTML files to have names Chapter-1.html, Chapter-2.html and so on. Select the files you want bulk renamed by holding down the :kbd:`Shift` or :kbd:`Ctrl` key and clicking the files. Then right click and select :guilabel:`Bulk rename`. Enter a prefix and what number you would like the automatic numbering to start at, click OK and you are done. The bulk rename dialog also lets you rename files by the order they appear in the book instead of the order you selected them in, useful, for instance to rename all images by the order they appear."
98 msgstr ""
99
100 #: ../../../home/kovid/work/calibre/manual/edit.rst:109
101 msgid "Finally, you can bulk change the file extension for all selected files. Select multiple files, as above, and right click and choose :guilabel:`Change the file extension for the selected files`."
102 msgstr ""
103
104 #: ../../../home/kovid/work/calibre/manual/edit.rst:114
105 msgid "Merging files"
106 msgstr ""
107
108 #: ../../../home/kovid/work/calibre/manual/edit.rst:116
109 msgid "Sometimes, you may want to merge two HTML files or two CSS files together. It can sometimes be useful to have everything in a single file. Be wary, though, putting a lot of content into a single file will cause performance problems when viewing the book in a typical e-book reader."
110 msgstr ""
111
112 #: ../../../home/kovid/work/calibre/manual/edit.rst:121
113 msgid "To merge multiple files together, select them by holding the :kbd:`Ctrl` key and clicking on them (make sure you only select files of one type, either all HTML files or all CSS files and so on). Then right click and select merge. That's all, calibre will merge the files, automatically taking care of migrating all links and references to the merged files. Note that merging files can sometimes cause text styling to change, since the individual files could have used different stylesheets."
114 msgstr ""
115
116 #: ../../../home/kovid/work/calibre/manual/edit.rst:129
117 msgid "You can also select text files and then drag and drop the text files onto another text file to merge the dropped text files into the target text file."
118 msgstr ""
119
120 #: ../../../home/kovid/work/calibre/manual/edit.rst:133
121 msgid "Changing text file order"
122 msgstr ""
123
124 #: ../../../home/kovid/work/calibre/manual/edit.rst:135
125 msgid "You can re-arrange the order in which text (HTML) files are opened when reading the book by simply dragging and dropping them in the :guilabel:`File browser` or clicking on the file to move and then pressing the :kbd:`Ctrl+Shift` modifiers with the :kbd:`Up`, :kbd:`Down`, :kbd:`Home` or :kbd:`End` keys. For the technically inclined, this is called re-ordering the book spine."
126 msgstr ""
127
128 #: ../../../home/kovid/work/calibre/manual/edit.rst:141
129 msgid "Note that you have to drop the items *between* other items, not on top of them, this can be a little fiddly until you get used to it. Dropping on top of another file will cause the files to be merged."
130 msgstr ""
131
132 #: ../../../home/kovid/work/calibre/manual/edit.rst:146
133 msgid "Marking the cover"
134 msgstr ""
135
136 #: ../../../home/kovid/work/calibre/manual/edit.rst:148
137 msgid "E-books typically have a cover image. This image is indicated in the :guilabel:`File browser` by the icon of a brown book next to the image name. If you want to designate some other image as the cover, you can do so by right clicking on the file and choosing :guilabel:`Mark as cover`."
138 msgstr ""
139
140 #: ../../../home/kovid/work/calibre/manual/edit.rst:153
141 msgid "In addition, EPUB files have the concept of a *titlepage*. A title page is a HTML file that acts as the title page/cover for the book. You can mark an HTML file as the titlepage when editing EPUBs by right-clicking. Be careful that the file you mark contains only the cover information. If it contains other content, such as the first chapter, then that content will be lost if the user ever converts the EPUB file in calibre to another format. This is because when converting, calibre assumes that the marked title page contains only the cover and no other content."
142 msgstr ""
143
144 #: ../../../home/kovid/work/calibre/manual/edit.rst:163
145 msgid "Deleting files"
146 msgstr ""
147
148 #: ../../../home/kovid/work/calibre/manual/edit.rst:165
149 msgid "You can delete files by either right clicking on them or by selecting them and pressing the Delete key. Deleting a file removes all references to the file from the OPF file, saving you that chore. However, references in other places are not removed, you can use the Check Book tool to easily find and remove/replace them."
150 msgstr ""
151
152 #: ../../../home/kovid/work/calibre/manual/edit.rst:172
153 msgid "Exporting files"
154 msgstr ""
155
156 #: ../../../home/kovid/work/calibre/manual/edit.rst:174
157 msgid "You can export a file from inside the book to somewhere else on your computer. This is useful if you want to work on the file in isolation, with specialised tools. To do this, simply right click on the file and choose :guilabel:`Export`."
158 msgstr ""
159
160 #: ../../../home/kovid/work/calibre/manual/edit.rst:179
161 msgid "Once you are done working on the exported file, you can re-import it into the book, by right clicking on the file again and choosing :guilabel:`Replace with file...` which will allow you to replace the file in the book with the previously exported file."
162 msgstr ""
163
164 #: ../../../home/kovid/work/calibre/manual/edit.rst:184
165 msgid "You can also copy files between multiple editor instances. Select the files you want to copy in the :guilabel:`File browser`, then right click and choose, :guilabel:`Copy selected files to another editor instance`. Then, in the other editor instance, right click in the :guilabel:`File browser` and choose :guilabel:`Paste file from other editor instance`."
166 msgstr ""
167
168 #: ../../../home/kovid/work/calibre/manual/edit.rst:191
169 msgid "Adding new images/fonts/etc. or creating new blank files"
170 msgstr ""
171
172 #: ../../../home/kovid/work/calibre/manual/edit.rst:193
173 msgid "You can add a new image, font, stylesheet, etc. from your computer into the book by clicking :guilabel:`File->New file`. This lets you either import a file by clicking the :guilabel:`Import resource file` button or create a new blank HTML file or stylesheet by simply entering the file name into the box for the new file."
174 msgstr ""
175
176 #: ../../../home/kovid/work/calibre/manual/edit.rst:198
177 msgid "You can also import multiple files into the book at once using File->Import files into book."
178 msgstr ""
179
180 #: ../../../home/kovid/work/calibre/manual/edit.rst:202
181 msgid "Replacing files"
182 msgstr ""
183
184 #: ../../../home/kovid/work/calibre/manual/edit.rst:204
185 msgid "You can easily replace existing files in the book, by right clicking on the file and choosing replace. This will automatically update all links and references, in case the replacement file has a different name than the file being replaced."
186 msgstr ""
187
188 #: ../../../home/kovid/work/calibre/manual/edit.rst:210
189 msgid "Linking stylesheets to HTML files efficiently"
190 msgstr ""
191
192 #: ../../../home/kovid/work/calibre/manual/edit.rst:212
193 msgid "As a convenience, you can select multiple HTML files in the File browser, right click and choose Link stylesheets to have calibre automatically insert the <link> tags for those stylesheets into all the selected HTML files."
194 msgstr ""
195
196 #: ../../../home/kovid/work/calibre/manual/edit.rst:222
197 msgid "Search & replace"
198 msgstr ""
199
200 #: ../../../home/kovid/work/calibre/manual/edit.rst:224
201 msgid "Edit book has a very powerful search and replace interface that allows you to search and replace text in the current file, across all files and even in a marked region of the current file. You can search using a normal search or using regular expressions. To learn how to use regular expressions for advanced searching, see :ref:`regexptutorial`."
202 msgstr ""
203
204 #: ../../../home/kovid/work/calibre/manual/edit.rst:234
205 msgid "Start the search and replace via the :guilabel:`Search->Find/replace` menu entry (you must be editing an HTML or CSS file)."
206 msgstr ""
207
208 #: ../../../home/kovid/work/calibre/manual/edit.rst:237
209 msgid "Type the text you want to find into the Find box and its replacement into the Replace box. You can the click the appropriate buttons to Find the next match, replace the current match and replace all matches."
210 msgstr ""
211
212 #: ../../../home/kovid/work/calibre/manual/edit.rst:241
213 msgid "Using the drop downs at the bottom of the box, you can have the search operate over the current file, all text files, all style files or all files. You can also choose the search mode to be a normal (string) search or a regular expression search."
214 msgstr ""
215
216 #: ../../../home/kovid/work/calibre/manual/edit.rst:246
217 msgid "You can count all the matches for a search expression via :guilabel:`Search->Count all`. The count will run over whatever files/regions you have selected in the dropdown box."
218 msgstr ""
219
220 #: ../../../home/kovid/work/calibre/manual/edit.rst:250
221 msgid "You can also go to a specific line in the currently open editor via :guilabel:`Search->Go to line`."
222 msgstr ""
223
224 #: ../../../home/kovid/work/calibre/manual/edit.rst:254
225 msgid "Remember, to harness the full power of search and replace, you will need to use regular expressions. See :ref:`regexptutorial`."
226 msgstr ""
227
228 #: ../../../home/kovid/work/calibre/manual/edit.rst:258
229 msgid "Saved searches"
230 msgstr ""
231
232 #: ../../../home/kovid/work/calibre/manual/edit.rst:260
233 msgid "You can save frequently used search/replace expressions (including function mode expressions) and reuse them multiple times. To save a search simply right click in the Find box and select :guilabel:`Save current search`."
234 msgstr ""
235
236 #: ../../../home/kovid/work/calibre/manual/edit.rst:264
237 msgid "You can bring up the saved searches via :guilabel:`Search->Saved searches`. This will present you with a list of search and replace expressions that you can apply. You can even select multiple entries in the list by holding down the :kbd:`Ctrl` key while clicking so as to run multiple search and replace expressions in a single operation."
238 msgstr ""
239
240 #: ../../../home/kovid/work/calibre/manual/edit.rst:271
241 msgid "Function mode"
242 msgstr ""
243
244 #: ../../../home/kovid/work/calibre/manual/edit.rst:273
245 msgid "Function mode allows you to write arbitrarily powerful Python functions that are run on every Find/replace. You can do pretty much any text manipulation you like in function mode. For more information, see :doc:`function_mode`."
246 msgstr ""
247
248 #: ../../../home/kovid/work/calibre/manual/edit.rst:278
249 msgid "Search ignoring HTML tags"
250 msgstr ""
251
252 #: ../../../home/kovid/work/calibre/manual/edit.rst:280
253 msgid "There is also a dedicated tool for searching for text, ignoring any HTML tags in between. For example, if the book has the HTML ``Emphasis on a <i>word</i>.`` you can search for ``on a word`` and it will be found even though there is an ``<i>`` tag in the middle. Use this tool via the :guilabel:`Search->Search ignoring HTML markup` menu item."
254 msgstr ""
255
256 #: ../../../home/kovid/work/calibre/manual/edit.rst:287
257 msgid "Automated tools"
258 msgstr ""
259
260 #: ../../../home/kovid/work/calibre/manual/edit.rst:289
261 msgid "Edit book has various tools to help with common tasks. These are accessed via the :guilabel:`Tools` menu."
262 msgstr ""
263
264 #: ../../../home/kovid/work/calibre/manual/edit.rst:293
265 msgid "Editing the Table of Contents"
266 msgstr ""
267
268 #: ../../../home/kovid/work/calibre/manual/edit.rst:295
269 msgid "There is a dedicated tool to ease editing of the Table of Contents. Launch it with :guilabel:`Tools->Table of Contents->Edit Table of Contents`."
270 msgstr ""
271
272 #: ../../../home/kovid/work/calibre/manual/edit.rst:298
273 msgid "The Edit Table of Contents tool"
274 msgstr ""
275
276 #: ../../../home/kovid/work/calibre/manual/edit.rst:302
277 msgid "The Edit Table of Contents tool shows you the current Table of Contents (if any) on the left. Simply double click on any entry to change its text. You can also re-arrange entries by drag and drop or by using the buttons to the right."
278 msgstr ""
279
280 #: ../../../home/kovid/work/calibre/manual/edit.rst:306
281 msgid "For books that do not have a pre-existing Table of Contents, the tool gives you various options to auto-generate a Table of Contents from the text. You can generate from the headings in the document, from links, from individual files and so on."
282 msgstr ""
283
284 #: ../../../home/kovid/work/calibre/manual/edit.rst:311
285 msgid "You can edit individual entries by clicking on them and then clicking the :guilabel:`Change the location this entry points to` button. This will open up a mini-preview of the book, simply move the mouse cursor over the book view panel, and click where you want the entry to point to. A thick green line will show you the location. Click OK once you are happy with the location."
286 msgstr ""
287
288 #: ../../../home/kovid/work/calibre/manual/edit.rst:317
289 msgid "The Edit Table of Contents tool, how to change the location an entry points to"
290 msgstr ""
291
292 #: ../../../home/kovid/work/calibre/manual/edit.rst:322
293 msgid "Checking the book"
294 msgstr ""
295
296 #: ../../../home/kovid/work/calibre/manual/edit.rst:324
297 msgid "The :guilabel:`Check book` tool searches your book for problems that could prevent it working as intended on actual reader devices. Activate it via :guilabel:`Tools->Check book`."
298 msgstr ""
299
300 #: ../../../home/kovid/work/calibre/manual/edit.rst:328
301 msgid "The Check book tool"
302 msgstr ""
303
304 #: ../../../home/kovid/work/calibre/manual/edit.rst:332
305 msgid "Any problems found are reported in a nice, easy to use list. Clicking any entry in the list shows you some help about that error as well as giving you the option to auto-fix that error, if the error can be fixed automatically. You can also double click the error to open the location of the error in an editor, so you can fix it yourself."
306 msgstr ""
307
308 #: ../../../home/kovid/work/calibre/manual/edit.rst:339
309 msgid "Some of the checks performed are:"
310 msgstr ""
311
312 #: ../../../home/kovid/work/calibre/manual/edit.rst:341
313 msgid "Malformed HTML markup. Any HTML markup that does not parse as well-formed XML is reported. Correcting it will ensure that your markup works as intended in all contexts. calibre can also auto-fix these errors, but auto-fixing can sometimes have unexpected effects, so use with care. As always, a checkpoint is created before auto-fixing so you can easily revert all changes. Auto-fixing works by parsing the markup using the HTML5 algorithm, which is highly fault tolerant and then converting to well formed XML."
314 msgstr ""
315
316 #: ../../../home/kovid/work/calibre/manual/edit.rst:350
317 msgid "Malformed or unknown CSS styles. Any CSS that is not valid or that has properties not defined in the CSS 2.1 standard (plus a few from CSS 3) are reported. CSS is checked in all stylesheets, inline style attributes and <style> tags in HTML files."
318 msgstr ""
319
320 #: ../../../home/kovid/work/calibre/manual/edit.rst:355
321 msgid "Broken links. Links that point to files inside the book that are missing are reported."
322 msgstr ""
323
324 #: ../../../home/kovid/work/calibre/manual/edit.rst:358
325 msgid "Unreferenced files. Files in the book that are not referenced by any other file or are not in the spine are reported."
326 msgstr ""
327
328 #: ../../../home/kovid/work/calibre/manual/edit.rst:361
329 msgid "Various common problems in OPF files such as duplicate spine or manifest items, broken idrefs or meta cover tags, missing required sections and so on."
330 msgstr ""
331
332 #: ../../../home/kovid/work/calibre/manual/edit.rst:365
333 msgid "Various compatibility checks for known problems that can cause the book to malfunction on reader devices."
334 msgstr ""
335
336 #: ../../../home/kovid/work/calibre/manual/edit.rst:369
337 msgid "Adding a cover"
338 msgstr ""
339
340 #: ../../../home/kovid/work/calibre/manual/edit.rst:371
341 msgid "You can easily add a cover to the book via :guilabel:`Tools->Add cover`. This allows you to either choose an existing image in the book as the cover or import a new image into the book and make it the cover. When editing EPUB files, the HTML wrapper for the cover is automatically generated. If an existing cover in the book is found, it is replaced. The tool also automatically takes care of correctly marking the cover files as covers in the OPF."
342 msgstr ""
343
344 #: ../../../home/kovid/work/calibre/manual/edit.rst:380
345 msgid "Embedding referenced fonts"
346 msgstr ""
347
348 #: ../../../home/kovid/work/calibre/manual/edit.rst:382
349 msgid "Accessed via :guilabel:`Tools->Embed reference fonts`, this tool finds all fonts referenced in the book and if they are not already embedded, searches your computer for them and embeds them into the book, if found. Please make sure that you have the necessary copyrights for embedding commercially licensed fonts, before doing this."
350 msgstr ""
351
352 #: ../../../home/kovid/work/calibre/manual/edit.rst:389
353 msgid "Subsetting embedded fonts"
354 msgstr ""
355
356 #: ../../../home/kovid/work/calibre/manual/edit.rst:391
357 msgid "Accessed via :guilabel:`Tools->Subset embedded fonts`, this tool reduces all the fonts in the book to only contain glyphs for the text actually present in the book. This commonly reduces the size of the font files by ~ 50%. However, be aware that once the fonts are subset, if you add new text whose characters are not previously present in the subset font, the font will not work for the new text. So do this only as the last step in your workflow."
358 msgstr ""
359
360 #: ../../../home/kovid/work/calibre/manual/edit.rst:399
361 msgid "Smartening punctuation"
362 msgstr ""
363
364 #: ../../../home/kovid/work/calibre/manual/edit.rst:401
365 msgid "Convert plain text dashes, ellipsis, quotes, multiple hyphens, etc. into their typographically correct equivalents. Note that the algorithm can sometimes generate incorrect results, especially when single quotes at the start of contractions are involved. Accessed via :guilabel:`Tools->Smarten punctuation`."
366 msgstr ""
367
368 #: ../../../home/kovid/work/calibre/manual/edit.rst:408
369 msgid "Transforming CSS properties"
370 msgstr ""
371
372 #: ../../../home/kovid/work/calibre/manual/edit.rst:410
373 msgid "Create rules to transform the styling of the book. For example, create a rule to convert all red text to green or to double the font size of all text in the book or make text of a certain font family italic, etc."
374 msgstr ""
375
376 #: ../../../home/kovid/work/calibre/manual/edit.rst:414
377 msgid "Creating the rules is simple, the rules follow a natural language format, that looks like:"
378 msgstr ""
379
380 #: ../../../home/kovid/work/calibre/manual/edit.rst:417
381 msgid "If the property *color* is *red* *change* it to *green*"
382 msgstr ""
383
384 #: ../../../home/kovid/work/calibre/manual/edit.rst:418
385 msgid "If the property *font-size* is *any value* *multiply* the value by *2*"
386 msgstr ""
387
388 #: ../../../home/kovid/work/calibre/manual/edit.rst:420
389 msgid "Accessed via :guilabel:`Tools->Transform styles`."
390 msgstr ""
391
392 #: ../../../home/kovid/work/calibre/manual/edit.rst:423
393 msgid "Removing unused CSS rules"
394 msgstr ""
395
396 #: ../../../home/kovid/work/calibre/manual/edit.rst:425
397 msgid "Remove all unused CSS rules from stylesheets and <style> tags. Some books created from production templates can have a large number of extra CSS rules that don't match any actual content. These extra rules can slow down readers that need to process them all. Accessed via :guilabel:`Tools->Remove unused CSS`."
398 msgstr ""
399
400 #: ../../../home/kovid/work/calibre/manual/edit.rst:432
401 msgid "Fixing HTML"
402 msgstr ""
403
404 #: ../../../home/kovid/work/calibre/manual/edit.rst:434
405 msgid "This tool simply converts HTML that cannot be parsed as XML into well-formed XML. It is very common in e-books to have non-well-formed XML, so this tool simply automates the process of fixing such HTML. The tool works by parsing the HTML using the HTML5 algorithm (the algorithm used in all modern browsers) and then converting the result into XML. Be aware that auto-fixing can sometimes have counter-intuitive results. If you prefer, you can use the Check Book tool discussed above to find and manually correct problems in the HTML. Accessed via :guilabel:`Tools->Fix HTML`."
406 msgstr ""
407
408 #: ../../../home/kovid/work/calibre/manual/edit.rst:444
409 msgid "Beautifying files"
410 msgstr ""
411
412 #: ../../../home/kovid/work/calibre/manual/edit.rst:446
413 msgid "This tool is used to auto-format all HTML and CSS files so that they \"look pretty\". The code is auto-indented so that it lines up nicely, blank lines are inserted where appropriate and so on. Note that beautifying also auto-fixes broken HTML/CSS. Therefore, if you don't want any auto-fixing to be performed, first use the Check Book tool to correct all problems and only then run beautify. Accessed via :guilabel:`Tools->Beautify all files`."
414 msgstr ""
415
416 #: ../../../home/kovid/work/calibre/manual/edit.rst:454
417 msgid "In HTML any text can have significant whitespace, via the CSS white-space directive. Therefore, beautification could potentially change the rendering of the HTML. To avoid this as far as possible, the beautify algorithm only beautifies block level tags that contain other block level tags. So, for example, text inside a <p> tag will not have its whitespace changed. But a <body> tag that contains only other <p> and <div> tags will be beautified. This can sometimes mean that a particular file will not be affected by beautify as it has no suitable block level tags. In such cases you can try different beautification tools, that are less careful, for example: `HTML Tidy <https://infohound.net/tidy/>`_."
418 msgstr ""
419
420 #: ../../../home/kovid/work/calibre/manual/edit.rst:467
421 msgid "Inserting an inline Table of Contents"
422 msgstr ""
423
424 #: ../../../home/kovid/work/calibre/manual/edit.rst:469
425 msgid "Normally in e-books, the Table of Contents is separate from the main text and is typically accessed via a special Table of Contents button/menu in the e-book reading device. You can also have calibre automatically generate an *inline* Table of Contents that becomes part of the text of the book. It is generated based on the currently defined Table of Contents."
426 msgstr ""
427
428 #: ../../../home/kovid/work/calibre/manual/edit.rst:475
429 msgid "If you use this tool multiple times, each invocation will cause the previously created inline Table of Contents to be replaced. The tool can be accessed via :guilabel:`Tools->Table of Contents->Insert inline Table of Contents`."
430 msgstr ""
431
432 #: ../../../home/kovid/work/calibre/manual/edit.rst:480
433 msgid "Setting Semantics"
434 msgstr ""
435
436 #: ../../../home/kovid/work/calibre/manual/edit.rst:482
437 msgid "This tool is used to set *semantics* in EPUB files. Semantics are simply, links in the OPF file that identify certain locations in the book as having special meaning. You can use them to identify the foreword, dedication, cover, table of contents, etc. Simply choose the type of semantic information you want to specify and then select the location in the book the link should point to. This tool can be accessed via :guilabel:`Tools->Set semantics`."
438 msgstr ""
439
440 #: ../../../home/kovid/work/calibre/manual/edit.rst:490
441 msgid "Filtering style information"
442 msgstr ""
443
444 #: ../../../home/kovid/work/calibre/manual/edit.rst:492
445 msgid "This tool can be used to easily remove specified CSS style properties from the entire book. You can tell it what properties you want removed, for example, ``color, background-color, line-height`` and it will remove them from everywhere they occur --- stylesheets, ``<style>`` tags and inline ``style`` attributes. After removing the style information, a summary of all the changes made is displayed so you can see exactly what was changed. The tool can be accessed via :guilabel:`Tools->Filter style information`."
446 msgstr ""
447
448 #: ../../../home/kovid/work/calibre/manual/edit.rst:502
449 msgid "Upgrading the book's internals"
450 msgstr ""
451
452 #: ../../../home/kovid/work/calibre/manual/edit.rst:504
453 msgid "This tool can be used to upgrade the book's internals, if possible. For instance it will upgrade EPUB 2 books to EPUB 3 books. The tool can be accessed via :guilabel:`Upgrade book internals`."
454 msgstr ""
455
456 #: ../../../home/kovid/work/calibre/manual/edit.rst:511
457 msgid "Checkpoints"
458 msgstr ""
459
460 #: ../../../home/kovid/work/calibre/manual/edit.rst:513
461 msgid ":guilabel:`Checkpoints` are a way to mark the current state of the book as \"special\". You can then go on to do whatever changes you want to the book and if you don't like the results, return to the checkpointed state. Checkpoints are automatically created every time you run any of the automated tools described in the previous section."
462 msgstr ""
463
464 #: ../../../home/kovid/work/calibre/manual/edit.rst:519
465 msgid "You can create a checkpoint via :guilabel:`Edit->Create checkpoint`. And go back to a previous checkpoint with :guilabel:`Edit->Revert to ...`"
466 msgstr ""
467
468 #: ../../../home/kovid/work/calibre/manual/edit.rst:522
469 msgid "The check pointing functionality is in addition to the normal Undo/redo mechanism when editing individual files. Checkpoints are needed for when changes are spread over multiple files in the book or when you wish to be able to revert a large group of related changes as a whole."
470 msgstr ""
471
472 #: ../../../home/kovid/work/calibre/manual/edit.rst:527
473 msgid "You can see a list of available checkpoints via :guilabel:`View->Checkpoints`. You can compare the current state of the book to a specified checkpoint using the :ref:`diff` tool -- by selecting the checkpoint of interest and clicking the :guilabel:`Compare` button. The :guilabel:`Revert to` button restores the book to the selected checkpoint, undoing all changes since that checkpoint was created."
474 msgstr ""
475
476 #: ../../../home/kovid/work/calibre/manual/edit.rst:535
477 msgid "The Live preview panel"
478 msgstr ""
479
480 #: ../../../home/kovid/work/calibre/manual/edit.rst:537
481 msgid "The Live preview panel showing a rendering of the current file"
482 msgstr ""
483
484 #: ../../../home/kovid/work/calibre/manual/edit.rst:541
485 msgid "The live preview panel shows you the changes you are making live (with a second or two of delay). As you edit HTML or CSS files, the preview panel is updated automatically to reflect your changes. As you move the cursor around in the editor, the preview panel will track its location, showing you the corresponding location in the book. Clicking in the preview panel, will cause the cursor in the editor to be positioned over the element you clicked. If you click a link pointing to another file in the book, that file will be opened in the edit and the preview panel, automatically."
486 msgstr ""
487
488 #: ../../../home/kovid/work/calibre/manual/edit.rst:550
489 msgid "You can turn off the automatic syncing of position and live preview of changes -- by buttons under the preview panel. The live update of the preview panel only happens when you are not actively typing in the editor, so as not to be distracting or slow you down, waiting for the preview to render."
490 msgstr ""
491
492 #: ../../../home/kovid/work/calibre/manual/edit.rst:555
493 msgid "The preview panel shows you how the text will look when viewed. However, the preview panel is not a substitute for actually testing your book on an actual reader device. It is both more, and less capable than an actual reader. It will tolerate errors and sloppy markup much better than most reader devices. It will also not show you page margins, page breaks and embedded fonts that use font name aliasing. Use the preview panel while you are working on the book, but once you are done, review it in an actual reader device or software emulator."
494 msgstr ""
495
496 #: ../../../home/kovid/work/calibre/manual/edit.rst:564
497 msgid "The preview panel does not support embedded fonts if the name of the font inside the font file does not match the name in the CSS @font-face rule. You can use the Check Book tool to quickly find and fix any such problem fonts."
498 msgstr ""
499
500 #: ../../../home/kovid/work/calibre/manual/edit.rst:570
501 msgid "Splitting HTML files"
502 msgstr ""
503
504 #: ../../../home/kovid/work/calibre/manual/edit.rst:574
505 msgid "One, perhaps non-obvious, use of the preview panel is to split long HTML files. While viewing the file you want to split, click the :guilabel:`Split mode` button under the preview panel |spmb|. Then simply move your mouse to the place where you want to split the file and click. A thick green line will show you exactly where the split will happen as you move your mouse. Once you have found the location you want, simply click and the split will be performed."
506 msgstr ""
507
508 #: ../../../home/kovid/work/calibre/manual/edit.rst:572
509 msgid "spmb"
510 msgstr ""
511
512 #: ../../../home/kovid/work/calibre/manual/edit.rst:581
513 msgid "Splitting the file will automatically update all links and references that pointed into the bottom half of the file and will open the newly split file in an editor."
514 msgstr ""
515
516 #: ../../../home/kovid/work/calibre/manual/edit.rst:585
517 msgid "You can also split a single HTML file at multiple locations automatically, by right clicking inside the file in the editor and choosing :guilabel:`Split at multiple locations`. This will allow you to easily split a large file at all heading tags or all tags having a certain class and so on."
518 msgstr ""
519
520 #: ../../../home/kovid/work/calibre/manual/edit.rst:595
521 msgid "The Live CSS panel"
522 msgstr ""
523
524 #: ../../../home/kovid/work/calibre/manual/edit.rst:597
525 msgid "The Live CSS panel showing the styles for the current element"
526 msgstr ""
527
528 #: ../../../home/kovid/work/calibre/manual/edit.rst:602
529 msgid "The :guilabel:`Live CSS` panel shows you all the style rules that apply to the tag you are currently editing. The name of tag, along with its line number in the editor are displayed, followed by a list of matching style rules."
530 msgstr ""
531
532 #: ../../../home/kovid/work/calibre/manual/edit.rst:606
533 msgid "It is a great way to quickly see which style rules apply to any tag. The view also has clickable links (in blue), which take you directly to the location where the style was defined, in case you wish to make any changes to the style rules. Style rules that apply directly to the tag, as well as rules that are inherited from parent tags are shown."
534 msgstr ""
535
536 #: ../../../home/kovid/work/calibre/manual/edit.rst:612
537 msgid "The panel also shows you what the finally calculated styles for the tag are. Properties in the list that are superseded by higher priority rules are shown with a line through them."
538 msgstr ""
539
540 #: ../../../home/kovid/work/calibre/manual/edit.rst:616
541 msgid "You can enable the Live CSS panel via :guilabel:`View->Live CSS`."
542 msgstr ""
543
544 #: ../../../home/kovid/work/calibre/manual/edit.rst:623
545 msgid "Miscellaneous tools"
546 msgstr ""
547
548 #: ../../../home/kovid/work/calibre/manual/edit.rst:625
549 msgid "There are a few more tools that can be useful while you edit the book."
550 msgstr ""
551
552 #: ../../../home/kovid/work/calibre/manual/edit.rst:628
553 msgid "The Table of Contents view"
554 msgstr ""
555
556 #: ../../../home/kovid/work/calibre/manual/edit.rst:630
557 msgid "The Table of Contents view shows you the current table of contents in the book. Double clicking on any entry opens the place that entry points to in an editor. You can right click to edit the Table of Contents, refresh the view or expand/collapse all items. Access this view via :guilabel:`View->Table of Contents`."
558 msgstr ""
559
560 #: ../../../home/kovid/work/calibre/manual/edit.rst:637
561 msgid "Checking the spelling of words in the book"
562 msgstr ""
563
564 #: ../../../home/kovid/work/calibre/manual/edit.rst:639
565 msgid "You can run a spelling checker via :guilabel:`Tools->Check spelling`."
566 msgstr ""
567
568 #: ../../../home/kovid/work/calibre/manual/edit.rst:641
569 msgid "The Check spelling tool"
570 msgstr ""
571
572 #: ../../../home/kovid/work/calibre/manual/edit.rst:646
573 msgid "Words are shown with the number of times they occur in the book and the language the word belongs to. Language information is taken from the books metadata and from ``lang`` attributes in the HTML files. This allows the spell checker to work well even with books that contain text in multiple languages. For example, in the following HTML extract, the word color will be checked using American English and the word colour using British English::"
574 msgstr ""
575
576 #: ../../../home/kovid/work/calibre/manual/edit.rst:656
577 msgid "You can double click a word to highlight the next occurrence of that word in the editor. This is useful if you wish to manually edit the word, or see what context it is in."
578 msgstr ""
579
580 #: ../../../home/kovid/work/calibre/manual/edit.rst:660
581 msgid "To change a word, simply double click one of the suggested alternative spellings on the right, or type in your own corrected spelling and click the :guilabel:`Change selected word to` button. This will replace all occurrences of the word in the book. You can also right click on a word in the main word list to change the word conveniently from the right click menu."
582 msgstr ""
583
584 #: ../../../home/kovid/work/calibre/manual/edit.rst:666
585 msgid "You can have the spelling checker ignore a word for the current session by clicking the :guilabel:`Ignore` button. You can also add a word to the user dictionary by clicking the :guilabel:`Add to dictionary` button. The spelling checker supports multiple user dictionaries, so you can select the dictionary you want the word added to."
586 msgstr ""
587
588 #: ../../../home/kovid/work/calibre/manual/edit.rst:672
589 msgid "You can also have the spelling checker display all the words in your book, not just the incorrectly spelled ones. This is useful to see what words are most common in your book and to run a simple search and replace on individual words."
590 msgstr ""
591
592 #: ../../../home/kovid/work/calibre/manual/edit.rst:677
593 msgid "If you make any changes to the book by editing files while the spell check tool is open, you should click the :guilabel:`Refresh` button in the Spell check tool. If you do not do this and continue to use the Spell check tool, you could lose the changes you have made in the editor."
594 msgstr ""
595
596 #: ../../../home/kovid/work/calibre/manual/edit.rst:683
597 msgid "To exclude an individual file from being spell checked when running the spell check tool, you can use the :guilabel:`Exclude files` button or add the following comment just under the opening tag in the file::"
598 msgstr ""
599
600 #: ../../../home/kovid/work/calibre/manual/edit.rst:691
601 msgid "Adding new dictionaries"
602 msgstr ""
603
604 #: ../../../home/kovid/work/calibre/manual/edit.rst:693
605 msgid "The spelling checker comes with builtin dictionaries for the English and Spanish languages. You can install your own dictionaries via :guilabel:`Preferences->Editor->Manage spelling dictionaries`. The spell checker can use dictionaries from the LibreOffice program (in the .oxt format). You can download these dictionaries from `The LibreOffice Extensions repository <https://extensions.libreoffice.org/?Tags%5B%5D=50>`_."
606 msgstr ""
607
608 #: ../../../home/kovid/work/calibre/manual/edit.rst:702
609 msgid "Inserting special characters"
610 msgstr ""
611
612 #: ../../../home/kovid/work/calibre/manual/edit.rst:704
613 msgid "You can insert characters that are difficult to type by using the :guilabel:`Edit->Insert special character` tool. This shows you all Unicode characters, simply click on the character you want to type. If you hold :kbd:`Ctrl` while clicking, the window will close itself after inserting the selected character. This tool can be used to insert special characters into the main text or into any other area of the user interface, such as the Search and replace tool."
614 msgstr ""
615
616 #: ../../../home/kovid/work/calibre/manual/edit.rst:712
617 msgid "Because there are a lot of characters, you can define your own :guilabel:`Favorite` characters, that will be shown first. Simply right click on a character to mark it as favorite. You can also right click on a character in favorites to remove it from favorites. Finally, you can re-arrange the order of characters in favorites by clicking the :guilabel:`Re-arrange favorites` button and then drag and dropping the characters in favorites around."
618 msgstr ""
619
620 #: ../../../home/kovid/work/calibre/manual/edit.rst:719
621 msgid "You can also directly type in special characters using the keyboard. To do this, you type the Unicode code for the character (in hexadecimal) and then press the :kbd:`Alt+X` key which will convert the previously typed code into the corresponding character. For example, to type ΓΏ you would type ff and then :kbd:`Alt+X`. To type a non-breaking space you would use a0 and then :kbd:`Alt+X`, to type the horizontal ellipsis you would use 2026 and :kbd:`Alt+X` and so on."
622 msgstr ""
623
624 #: ../../../home/kovid/work/calibre/manual/edit.rst:727
625 msgid "Finally, you can type in special characters by using HTML named entities. For example, typing &nbsp; will be replaced by a non breaking space when you type the semi-colon. The replacement happens only when typing the semi-colon."
626 msgstr ""
627
628 #: ../../../home/kovid/work/calibre/manual/edit.rst:732
629 msgid "The code inspector view"
630 msgstr ""
631
632 #: ../../../home/kovid/work/calibre/manual/edit.rst:734
633 msgid "This view shows you the HTML coding and CSS that applies to the current element of interest. You open it by right clicking a location in the preview panel and choosing :guilabel:`Inspect`. It allows you to see the HTML coding for that element and more importantly, the CSS styles that apply to it. You can even dynamically edit the styles and see what effect your changes have instantly. Note that editing the styles does not actually make changes to the book contents, it only allows for quick experimentation. The ability to live edit inside the Inspector is under development."
634 msgstr ""
635
636 #: ../../../home/kovid/work/calibre/manual/edit.rst:744
637 msgid "Checking external links"
638 msgstr ""
639
640 #: ../../../home/kovid/work/calibre/manual/edit.rst:746
641 msgid "You can use this tool to check all links in your book that point to external websites. The tool will try to visit every externally linked website, and if the visit fails, it will report all broken links in a convenient format for you to fix."
642 msgstr ""
643
644 #: ../../../home/kovid/work/calibre/manual/edit.rst:753
645 msgid "Downloading external resources"
646 msgstr ""
647
648 #: ../../../home/kovid/work/calibre/manual/edit.rst:755
649 msgid "You can use this tool to automatically download any images/stylesheets/etc. in the book that are not bundled with the book (i.e. they have URLs pointing to a location on the internet). The tool will find all such resources and automatically download them, add them to the book and replace all references to them to use the downloaded files."
650 msgstr ""
651
652 #: ../../../home/kovid/work/calibre/manual/edit.rst:763
653 msgid "Arranging files into folders by type"
654 msgstr ""
655
656 #: ../../../home/kovid/work/calibre/manual/edit.rst:765
657 msgid "Often when editing EPUB files that you get from somewhere, you will find that the files inside the EPUB are arranged haphazardly, in different sub-folders. This tool allows you to automatically move all files into sub-folders based on their types. Access it via :guilabel:`Tools->Arrange into folders`. Note that this tool only changes how the files are arranged inside the EPUB, it does not change how they are displayed in the File browser."
658 msgstr ""
659
660 #: ../../../home/kovid/work/calibre/manual/edit.rst:773
661 msgid "Importing files in other e-book formats as EPUB"
662 msgstr ""
663
664 #: ../../../home/kovid/work/calibre/manual/edit.rst:775
665 msgid "The editor includes the ability to import files in some other e-book formats directly as a new EPUB, without going through a full conversion. This is particularly useful to directly create EPUB files from your own hand-edited HTML files. You can do this via :guilabel:`File->Import an HTML or DOCX file as a new book`."
666 msgstr ""
667
668 #: ../../../home/kovid/work/calibre/manual/edit.rst:788
669 msgid "The Reports tool"
670 msgstr ""
671
672 #: ../../../home/kovid/work/calibre/manual/edit.rst:790
673 msgid "The editor includes a nice *Reports* tool (via :guilabel:`Tools->Reports`) that shows summaries of the files, images, links, words, characters and styles used in the book. Every line in the report is hot-linked. Double clicking a line jumps to the place in the book where that item is used or defined (as appropriate). For example, in the :guilabel:`Links` view, you can double click entries in the :guilabel:`Source` column to jump to where the link is defined and entries in the :guilabel:`Target` column to jump to where the link points."
674 msgstr ""
675
676 #: ../../../home/kovid/work/calibre/manual/edit.rst:798
677 msgid "The Reports tool with information and statistics about the book"
678 msgstr ""
679
680 #: ../../../home/kovid/work/calibre/manual/edit.rst:805
681 msgid "Special features in the code editor"
682 msgstr ""
683
684 #: ../../../home/kovid/work/calibre/manual/edit.rst:807
685 msgid "The calibre HTML editor is very powerful. It has many features that make editing of HTML (and CSS) easier."
686 msgstr ""
687
688 #: ../../../home/kovid/work/calibre/manual/edit.rst:811
689 msgid "Syntax highlighting"
690 msgstr ""
691
692 #: ../../../home/kovid/work/calibre/manual/edit.rst:813
693 msgid "The HTML editor has very sophisticated syntax highlighting. Features include:"
694 msgstr ""
695
696 #: ../../../home/kovid/work/calibre/manual/edit.rst:815
697 msgid "The text inside bold, italic and heading tags is made bold/italic"
698 msgstr ""
699
700 #: ../../../home/kovid/work/calibre/manual/edit.rst:816
701 msgid "As you move your cursor through the HTML, the matching HTML tags are highlighted, and you can jump to the opening or closing tag with the keyboard shortcuts :kbd:`Ctrl+{` and :kbd:`Ctrl+}`. Similarly, you can select the contents of a tag with :kbd:`Ctrl+Alt+T` or :kbd:`Ctrl+Shift+T`."
702 msgstr ""
703
704 #: ../../../home/kovid/work/calibre/manual/edit.rst:821
705 msgid "Invalid HTML is highlighted with a red underline"
706 msgstr ""
707
708 #: ../../../home/kovid/work/calibre/manual/edit.rst:822
709 msgid "Spelling errors in the text inside HTML tags and attributes such as title are highlighted. The spell checking is language aware, based on the value of the ``lang`` attribute of the current tag and the overall book language."
710 msgstr ""
711
712 #: ../../../home/kovid/work/calibre/manual/edit.rst:825
713 msgid "CSS embedded inside ``<style>`` tags is highlighted"
714 msgstr ""
715
716 #: ../../../home/kovid/work/calibre/manual/edit.rst:826
717 msgid "Special characters that can be hard to distinguish such as non-breaking spaces, different types of hyphens, etc. are highlighted."
718 msgstr ""
719
720 #: ../../../home/kovid/work/calibre/manual/edit.rst:828
721 msgid "Links to other files in ``<a>`` tags, ``<img>`` and ``<link>`` tags all have the filenames highlighted. If the filename they point to does not exist, the filename is marked with a red underline."
722 msgstr ""
723
724 #: ../../../home/kovid/work/calibre/manual/edit.rst:833
725 msgid "Context sensitive help"
726 msgstr ""
727
728 #: ../../../home/kovid/work/calibre/manual/edit.rst:835
729 msgid "You can right click on an HTML tag name or a CSS property name to get help for that tag or property."
730 msgstr ""
731
732 #: ../../../home/kovid/work/calibre/manual/edit.rst:837
733 msgid "You can also hold down the :kbd:`Ctrl` key and click on any filename inside a link tag to open that file in the editor automatically. Similarly, :kbd:`Ctrl` clicking a class name will take you to the first style rule that matches the tag and class."
734 msgstr ""
735
736 #: ../../../home/kovid/work/calibre/manual/edit.rst:841
737 msgid "Right clicking a class name in an HTML file will allow you to rename the class, changing all occurrences of the class throughout the book and all its stylesheets."
738 msgstr ""
739
740 #: ../../../home/kovid/work/calibre/manual/edit.rst:848
741 msgid "Auto-complete"
742 msgstr ""
743
744 #: ../../../home/kovid/work/calibre/manual/edit.rst:850
745 msgid "When editing an e-book, one of the most tedious tasks is creating links to other files inside the book, or to CSS stylesheets, or images. You have to figure out the correct filename and relative path to the file. The editor has auto-complete to make that easier."
746 msgstr ""
747
748 #: ../../../home/kovid/work/calibre/manual/edit.rst:855
749 msgid "As you type a filename, the editor automatically pops up suggestions. Simply use the :kbd:`Tab` key to select the correct file name. The editor even offers suggestions for links pointing to an anchor inside another HTML file. After you type the ``#`` character, the editor will show you a list of all anchors in the target file, with a small snippet of text to help you choose the right anchor."
750 msgstr ""
751
752 #: ../../../home/kovid/work/calibre/manual/edit.rst:861
753 msgid "Note that unlike most other completion systems, the editor's completion system uses subsequence matching. This means that you can type just two or three letters from anywhere in the filename to complete the filename. For example, say you want the filename ``../images/arrow1.png``, you can simply type ``ia1`` and press :kbd:`Tab` to complete the filename. When searching for matches, the completion system prioritizes letters that are at the start of a word, or immediately after a path separator. Once you get used to this system, you will find it saves you a lot of time and effort."
754 msgstr ""
755
756 #: ../../../home/kovid/work/calibre/manual/edit.rst:871
757 msgid "Snippets"
758 msgstr ""
759
760 #: ../../../home/kovid/work/calibre/manual/edit.rst:873
761 msgid "The calibre E-book editor supports *snippets*. A snippet is a piece of text that is either re-used often or contains a lot of redundant text. The editor allows you to insert a snippet with only a few key strokes. The snippets are very powerful, with many features, such as placeholders you can jump between, automatic mirroring of repeated text and so on. For more information, see :doc:`snippets`."
762 msgstr ""