Debian Codegraph @

translations/manual/fa/edit.po

raw
1 # SOME DESCRIPTIVE TITLE.
2 # Copyright (C) Kovid Goyal
3 # This file is distributed under the same license as the calibre package.
4 #
5 # Translators:
6 msgid ""
7 msgstr ""
8 "Project-Id-Version: calibre\n"
9 "Report-Msgid-Bugs-To: \n"
10 "POT-Creation-Date: 2025-09-17 17:36+0000\n"
11 "PO-Revision-Date: 2016-02-29 11:58+0000\n"
12 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
13 "Language-Team: Persian (http://app.transifex.com/calibre/calibre/language/fa/)\n"
14 "MIME-Version: 1.0\n"
15 "Content-Type: text/plain; charset=UTF-8\n"
16 "Content-Transfer-Encoding: 8bit\n"
17 "Language: fa\n"
18 "Plural-Forms: nplurals=2; plural=(n > 1);\n"
19
20 #: ../../../__w/calibre/calibre/manual/edit.rst:4
21 msgid "Editing e-books"
22 msgstr ""
23
24 #: ../../../__w/calibre/calibre/manual/edit.rst:6
25 msgid ""
26 "calibre has an integrated e-book editor that can be used to edit books in "
27 "the EPUB, KEPUB (Kobo) and AZW3 (Kindle) formats. The editor shows you the "
28 "HTML and CSS that is used internally inside the book files, with a live "
29 "preview that updates as you make changes. It also contains various automated"
30 " tools to perform common cleanup and fixing tasks."
31 msgstr ""
32
33 #: ../../../__w/calibre/calibre/manual/edit.rst:12
34 msgid ""
35 "You can use this editor by right clicking on any book in calibre and "
36 "selecting :guilabel:`Edit book`."
37 msgstr ""
38
39 #: ../../../__w/calibre/calibre/manual/edit.rst:15
40 #: ../../../__w/calibre/calibre/manual/edit.rst:230
41 msgid "The Edit book tool"
42 msgstr ""
43
44 #: ../../../__w/calibre/calibre/manual/edit.rst:23
45 msgid "Contents"
46 msgstr ""
47
48 #: ../../../__w/calibre/calibre/manual/edit.rst:26
49 msgid "Basic workflow"
50 msgstr ""
51
52 #: ../../../__w/calibre/calibre/manual/edit.rst:29
53 msgid ""
54 "A video tour of the calibre E-book editor is available :website:`here "
55 "<demo#tutorials>`."
56 msgstr ""
57
58 #: ../../../__w/calibre/calibre/manual/edit.rst:31
59 msgid ""
60 "When you first open a book with the Edit book tool, you will be presented "
61 "with a list of files on the left. These are the individual HTML files, "
62 "stylesheets, images, etc. that make up the content of the book. Simply "
63 "double click on a file to start editing it. Note that if you want to do "
64 "anything more sophisticated than making a few small tweaks, you will need to"
65 " know `HTML Tutorial <https://www.w3schools.com/Html/default.asp>`_ and `CSS"
66 " Tutorial <https://www.w3schools.com/css/default.asp>`_."
67 msgstr ""
68
69 #: ../../../__w/calibre/calibre/manual/edit.rst:39
70 msgid ""
71 "As you make changes to the HTML or CSS in the editor, the changes will be "
72 "previewed, live, in the preview panel to the right. When you are happy with "
73 "how the changes you have made look, click the :guilabel:`Save` button or use"
74 " :guilabel:`File->Save` to save your changes into the e-book."
75 msgstr ""
76
77 #: ../../../__w/calibre/calibre/manual/edit.rst:44
78 msgid ""
79 "One useful feature is :guilabel:`Checkpoints`. Before you embark on some "
80 "ambitious set of edits, you can create a checkpoint. The checkpoint will "
81 "preserve the current state of your book, then if in the future you decide "
82 "you don't like the changes you have made to you can go back to the state "
83 "when you created the checkpoint. To create a checkpoint, use "
84 ":guilabel:`Edit->Create checkpoint`. Checkpoints will also be automatically "
85 "created for you whenever you run any automated tool like global search and "
86 "replace. The checkpointing functionality is in addition to the normal "
87 "undo/redo mechanism when editing individual files. Checkpoints are needed "
88 "for when changes are spread over multiple files in the book."
89 msgstr ""
90
91 #: ../../../__w/calibre/calibre/manual/edit.rst:55
92 msgid ""
93 "That is the basic work flow for editing books -- Open a file, make changes, "
94 "preview and save. The rest of this manual will discuss the various tools and"
95 " features present to allow you to perform specific tasks efficiently."
96 msgstr ""
97
98 #: ../../../__w/calibre/calibre/manual/edit.rst:60
99 msgid "The File browser"
100 msgstr ""
101
102 #: ../../../__w/calibre/calibre/manual/edit.rst:62
103 msgid "The File browser showing files in the book"
104 msgstr ""
105
106 #: ../../../__w/calibre/calibre/manual/edit.rst:66
107 msgid ""
108 "The :guilabel:`File browser` gives you an overview of the various files "
109 "inside the book you are editing. The files are arranged by category, with "
110 "text (HTML) files at the top, followed by stylesheet (CSS) files, images and"
111 " so on. Simply double click on a file to start editing it. Editing is "
112 "supported for HTML, CSS and image files. The order of text files is the same"
113 " order that they would be displayed in, if you were reading the book. All "
114 "other files are arranged alphabetically."
115 msgstr ""
116
117 #: ../../../__w/calibre/calibre/manual/edit.rst:74
118 msgid ""
119 "By hovering your mouse over an entry, you can see its size, and also, at the"
120 " bottom of the screen, the full path to the file inside the book. Note that "
121 "files inside e-books are compressed, so the size of the final book is not "
122 "the sum of the individual file sizes."
123 msgstr ""
124
125 #: ../../../__w/calibre/calibre/manual/edit.rst:79
126 msgid ""
127 "Many files have special meaning, in the book. These will typically have an "
128 "icon next to their names, indicating the special meaning. For example, in "
129 "the picture to the left, you can see that the files "
130 ":guilabel:`cover_image.jpg` and :guilabel:`titlepage.xhtml` have the icon of"
131 " a cover next to them, this indicates they are the book cover image and "
132 "titlepage. Similarly, the :guilabel:`content.opf` file has a metadata icon "
133 "next to it, indicating the book metadata is present in it and the "
134 ":guilabel:`toc.ncx` file has a T icon next to it, indicating it is the Table"
135 " of Contents."
136 msgstr ""
137
138 #: ../../../__w/calibre/calibre/manual/edit.rst:88
139 msgid ""
140 "You can perform many actions on individual files, by right clicking them."
141 msgstr ""
142
143 #: ../../../__w/calibre/calibre/manual/edit.rst:91
144 msgid "Renaming files"
145 msgstr ""
146
147 #: ../../../__w/calibre/calibre/manual/edit.rst:93
148 msgid ""
149 "You can rename an individual file by right clicking it and selecting "
150 ":guilabel:`Rename`. Renaming a file automatically updates all links and "
151 "references to it throughout the book. So all you have to do is provide the "
152 "new name, calibre will take care of the rest."
153 msgstr ""
154
155 #: ../../../__w/calibre/calibre/manual/edit.rst:98
156 msgid ""
157 "You can also bulk rename many files at once. This is useful if you want the "
158 "files to have some simple name pattern. For example you might want to rename"
159 " all the HTML files to have names Chapter-1.html, Chapter-2.html and so on. "
160 "Select the files you want bulk renamed by holding down the :kbd:`Shift` or "
161 ":kbd:`Ctrl` key and clicking the files. Then right click and select "
162 ":guilabel:`Bulk rename`. Enter a prefix and what number you would like the "
163 "automatic numbering to start at, click OK and you are done. The bulk rename "
164 "dialog also lets you rename files by the order they appear in the book "
165 "instead of the order you selected them in, useful, for instance to rename "
166 "all images by the order they appear."
167 msgstr ""
168
169 #: ../../../__w/calibre/calibre/manual/edit.rst:109
170 msgid ""
171 "Finally, you can bulk change the file extension for all selected files. "
172 "Select multiple files, as above, and right click and choose "
173 ":guilabel:`Change the file extension for the selected files`."
174 msgstr ""
175
176 #: ../../../__w/calibre/calibre/manual/edit.rst:114
177 msgid "Merging files"
178 msgstr ""
179
180 #: ../../../__w/calibre/calibre/manual/edit.rst:116
181 msgid ""
182 "Sometimes, you may want to merge two HTML files or two CSS files together. "
183 "It can sometimes be useful to have everything in a single file. Be wary, "
184 "though, putting a lot of content into a single file will cause performance "
185 "problems when viewing the book in a typical e-book reader."
186 msgstr ""
187
188 #: ../../../__w/calibre/calibre/manual/edit.rst:121
189 msgid ""
190 "To merge multiple files together, select them by holding the :kbd:`Ctrl` key"
191 " and clicking on them (make sure you only select files of one type, either "
192 "all HTML files or all CSS files and so on). Then right click and select "
193 "merge. That's all, calibre will merge the files, automatically taking care "
194 "of migrating all links and references to the merged files. Note that merging"
195 " files can sometimes cause text styling to change, since the individual "
196 "files could have used different stylesheets."
197 msgstr ""
198
199 #: ../../../__w/calibre/calibre/manual/edit.rst:129
200 msgid ""
201 "You can also select text files and then drag and drop the text files onto "
202 "another text file to merge the dropped text files into the target text file."
203 msgstr ""
204
205 #: ../../../__w/calibre/calibre/manual/edit.rst:133
206 msgid "Changing text file order"
207 msgstr ""
208
209 #: ../../../__w/calibre/calibre/manual/edit.rst:135
210 msgid ""
211 "You can re-arrange the order in which text (HTML) files are opened when "
212 "reading the book by simply dragging and dropping them in the :guilabel:`File"
213 " browser` or clicking on the file to move and then pressing the "
214 ":kbd:`Ctrl+Shift` modifiers with the :kbd:`Up`, :kbd:`Down`, :kbd:`Home` or "
215 ":kbd:`End` keys. For the technically inclined, this is called re-ordering "
216 "the book spine."
217 msgstr ""
218
219 #: ../../../__w/calibre/calibre/manual/edit.rst:141
220 msgid ""
221 "Note that you have to drop the items *between* other items, not on top of "
222 "them, this can be a little fiddly until you get used to it. Dropping on top "
223 "of another file will cause the files to be merged."
224 msgstr ""
225
226 #: ../../../__w/calibre/calibre/manual/edit.rst:146
227 msgid "Marking the cover"
228 msgstr ""
229
230 #: ../../../__w/calibre/calibre/manual/edit.rst:148
231 msgid ""
232 "E-books typically have a cover image. This image is indicated in the "
233 ":guilabel:`File browser` by the icon of a brown book next to the image name."
234 " If you want to designate some other image as the cover, you can do so by "
235 "right clicking on the file and choosing :guilabel:`Mark as cover`."
236 msgstr ""
237
238 #: ../../../__w/calibre/calibre/manual/edit.rst:153
239 msgid ""
240 "In addition, EPUB files has the concept of a *titlepage*. A title page is a "
241 "HTML file that acts as the title page/cover for the book. You can mark an "
242 "HTML file as the titlepage when editing EPUBs by right-clicking. Be careful "
243 "that the file you mark contains only the cover information. If it contains "
244 "other content, such as the first chapter, then that content will be lost if "
245 "the user ever converts the EPUB file in calibre to another format. This is "
246 "because when converting, calibre assumes that the marked title page contains"
247 " only the cover and no other content."
248 msgstr ""
249
250 #: ../../../__w/calibre/calibre/manual/edit.rst:163
251 msgid "Deleting files"
252 msgstr ""
253
254 #: ../../../__w/calibre/calibre/manual/edit.rst:165
255 msgid ""
256 "You can delete files by either right clicking on them or by selecting them "
257 "and pressing the Delete key. Deleting a file removes all references to the "
258 "file from the OPF file, saving you that chore. However, references in other "
259 "places are not removed, you can use the Check Book tool to easily find and "
260 "remove/replace them."
261 msgstr ""
262
263 #: ../../../__w/calibre/calibre/manual/edit.rst:172
264 msgid "Exporting files"
265 msgstr ""
266
267 #: ../../../__w/calibre/calibre/manual/edit.rst:174
268 msgid ""
269 "You can export a file from inside the book to somewhere else on your "
270 "computer. This is useful if you want to work on the file in isolation, with "
271 "specialised tools. To do this, simply right click on the file and choose "
272 ":guilabel:`Export`."
273 msgstr ""
274
275 #: ../../../__w/calibre/calibre/manual/edit.rst:179
276 msgid ""
277 "Once you are done working on the exported file, you can re-import it into "
278 "the book, by right clicking on the file again and choosing "
279 ":guilabel:`Replace with file...` which will allow you to replace the file in"
280 " the book with the previously exported file."
281 msgstr ""
282
283 #: ../../../__w/calibre/calibre/manual/edit.rst:184
284 msgid ""
285 "You can also copy files between multiple editor instances. Select the files "
286 "you want to copy in the :guilabel:`File browser`, then right click and "
287 "choose, :guilabel:`Copy selected files to another editor instance`. Then, in"
288 " the other editor instance, right click in the :guilabel:`File browser` and "
289 "choose :guilabel:`Paste file from other editor instance`."
290 msgstr ""
291
292 #: ../../../__w/calibre/calibre/manual/edit.rst:191
293 msgid "Adding new images/fonts/etc. or creating new blank files"
294 msgstr ""
295
296 #: ../../../__w/calibre/calibre/manual/edit.rst:193
297 msgid ""
298 "You can add a new image, font, stylesheet, etc. from your computer into the "
299 "book by clicking :guilabel:`File->New file`. This lets you either import a "
300 "file by clicking the :guilabel:`Import resource file` button or create a new"
301 " blank HTML file or stylesheet by simply entering the file name into the box"
302 " for the new file."
303 msgstr ""
304
305 #: ../../../__w/calibre/calibre/manual/edit.rst:198
306 msgid ""
307 "You can also import multiple files into the book at once using File->Import "
308 "files into book."
309 msgstr ""
310
311 #: ../../../__w/calibre/calibre/manual/edit.rst:202
312 msgid "Replacing files"
313 msgstr ""
314
315 #: ../../../__w/calibre/calibre/manual/edit.rst:204
316 msgid ""
317 "You can easily replace existing files in the book, by right clicking on the "
318 "file and choosing replace. This will automatically update all links and "
319 "references, in case the replacement file has a different name than the file "
320 "being replaced."
321 msgstr ""
322
323 #: ../../../__w/calibre/calibre/manual/edit.rst:210
324 msgid "Linking stylesheets to HTML files efficiently"
325 msgstr ""
326
327 #: ../../../__w/calibre/calibre/manual/edit.rst:212
328 msgid ""
329 "As a convenience, you can select multiple HTML files in the File browser, "
330 "right click and choose Link stylesheets to have calibre automatically insert"
331 " the <link> tags for those stylesheets into all the selected HTML files."
332 msgstr ""
333
334 #: ../../../__w/calibre/calibre/manual/edit.rst:222
335 msgid "Search & replace"
336 msgstr "Search & replace"
337
338 #: ../../../__w/calibre/calibre/manual/edit.rst:224
339 msgid ""
340 "Edit book has a very powerful search and replace interface that allows you "
341 "to search and replace text in the current file, across all files and even in"
342 " a marked region of the current file. You can search using a normal search "
343 "or using regular expressions. To learn how to use regular expressions for "
344 "advanced searching, see :ref:`regexptutorial`."
345 msgstr ""
346
347 #: ../../../__w/calibre/calibre/manual/edit.rst:234
348 msgid ""
349 "Start the search and replace via the :guilabel:`Search->Find/replace` menu "
350 "entry (you must be editing an HTML or CSS file)."
351 msgstr ""
352
353 #: ../../../__w/calibre/calibre/manual/edit.rst:237
354 msgid ""
355 "Type the text you want to find into the Find box and its replacement into "
356 "the Replace box. You can the click the appropriate buttons to Find the next "
357 "match, replace the current match and replace all matches."
358 msgstr ""
359
360 #: ../../../__w/calibre/calibre/manual/edit.rst:241
361 msgid ""
362 "Using the drop downs at the bottom of the box, you can have the search "
363 "operate over the current file, all text files, all style files or all files."
364 " You can also choose the search mode to be a normal (string) search or a "
365 "regular expression search."
366 msgstr ""
367
368 #: ../../../__w/calibre/calibre/manual/edit.rst:246
369 msgid ""
370 "You can count all the matches for a search expression via "
371 ":guilabel:`Search->Count all`. The count will run over whatever "
372 "files/regions you have selected in the dropdown box."
373 msgstr ""
374
375 #: ../../../__w/calibre/calibre/manual/edit.rst:250
376 msgid ""
377 "You can also go to a specific line in the currently open editor via "
378 ":guilabel:`Search->Go to line`."
379 msgstr ""
380
381 #: ../../../__w/calibre/calibre/manual/edit.rst:254
382 msgid ""
383 "Remember, to harness the full power of search and replace, you will need to "
384 "use regular expressions. See :ref:`regexptutorial`."
385 msgstr ""
386
387 #: ../../../__w/calibre/calibre/manual/edit.rst:258
388 msgid "Saved searches"
389 msgstr ""
390
391 #: ../../../__w/calibre/calibre/manual/edit.rst:260
392 msgid ""
393 "You can save frequently used search/replace expressions (including function "
394 "mode expressions) and reuse them multiple times. To save a search simply "
395 "right click in the Find box and select :guilabel:`Save current search`."
396 msgstr ""
397
398 #: ../../../__w/calibre/calibre/manual/edit.rst:264
399 msgid ""
400 "You can bring up the saved searches via :guilabel:`Search->Saved searches`. "
401 "This will present you with a list of search and replace expressions that you"
402 " can apply. You can even select multiple entries in the list by holding down"
403 " the :kbd:`Ctrl` key while clicking so as to run multiple search and replace"
404 " expressions in a single operation."
405 msgstr ""
406
407 #: ../../../__w/calibre/calibre/manual/edit.rst:271
408 msgid "Function mode"
409 msgstr ""
410
411 #: ../../../__w/calibre/calibre/manual/edit.rst:273
412 msgid ""
413 "Function mode allows you to write arbitrarily powerful Python functions that"
414 " are run on every Find/replace. You can do pretty much any text manipulation"
415 " you like in function mode. For more information, see :doc:`function_mode`."
416 msgstr ""
417
418 #: ../../../__w/calibre/calibre/manual/edit.rst:278
419 msgid "Search ignoring HTML tags"
420 msgstr ""
421
422 #: ../../../__w/calibre/calibre/manual/edit.rst:280
423 msgid ""
424 "There is also a dedicated tool for searching for text, ignoring any HTML "
425 "tags in between. For example, if the book has the HTML ``Empahisis on a "
426 "<i>word</i>.`` you can search for ``on a word`` and it will be found even "
427 "though there is an ``<i>`` tag in the middle. Use this tool via the "
428 ":guilabel:`Search->Search ignoring HTML markup` menu item."
429 msgstr ""
430
431 #: ../../../__w/calibre/calibre/manual/edit.rst:287
432 msgid "Automated tools"
433 msgstr ""
434
435 #: ../../../__w/calibre/calibre/manual/edit.rst:289
436 msgid ""
437 "Edit book has various tools to help with common tasks. These are accessed "
438 "via the :guilabel:`Tools` menu."
439 msgstr ""
440
441 #: ../../../__w/calibre/calibre/manual/edit.rst:293
442 msgid "Editing the Table of Contents"
443 msgstr ""
444
445 #: ../../../__w/calibre/calibre/manual/edit.rst:295
446 msgid ""
447 "There is a dedicated tool to ease editing of the Table of Contents. Launch "
448 "it with :guilabel:`Tools->Table of Contents->Edit Table of Contents`."
449 msgstr ""
450
451 #: ../../../__w/calibre/calibre/manual/edit.rst:298
452 msgid "The Edit Table of Contents tool"
453 msgstr ""
454
455 #: ../../../__w/calibre/calibre/manual/edit.rst:302
456 msgid ""
457 "The Edit Table of Contents tool shows you the current Table of Contents (if "
458 "any) on the left. Simply double click on any entry to change its text. You "
459 "can also re-arrange entries by drag and drop or by using the buttons to the "
460 "right."
461 msgstr ""
462
463 #: ../../../__w/calibre/calibre/manual/edit.rst:306
464 msgid ""
465 "For books that do not have a pre-existing Table of Contents, the tool gives "
466 "you various options to auto-generate a Table of Contents from the text. You "
467 "can generate from the headings in the document, from links, from individual "
468 "files and so on."
469 msgstr ""
470
471 #: ../../../__w/calibre/calibre/manual/edit.rst:311
472 msgid ""
473 "You can edit individual entries by clicking on them and then clicking the "
474 ":guilabel:`Change the location this entry points to` button. This will open "
475 "up a mini-preview of the book, simply move the mouse cursor over the book "
476 "view panel, and click where you want the entry to point to. A thick green "
477 "line will show you the location. Click OK once you are happy with the "
478 "location."
479 msgstr ""
480
481 #: ../../../__w/calibre/calibre/manual/edit.rst:317
482 msgid ""
483 "The Edit Table of Contents tool, how to change the location an entry points "
484 "to"
485 msgstr ""
486
487 #: ../../../__w/calibre/calibre/manual/edit.rst:322
488 msgid "Checking the book"
489 msgstr ""
490
491 #: ../../../__w/calibre/calibre/manual/edit.rst:324
492 msgid ""
493 "The :guilabel:`Check book` tool searches your book for problems that could "
494 "prevent it working as intended on actual reader devices. Activate it via "
495 ":guilabel:`Tools->Check book`."
496 msgstr ""
497
498 #: ../../../__w/calibre/calibre/manual/edit.rst:328
499 msgid "The Check book tool"
500 msgstr ""
501
502 #: ../../../__w/calibre/calibre/manual/edit.rst:332
503 msgid ""
504 "Any problems found are reported in a nice, easy to use list. Clicking any "
505 "entry in the list shows you some help about that error as well as giving you"
506 " the option to auto-fix that error, if the error can be fixed automatically."
507 " You can also double click the error to open the location of the error in an"
508 " editor, so you can fix it yourself."
509 msgstr ""
510
511 #: ../../../__w/calibre/calibre/manual/edit.rst:339
512 msgid "Some of the checks performed are:"
513 msgstr ""
514
515 #: ../../../__w/calibre/calibre/manual/edit.rst:341
516 msgid ""
517 "Malformed HTML markup. Any HTML markup that does not parse as well-formed "
518 "XML is reported. Correcting it will ensure that your markup works as "
519 "intended in all contexts. calibre can also auto-fix these errors, but auto-"
520 "fixing can sometimes have unexpected effects, so use with care. As always, a"
521 " checkpoint is created before auto-fixing so you can easily revert all "
522 "changes. Auto-fixing works by parsing the markup using the HTML5 algorithm, "
523 "which is highly fault tolerant and then converting to well formed XML."
524 msgstr ""
525
526 #: ../../../__w/calibre/calibre/manual/edit.rst:350
527 msgid ""
528 "Malformed or unknown CSS styles. Any CSS that is not valid or that has "
529 "properties not defined in the CSS 2.1 standard (plus a few from CSS 3) are "
530 "reported. CSS is checked in all stylesheets, inline style attributes and "
531 "<style> tags in HTML files."
532 msgstr ""
533
534 #: ../../../__w/calibre/calibre/manual/edit.rst:355
535 msgid ""
536 "Broken links. Links that point to files inside the book that are missing are"
537 " reported."
538 msgstr ""
539
540 #: ../../../__w/calibre/calibre/manual/edit.rst:358
541 msgid ""
542 "Unreferenced files. Files in the book that are not referenced by any other "
543 "file or are not in the spine are reported."
544 msgstr ""
545
546 #: ../../../__w/calibre/calibre/manual/edit.rst:361
547 msgid ""
548 "Various common problems in OPF files such as duplicate spine or manifest "
549 "items, broken idrefs or meta cover tags, missing required sections and so "
550 "on."
551 msgstr ""
552
553 #: ../../../__w/calibre/calibre/manual/edit.rst:365
554 msgid ""
555 "Various compatibility checks for known problems that can cause the book to "
556 "malfunction on reader devices."
557 msgstr ""
558
559 #: ../../../__w/calibre/calibre/manual/edit.rst:369
560 msgid "Adding a cover"
561 msgstr ""
562
563 #: ../../../__w/calibre/calibre/manual/edit.rst:371
564 msgid ""
565 "You can easily add a cover to the book via :guilabel:`Tools->Add cover`. "
566 "This allows you to either choose an existing image in the book as the cover "
567 "or import a new image into the book and make it the cover. When editing EPUB"
568 " files, the HTML wrapper for the cover is automatically generated. If an "
569 "existing cover in the book is found, it is replaced. The tool also "
570 "automatically takes care of correctly marking the cover files as covers in "
571 "the OPF."
572 msgstr ""
573
574 #: ../../../__w/calibre/calibre/manual/edit.rst:380
575 msgid "Embedding referenced fonts"
576 msgstr ""
577
578 #: ../../../__w/calibre/calibre/manual/edit.rst:382
579 msgid ""
580 "Accessed via :guilabel:`Tools->Embed reference fonts`, this tool finds all "
581 "fonts referenced in the book and if they are not already embedded, searches "
582 "your computer for them and embeds them into the book, if found. Please make "
583 "sure that you have the necessary copyrights for embedding commercially "
584 "licensed fonts, before doing this."
585 msgstr ""
586
587 #: ../../../__w/calibre/calibre/manual/edit.rst:389
588 msgid "Subsetting embedded fonts"
589 msgstr ""
590
591 #: ../../../__w/calibre/calibre/manual/edit.rst:391
592 msgid ""
593 "Accessed via :guilabel:`Tools->Subset embedded fonts`, this tool reduces all"
594 " the fonts in the book to only contain glyphs for the text actually present "
595 "in the book. This commonly reduces the size of the font files by ~ 50%. "
596 "However, be aware that once the fonts are subset, if you add new text whose "
597 "characters are not previously present in the subset font, the font will not "
598 "work for the new text. So do this only as the last step in your workflow."
599 msgstr ""
600
601 #: ../../../__w/calibre/calibre/manual/edit.rst:399
602 msgid "Smartening punctuation"
603 msgstr ""
604
605 #: ../../../__w/calibre/calibre/manual/edit.rst:401
606 msgid ""
607 "Convert plain text dashes, ellipsis, quotes, multiple hyphens, etc. into "
608 "their typographically correct equivalents. Note that the algorithm can "
609 "sometimes generate incorrect results, especially when single quotes at the "
610 "start of contractions are involved. Accessed via :guilabel:`Tools->Smarten "
611 "punctuation`."
612 msgstr ""
613
614 #: ../../../__w/calibre/calibre/manual/edit.rst:408
615 msgid "Transforming CSS properties"
616 msgstr ""
617
618 #: ../../../__w/calibre/calibre/manual/edit.rst:410
619 msgid ""
620 "Create rules to transform the styling of the book. For example, create a "
621 "rule to convert all red text to green or to double the font size of all text"
622 " in the book or make text of a certain font family italic, etc."
623 msgstr ""
624
625 #: ../../../__w/calibre/calibre/manual/edit.rst:414
626 msgid ""
627 "Creating the rules is simple, the rules follow a natural language format, "
628 "that looks like:"
629 msgstr ""
630
631 #: ../../../__w/calibre/calibre/manual/edit.rst:417
632 msgid "If the property *color* is *red* *change* it to *green*"
633 msgstr ""
634
635 #: ../../../__w/calibre/calibre/manual/edit.rst:418
636 msgid "If the property *font-size* is *any value* *multiply* the value by *2*"
637 msgstr ""
638
639 #: ../../../__w/calibre/calibre/manual/edit.rst:420
640 msgid "Accessed via :guilabel:`Tools->Transform styles`."
641 msgstr ""
642
643 #: ../../../__w/calibre/calibre/manual/edit.rst:423
644 msgid "Removing unused CSS rules"
645 msgstr ""
646
647 #: ../../../__w/calibre/calibre/manual/edit.rst:425
648 msgid ""
649 "Remove all unused CSS rules from stylesheets and <style> tags. Some books "
650 "created from production templates can have a large number of extra CSS rules"
651 " that don't match any actual content. These extra rules can slow down "
652 "readers that need to process them all. Accessed via :guilabel:`Tools->Remove"
653 " unused CSS`."
654 msgstr ""
655
656 #: ../../../__w/calibre/calibre/manual/edit.rst:432
657 msgid "Fixing HTML"
658 msgstr ""
659
660 #: ../../../__w/calibre/calibre/manual/edit.rst:434
661 msgid ""
662 "This tool simply converts HTML that cannot be parsed as XML into well-formed"
663 " XML. It is very common in e-books to have non-well-formed XML, so this tool"
664 " simply automates the process of fixing such HTML. The tool works by parsing"
665 " the HTML using the HTML5 algorithm (the algorithm used in all modern "
666 "browsers) and then converting the result into XML. Be aware that auto-fixing"
667 " can sometimes have counter-intuitive results. If you prefer, you can use "
668 "the Check Book tool discussed above to find and manually correct problems in"
669 " the HTML. Accessed via :guilabel:`Tools->Fix HTML`."
670 msgstr ""
671
672 #: ../../../__w/calibre/calibre/manual/edit.rst:444
673 msgid "Beautifying files"
674 msgstr ""
675
676 #: ../../../__w/calibre/calibre/manual/edit.rst:446
677 msgid ""
678 "This tool is used to auto-format all HTML and CSS files so that they \"look "
679 "pretty\". The code is auto-indented so that it lines up nicely, blank lines "
680 "are inserted where appropriate and so on. Note that beautifying also auto-"
681 "fixes broken HTML/CSS. Therefore, if you don't want any auto-fixing to be "
682 "performed, first use the Check Book tool to correct all problems and only "
683 "then run beautify. Accessed via :guilabel:`Tools->Beautify all files`."
684 msgstr ""
685
686 #: ../../../__w/calibre/calibre/manual/edit.rst:454
687 msgid ""
688 "In HTML any text can have significant whitespace, via the CSS white-space "
689 "directive. Therefore, beautification could potentially change the rendering "
690 "of the HTML. To avoid this as far as possible, the beautify algorithm only "
691 "beautifies block level tags that contain other block level tags. So, for "
692 "example, text inside a <p> tag will not have its whitespace changed. But a "
693 "<body> tag that contains only other <p> and <div> tags will be beautified. "
694 "This can sometimes mean that a particular file will not be affected by "
695 "beautify as it has no suitable block level tags. In such cases you can try "
696 "different beautification tools, that are less careful, for example: `HTML "
697 "Tidy <https://infohound.net/tidy/>`_."
698 msgstr ""
699
700 #: ../../../__w/calibre/calibre/manual/edit.rst:467
701 msgid "Inserting an inline Table of Contents"
702 msgstr ""
703
704 #: ../../../__w/calibre/calibre/manual/edit.rst:469
705 msgid ""
706 "Normally in e-books, the Table of Contents is separate from the main text "
707 "and is typically accessed via a special Table of Contents button/menu in the"
708 " e-book reading device. You can also have calibre automatically generate an "
709 "*inline* Table of Contents that becomes part of the text of the book. It is "
710 "generated based on the currently defined Table of Contents."
711 msgstr ""
712
713 #: ../../../__w/calibre/calibre/manual/edit.rst:475
714 msgid ""
715 "If you use this tool multiple times, each invocation will cause the "
716 "previously created inline Table of Contents to be replaced. The tool can be "
717 "accessed via :guilabel:`Tools->Table of Contents->Insert inline Table of "
718 "Contents`."
719 msgstr ""
720
721 #: ../../../__w/calibre/calibre/manual/edit.rst:480
722 msgid "Setting Semantics"
723 msgstr ""
724
725 #: ../../../__w/calibre/calibre/manual/edit.rst:482
726 msgid ""
727 "This tool is used to set *semantics* in EPUB files. Semantics are simply, "
728 "links in the OPF file that identify certain locations in the book as having "
729 "special meaning. You can use them to identify the foreword, dedication, "
730 "cover, table of contents, etc. Simply choose the type of semantic "
731 "information you want to specify and then select the location in the book the"
732 " link should point to. This tool can be accessed via :guilabel:`Tools->Set "
733 "semantics`."
734 msgstr ""
735
736 #: ../../../__w/calibre/calibre/manual/edit.rst:490
737 msgid "Filtering style information"
738 msgstr ""
739
740 #: ../../../__w/calibre/calibre/manual/edit.rst:492
741 msgid ""
742 "This tool can be used to easily remove specified CSS style properties from "
743 "the entire book. You can tell it what properties you want removed, for "
744 "example, ``color, background-color, line-height`` and it will remove them "
745 "from everywhere they occur --- stylesheets, ``<style>`` tags and inline "
746 "``style`` attributes. After removing the style information, a summary of all"
747 " the changes made is displayed so you can see exactly what was changed. The "
748 "tool can be accessed via :guilabel:`Tools->Filter style information`."
749 msgstr ""
750
751 #: ../../../__w/calibre/calibre/manual/edit.rst:502
752 msgid "Upgrading the book's internals"
753 msgstr ""
754
755 #: ../../../__w/calibre/calibre/manual/edit.rst:504
756 msgid ""
757 "This tool can be used to upgrade the book's internals, if possible. For "
758 "instance it will upgrade EPUB 2 books to EPUB 3 books. The tool can be "
759 "accessed via :guilabel:`Upgrade book internals`."
760 msgstr ""
761
762 #: ../../../__w/calibre/calibre/manual/edit.rst:511
763 msgid "Checkpoints"
764 msgstr ""
765
766 #: ../../../__w/calibre/calibre/manual/edit.rst:513
767 msgid ""
768 ":guilabel:`Checkpoints` are a way to mark the current state of the book as "
769 "\"special\". You can then go on to do whatever changes you want to the book "
770 "and if you don't like the results, return to the checkpointed state. "
771 "Checkpoints are automatically created every time you run any of the "
772 "automated tools described in the previous section."
773 msgstr ""
774
775 #: ../../../__w/calibre/calibre/manual/edit.rst:519
776 msgid ""
777 "You can create a checkpoint via :guilabel:`Edit->Create checkpoint`. And go "
778 "back to a previous checkpoint with :guilabel:`Edit->Revert to ...`"
779 msgstr ""
780
781 #: ../../../__w/calibre/calibre/manual/edit.rst:522
782 msgid ""
783 "The check pointing functionality is in addition to the normal Undo/redo "
784 "mechanism when editing individual files. Checkpoints are needed for when "
785 "changes are spread over multiple files in the book or when you wish to be "
786 "able to revert a large group of related changes as a whole."
787 msgstr ""
788
789 #: ../../../__w/calibre/calibre/manual/edit.rst:527
790 msgid ""
791 "You can see a list of available checkpoints via "
792 ":guilabel:`View->Checkpoints`. You can compare the current state of the book"
793 " to a specified checkpoint using the :ref:`diff` tool -- by selecting the "
794 "checkpoint of interest and clicking the :guilabel:`Compare` button. The "
795 ":guilabel:`Revert to` button restores the book to the selected checkpoint, "
796 "undoing all changes since that checkpoint was created."
797 msgstr ""
798
799 #: ../../../__w/calibre/calibre/manual/edit.rst:535
800 msgid "The Live preview panel"
801 msgstr ""
802
803 #: ../../../__w/calibre/calibre/manual/edit.rst:537
804 msgid "The Live preview panel showing a rendering of the current file"
805 msgstr ""
806
807 #: ../../../__w/calibre/calibre/manual/edit.rst:541
808 msgid ""
809 "The :guilabel:`File preview` gives you an overview of the various files "
810 "inside The live preview panel shows you the changes you are making live "
811 "(with a second or two of delay). As you edit HTML or CSS files, the preview "
812 "panel is updated automatically to reflect your changes. As you move the "
813 "cursor around in the editor, the preview panel will track its location, "
814 "showing you the corresponding location in the book. Clicking in the preview "
815 "panel, will cause the cursor in the editor to be positioned over the element"
816 " you clicked. If you click a link pointing to another file in the book, that"
817 " file will be opened in the edit and the preview panel, automatically."
818 msgstr ""
819
820 #: ../../../__w/calibre/calibre/manual/edit.rst:551
821 msgid ""
822 "You can turn off the automatic syncing of position and live preview of "
823 "changes -- by buttons under the preview panel. The live update of the "
824 "preview panel only happens when you are not actively typing in the editor, "
825 "so as not to be distracting or slow you down, waiting for the preview to "
826 "render."
827 msgstr ""
828
829 #: ../../../__w/calibre/calibre/manual/edit.rst:556
830 msgid ""
831 "The preview panel shows you how the text will look when viewed. However, the"
832 " preview panel is not a substitute for actually testing your book an actual "
833 "reader device. It is both more, and less capable than an actual reader. It "
834 "will tolerate errors and sloppy markup much better than most reader devices."
835 " It will also not show you page margins, page breaks and embedded fonts that"
836 " use font name aliasing. Use the preview panel while you are working on the "
837 "book, but once you are done, review it in an actual reader device or "
838 "software emulator."
839 msgstr ""
840
841 #: ../../../__w/calibre/calibre/manual/edit.rst:565
842 msgid ""
843 "The preview panel does not support embedded fonts if the name of the font "
844 "inside the font file does not match the name in the CSS @font-face rule. You"
845 " can use the Check Book tool to quickly find and fix any such problem fonts."
846 msgstr ""
847
848 #: ../../../__w/calibre/calibre/manual/edit.rst:571
849 msgid "Splitting HTML files"
850 msgstr ""
851
852 #: ../../../__w/calibre/calibre/manual/edit.rst:575
853 msgid ""
854 "One, perhaps non-obvious, use of the preview panel is to split long HTML "
855 "files. While viewing the file you want to split, click the :guilabel:`Split "
856 "mode` button under the preview panel |spmb|. Then simply move your mouse to "
857 "the place where you want to split the file and click. A thick green line "
858 "will show you exactly where the split will happen as you move your mouse. "
859 "Once you have found the location you want, simply click and the split will "
860 "be performed."
861 msgstr ""
862
863 #: ../../../__w/calibre/calibre/manual/edit.rst:573
864 msgid "spmb"
865 msgstr ""
866
867 #: ../../../__w/calibre/calibre/manual/edit.rst:582
868 msgid ""
869 "Splitting the file will automatically update all links and references that "
870 "pointed into the bottom half of the file and will open the newly split file "
871 "in an editor."
872 msgstr ""
873
874 #: ../../../__w/calibre/calibre/manual/edit.rst:586
875 msgid ""
876 "You can also split a single HTML file at multiple locations automatically, "
877 "by right clicking inside the file in the editor and choosing "
878 ":guilabel:`Split at multiple locations`. This will allow you to easily split"
879 " a large file at all heading tags or all tags having a certain class and so "
880 "on."
881 msgstr ""
882
883 #: ../../../__w/calibre/calibre/manual/edit.rst:596
884 msgid "The Live CSS panel"
885 msgstr ""
886
887 #: ../../../__w/calibre/calibre/manual/edit.rst:598
888 msgid "The Live CSS panel showing the styles for the current element"
889 msgstr ""
890
891 #: ../../../__w/calibre/calibre/manual/edit.rst:603
892 msgid ""
893 "The :guilabel:`Live CSS` panel shows you all the style rules that apply to "
894 "the tag you are currently editing. The name of tag, along with its line "
895 "number in the editor are displayed, followed by a list of matching style "
896 "rules."
897 msgstr ""
898
899 #: ../../../__w/calibre/calibre/manual/edit.rst:607
900 msgid ""
901 "It is a great way to quickly see which style rules apply to any tag. The "
902 "view also has clickable links (in blue), which take you directly to the "
903 "location where the style was defined, in case you wish to make any changes "
904 "to the style rules. Style rules that apply directly to the tag, as well as "
905 "rules that are inherited from parent tags are shown."
906 msgstr ""
907
908 #: ../../../__w/calibre/calibre/manual/edit.rst:613
909 msgid ""
910 "The panel also shows you what the finally calculated styles for the tag are."
911 " Properties in the list that are superseded by higher priority rules are "
912 "shown with a line through them."
913 msgstr ""
914
915 #: ../../../__w/calibre/calibre/manual/edit.rst:617
916 msgid "You can enable the Live CSS panel via :guilabel:`View->Live CSS`."
917 msgstr ""
918
919 #: ../../../__w/calibre/calibre/manual/edit.rst:624
920 msgid "Miscellaneous tools"
921 msgstr ""
922
923 #: ../../../__w/calibre/calibre/manual/edit.rst:626
924 msgid "There are a few more tools that can be useful while you edit the book."
925 msgstr ""
926
927 #: ../../../__w/calibre/calibre/manual/edit.rst:629
928 msgid "The Table of Contents view"
929 msgstr ""
930
931 #: ../../../__w/calibre/calibre/manual/edit.rst:631
932 msgid ""
933 "The Table of Contents view shows you the current table of contents in the "
934 "book. Double clicking on any entry opens the place that entry points to in "
935 "an editor. You can right click to edit the Table of Contents, refresh the "
936 "view or expand/collapse all items. Access this view via "
937 ":guilabel:`View->Table of Contents`."
938 msgstr ""
939
940 #: ../../../__w/calibre/calibre/manual/edit.rst:638
941 msgid "Checking the spelling of words in the book"
942 msgstr ""
943
944 #: ../../../__w/calibre/calibre/manual/edit.rst:640
945 msgid "You can run a spelling checker via :guilabel:`Tools->Check spelling`."
946 msgstr ""
947
948 #: ../../../__w/calibre/calibre/manual/edit.rst:642
949 msgid "The Check spelling tool"
950 msgstr ""
951
952 #: ../../../__w/calibre/calibre/manual/edit.rst:647
953 msgid ""
954 "Words are shown with the number of times they occur in the book and the "
955 "language the word belongs to. Language information is taken from the books "
956 "metadata and from ``lang`` attributes in the HTML files. This allows the "
957 "spell checker to work well even with books that contain text in multiple "
958 "languages. For example, in the following HTML extract, the word color will "
959 "be checked using American English and the word colour using British "
960 "English::"
961 msgstr ""
962
963 #: ../../../__w/calibre/calibre/manual/edit.rst:657
964 msgid ""
965 "You can double click a word to highlight the next occurrence of that word in"
966 " the editor. This is useful if you wish to manually edit the word, or see "
967 "what context it is in."
968 msgstr ""
969
970 #: ../../../__w/calibre/calibre/manual/edit.rst:661
971 msgid ""
972 "To change a word, simply double click one of the suggested alternative "
973 "spellings on the right, or type in your own corrected spelling and click the"
974 " :guilabel:`Change selected word to` button. This will replace all "
975 "occurrences of the word in the book. You can also right click on a word in "
976 "the main word list to change the word conveniently from the right click "
977 "menu."
978 msgstr ""
979
980 #: ../../../__w/calibre/calibre/manual/edit.rst:667
981 msgid ""
982 "You can have the spelling checker ignore a word for the current session by "
983 "clicking the :guilabel:`Ignore` button. You can also add a word to the user "
984 "dictionary by clicking the :guilabel:`Add to dictionary` button. The "
985 "spelling checker supports multiple user dictionaries, so you can select the "
986 "dictionary you want the word added to."
987 msgstr ""
988
989 #: ../../../__w/calibre/calibre/manual/edit.rst:673
990 msgid ""
991 "You can also have the spelling checker display all the words in your book, "
992 "not just the incorrectly spelled ones. This is useful to see what words are "
993 "most common in your book and to run a simple search and replace on "
994 "individual words."
995 msgstr ""
996
997 #: ../../../__w/calibre/calibre/manual/edit.rst:678
998 msgid ""
999 "If you make any changes to the book by editing files while the spell check "
1000 "tool is open, you should click the :guilabel:`Refresh` button in the Spell "
1001 "check tool. If you do not do this and continue to use the Spell check tool, "
1002 "you could lose the changes you have made in the editor."
1003 msgstr ""
1004
1005 #: ../../../__w/calibre/calibre/manual/edit.rst:684
1006 msgid ""
1007 "To exclude an individual file from being spell checked when running the "
1008 "spell check tool, you can use the :guilabel:`Exclude files` button or add "
1009 "the following comment just under the opening tag in the file::"
1010 msgstr ""
1011
1012 #: ../../../__w/calibre/calibre/manual/edit.rst:692
1013 msgid "Adding new dictionaries"
1014 msgstr ""
1015
1016 #: ../../../__w/calibre/calibre/manual/edit.rst:694
1017 msgid ""
1018 "The spelling checker comes with builtin dictionaries for the English and "
1019 "Spanish languages. You can install your own dictionaries via "
1020 ":guilabel:`Preferences->Editor->Manage spelling dictionaries`. The spell "
1021 "checker can use dictionaries from the LibreOffice program (in the .oxt "
1022 "format). You can download these dictionaries from `The LibreOffice "
1023 "Extensions repository <https://extensions.libreoffice.org/?Tags%5B%5D=50>`_."
1024 msgstr ""
1025
1026 #: ../../../__w/calibre/calibre/manual/edit.rst:703
1027 msgid "Inserting special characters"
1028 msgstr ""
1029
1030 #: ../../../__w/calibre/calibre/manual/edit.rst:705
1031 msgid ""
1032 "You can insert characters that are difficult to type by using the "
1033 ":guilabel:`Edit->Insert special character` tool. This shows you all Unicode "
1034 "characters, simply click on the character you want to type. If you hold "
1035 ":kbd:`Ctrl` while clicking, the window will close itself after inserting the"
1036 " selected character. This tool can be used to insert special characters into"
1037 " the main text or into any other area of the user interface, such as the "
1038 "Search and replace tool."
1039 msgstr ""
1040
1041 #: ../../../__w/calibre/calibre/manual/edit.rst:713
1042 msgid ""
1043 "Because there are a lot of characters, you can define your own "
1044 ":guilabel:`Favorite` characters, that will be shown first. Simply right "
1045 "click on a character to mark it as favorite. You can also right click on a "
1046 "character in favorites to remove it from favorites. Finally, you can re-"
1047 "arrange the order of characters in favorites by clicking the :guilabel:`Re-"
1048 "arrange favorites` button and then drag and dropping the characters in "
1049 "favorites around."
1050 msgstr ""
1051
1052 #: ../../../__w/calibre/calibre/manual/edit.rst:720
1053 msgid ""
1054 "You can also directly type in special characters using the keyboard. To do "
1055 "this, you type the Unicode code for the character (in hexadecimal) and then "
1056 "press the :kbd:`Alt+X` key which will convert the previously typed code into"
1057 " the corresponding character. For example, to type ΓΏ you would type ff and "
1058 "then :kbd:`Alt+X`. To type a non-breaking space you would use a0 and then "
1059 ":kbd:`Alt+X`, to type the horizontal ellipsis you would use 2026 and "
1060 ":kbd:`Alt+X` and so on."
1061 msgstr ""
1062
1063 #: ../../../__w/calibre/calibre/manual/edit.rst:728
1064 msgid ""
1065 "Finally, you can type in special characters by using HTML named entities. "
1066 "For example, typing &nbsp; will be replaced by a non breaking space when you"
1067 " type the semi-colon. The replacement happens only when typing the semi-"
1068 "colon."
1069 msgstr ""
1070
1071 #: ../../../__w/calibre/calibre/manual/edit.rst:733
1072 msgid "The code inspector view"
1073 msgstr ""
1074
1075 #: ../../../__w/calibre/calibre/manual/edit.rst:735
1076 msgid ""
1077 "This view shows you the HTML coding and CSS that applies to the current "
1078 "element of interest. You open it by right clicking a location in the preview"
1079 " panel and choosing :guilabel:`Inspect`. It allows you to see the HTML "
1080 "coding for that element and more importantly, the CSS styles that apply to "
1081 "it. You can even dynamically edit the styles and see what effect your "
1082 "changes have instantly. Note that editing the styles does not actually make "
1083 "changes to the book contents, it only allows for quick experimentation. The "
1084 "ability to live edit inside the Inspector is under development."
1085 msgstr ""
1086
1087 #: ../../../__w/calibre/calibre/manual/edit.rst:745
1088 msgid "Checking external links"
1089 msgstr ""
1090
1091 #: ../../../__w/calibre/calibre/manual/edit.rst:747
1092 msgid ""
1093 "You can use this tool to check all links in your book that point to external"
1094 " websites. The tool will try to visit every externally linked website, and "
1095 "if the visit fails, it will report all broken links in a convenient format "
1096 "for you to fix."
1097 msgstr ""
1098
1099 #: ../../../__w/calibre/calibre/manual/edit.rst:754
1100 msgid "Downloading external resources"
1101 msgstr ""
1102
1103 #: ../../../__w/calibre/calibre/manual/edit.rst:756
1104 msgid ""
1105 "You can use this tool to automatically download any images/stylesheets/etc. "
1106 "in the book that are not bundled with the book (i.e. they have URLs pointing"
1107 " to a location on the internet). The tool will find all such resources and "
1108 "automatically download them, add them to the book and replace all references"
1109 " to them to use the downloaded files."
1110 msgstr ""
1111
1112 #: ../../../__w/calibre/calibre/manual/edit.rst:764
1113 msgid "Arranging files into folders by type"
1114 msgstr ""
1115
1116 #: ../../../__w/calibre/calibre/manual/edit.rst:766
1117 msgid ""
1118 "Often when editing EPUB files that you get from somewhere, you will find "
1119 "that the files inside the EPUB are arranged haphazardly, in different sub-"
1120 "folders. This tool allows you to automatically move all files into sub-"
1121 "folders based on their types. Access it via :guilabel:`Tools->Arrange into "
1122 "folders`. Note that this tool only changes how the files are arranged inside"
1123 " the EPUB, it does not change how they are displayed in the File browser."
1124 msgstr ""
1125
1126 #: ../../../__w/calibre/calibre/manual/edit.rst:774
1127 msgid "Importing files in other e-book formats as EPUB"
1128 msgstr ""
1129
1130 #: ../../../__w/calibre/calibre/manual/edit.rst:776
1131 msgid ""
1132 "The editor includes the ability to import files in some other e-book formats"
1133 " directly as a new EPUB, without going through a full conversion. This is "
1134 "particularly useful to directly create EPUB files from your own hand-edited "
1135 "HTML files. You can do this via :guilabel:`File->Import an HTML or DOCX file"
1136 " as a new book`."
1137 msgstr ""
1138
1139 #: ../../../__w/calibre/calibre/manual/edit.rst:789
1140 msgid "The Reports tool"
1141 msgstr ""
1142
1143 #: ../../../__w/calibre/calibre/manual/edit.rst:791
1144 msgid ""
1145 "The editor includes a nice *Reports* tool (via :guilabel:`Tools->Reports`) "
1146 "that shows summaries of the files, images, links, words, characters and "
1147 "styles used in the book. Every line in the report is hot-linked. Double "
1148 "clicking a line jumps to the place in the book where that item is used or "
1149 "defined (as appropriate). For example, in the :guilabel:`Links` view, you "
1150 "can double click entries the :guilabel:`Source` column to jump to where the "
1151 "link is defined and entries in the :guilabel:`Target` column to jump to "
1152 "where the link points."
1153 msgstr ""
1154
1155 #: ../../../__w/calibre/calibre/manual/edit.rst:799
1156 msgid "The Reports tool with information and statistics about the book"
1157 msgstr ""
1158
1159 #: ../../../__w/calibre/calibre/manual/edit.rst:806
1160 msgid "Special features in the code editor"
1161 msgstr ""
1162
1163 #: ../../../__w/calibre/calibre/manual/edit.rst:808
1164 msgid ""
1165 "The calibre HTML editor is very powerful. It has many features that make "
1166 "editing of HTML (and CSS) easier."
1167 msgstr ""
1168
1169 #: ../../../__w/calibre/calibre/manual/edit.rst:812
1170 msgid "Syntax highlighting"
1171 msgstr ""
1172
1173 #: ../../../__w/calibre/calibre/manual/edit.rst:814
1174 msgid ""
1175 "The HTML editor has very sophisticated syntax highlighting. Features "
1176 "include:"
1177 msgstr ""
1178
1179 #: ../../../__w/calibre/calibre/manual/edit.rst:816
1180 msgid "The text inside bold, italic and heading tags is made bold/italic"
1181 msgstr ""
1182
1183 #: ../../../__w/calibre/calibre/manual/edit.rst:817
1184 msgid ""
1185 "As you move your cursor through the HTML, the matching HTML tags are "
1186 "highlighted, and you can jump to the opening or closing tag with the "
1187 "keyboard shortcuts :kbd:`Ctrl+{` and :kbd:`Ctrl+}`. Similarly, you can "
1188 "select the contents of a tag with :kbd:`Ctrl+Alt+T` or :kbd:`Ctrl+Shift+T`."
1189 msgstr ""
1190
1191 #: ../../../__w/calibre/calibre/manual/edit.rst:822
1192 msgid "Invalid HTML is highlighted with a red underline"
1193 msgstr ""
1194
1195 #: ../../../__w/calibre/calibre/manual/edit.rst:823
1196 msgid ""
1197 "Spelling errors in the text inside HTML tags and attributes such as title "
1198 "are highlighted. The spell checking is language aware, based on the value of"
1199 " the ``lang`` attribute of the current tag and the overall book language."
1200 msgstr ""
1201
1202 #: ../../../__w/calibre/calibre/manual/edit.rst:826
1203 msgid "CSS embedded inside ``<style>`` tags is highlighted"
1204 msgstr ""
1205
1206 #: ../../../__w/calibre/calibre/manual/edit.rst:827
1207 msgid ""
1208 "Special characters that can be hard to distinguish such as non-breaking "
1209 "spaces, different types of hyphens, etc. are highlighted."
1210 msgstr ""
1211
1212 #: ../../../__w/calibre/calibre/manual/edit.rst:829
1213 msgid ""
1214 "Links to other files in ``<a>`` tags, ``<img>`` and ``<link>`` tags all have"
1215 " the filenames highlighted. If the filename they point to does not exist, "
1216 "the filename is marked with a red underline."
1217 msgstr ""
1218
1219 #: ../../../__w/calibre/calibre/manual/edit.rst:834
1220 msgid "Context sensitive help"
1221 msgstr ""
1222
1223 #: ../../../__w/calibre/calibre/manual/edit.rst:836
1224 msgid ""
1225 "You can right click on an HTML tag name or a CSS property name to get help "
1226 "for that tag or property."
1227 msgstr ""
1228
1229 #: ../../../__w/calibre/calibre/manual/edit.rst:838
1230 msgid ""
1231 "You can also hold down the :kbd:`Ctrl` key and click on any filename inside "
1232 "a link tag to open that file in the editor automatically. Similarly, "
1233 ":kbd:`Ctrl` clicking a class name will take you to the first style rule that"
1234 " matches the tag and class."
1235 msgstr ""
1236
1237 #: ../../../__w/calibre/calibre/manual/edit.rst:842
1238 msgid ""
1239 "Right clicking a class name in an HTML file will allow you to rename the "
1240 "class, changing all occurrences of the class throughout the book and all its"
1241 " stylesheets."
1242 msgstr ""
1243
1244 #: ../../../__w/calibre/calibre/manual/edit.rst:849
1245 msgid "Auto-complete"
1246 msgstr ""
1247
1248 #: ../../../__w/calibre/calibre/manual/edit.rst:851
1249 msgid ""
1250 "When editing an e-book, one of the most tedious tasks is creating links to "
1251 "other files inside the book, or to CSS stylesheets, or images. You have to "
1252 "figure out the correct filename and relative path to the file. The editor "
1253 "has auto-complete to make that easier."
1254 msgstr ""
1255
1256 #: ../../../__w/calibre/calibre/manual/edit.rst:856
1257 msgid ""
1258 "As you type a filename, the editor automatically pops up suggestions. Simply"
1259 " use the :kbd:`Tab` key to select the correct file name. The editor even "
1260 "offers suggestions for links pointing to an anchor inside another HTML file."
1261 " After you type the ``#`` character, the editor will show you a list of all "
1262 "anchors in the target file, with a small snippet of text to help you choose "
1263 "the right anchor."
1264 msgstr ""
1265
1266 #: ../../../__w/calibre/calibre/manual/edit.rst:862
1267 msgid ""
1268 "Note that unlike most other completion systems, the editor's completion "
1269 "system uses subsequence matching. This means that you can type just two or "
1270 "three letters from anywhere in the filename to complete the filename. For "
1271 "example, say you want the filename ``../images/arrow1.png``, you can simply "
1272 "type ``ia1`` and press :kbd:`Tab` to complete the filename. When searching "
1273 "for matches, the completion system prioritizes letters that are at the start"
1274 " of a word, or immediately after a path separator. Once you get used to this"
1275 " system, you will find it saves you a lot of time and effort."
1276 msgstr ""
1277
1278 #: ../../../__w/calibre/calibre/manual/edit.rst:872
1279 msgid "Snippets"
1280 msgstr ""
1281
1282 #: ../../../__w/calibre/calibre/manual/edit.rst:874
1283 msgid ""
1284 "The calibre E-book editor supports *snippets*. A snippet is a piece of text "
1285 "that is either re-used often or contains a lot of redundant text. The editor"
1286 " allows you to insert a snippet with only a few key strokes. The snippets "
1287 "are very powerful, with many features, such as placeholders you can jump "
1288 "between, automatic mirroring of repeated text and so on. For more "
1289 "information, see :doc:`snippets`."
1290 msgstr ""