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