| 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: 2014-06-17 08:34+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/conversion.rst:4 |
| 21 |
msgid "E-book conversion" |
| 22 |
msgstr "" |
| 23 |
|
| 24 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:6 |
| 25 |
msgid "" |
| 26 |
"calibre has a conversion system that is designed to be very easy to use. " |
| 27 |
"Normally, you just add a book to calibre, click convert and calibre will try" |
| 28 |
" hard to generate output that is as close as possible to the input. However," |
| 29 |
" calibre accepts a very large number of input formats, not all of which are " |
| 30 |
"as suitable as others for conversion to e-books. In the case of such input " |
| 31 |
"formats, or if you just want greater control over the conversion system, " |
| 32 |
"calibre has a lot of options to fine tune the conversion process. Note " |
| 33 |
"however that calibre's conversion system is not a substitute for a full " |
| 34 |
"blown e-book editor. To edit e-books, I recommend first converting them to " |
| 35 |
"EPUB or AZW3 using calibre and then using the :guilabel:`Edit book` feature " |
| 36 |
"to get them into perfect shape. You can then use the edited e-book as input " |
| 37 |
"for conversion into other formats in calibre." |
| 38 |
msgstr "" |
| 39 |
|
| 40 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:18 |
| 41 |
msgid "" |
| 42 |
"This document will refer mainly to the conversion settings as found in the " |
| 43 |
"conversion dialog, pictured below. All these settings are also available via" |
| 44 |
" command line interface to conversion, documented at " |
| 45 |
":doc:`generated/en/ebook-convert`. In calibre, you can obtain help on any " |
| 46 |
"individual setting by holding your mouse over it, a tooltip will appear " |
| 47 |
"describing the setting." |
| 48 |
msgstr "" |
| 49 |
|
| 50 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:24 |
| 51 |
msgid "E-book conversion dialog" |
| 52 |
msgstr "" |
| 53 |
|
| 54 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:31 |
| 55 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:95 |
| 56 |
msgid "Contents" |
| 57 |
msgstr "" |
| 58 |
|
| 59 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:36 |
| 60 |
msgid "Introduction" |
| 61 |
msgstr "" |
| 62 |
|
| 63 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:42 |
| 64 |
msgid "" |
| 65 |
"The first thing to understand about the conversion system is that it is " |
| 66 |
"designed as a pipeline. Schematically, it looks like this:" |
| 67 |
msgstr "" |
| 68 |
|
| 69 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:45 |
| 70 |
msgid "The conversion pipeline" |
| 71 |
msgstr "" |
| 72 |
|
| 73 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:49 |
| 74 |
msgid "" |
| 75 |
"The input format is first converted to XHTML by the appropriate *Input " |
| 76 |
"plugin*. This HTML is then *transformed*. In the last step, the processed " |
| 77 |
"XHTML is converted to the specified output format by the appropriate *Output" |
| 78 |
" plugin*. The results of the conversion can vary greatly, based on the input" |
| 79 |
" format. Some formats convert much better than others. A list of the best " |
| 80 |
"source formats for conversion is available :ref:`here <best-source-" |
| 81 |
"formats>`." |
| 82 |
msgstr "" |
| 83 |
|
| 84 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:56 |
| 85 |
msgid "" |
| 86 |
"The transforms that act on the XHTML output are where all the work happens. " |
| 87 |
"There are various transforms, for example, to insert book metadata as a page" |
| 88 |
" at the start of the book, to detect chapter headings and automatically " |
| 89 |
"create a Table of Contents, to proportionally adjust font sizes, et cetera. " |
| 90 |
"It is important to remember that all the transforms act on the XHTML output " |
| 91 |
"by the *Input plugin*, not on the input file itself. So, for example, if you" |
| 92 |
" ask calibre to convert an RTF file to EPUB, it will first be converted to " |
| 93 |
"XHTML internally, the various transforms will be applied to the XHTML and " |
| 94 |
"then the *Output plugin* will create the EPUB file, automatically generating" |
| 95 |
" all metadata, Table of Contents, et cetera." |
| 96 |
msgstr "" |
| 97 |
|
| 98 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:65 |
| 99 |
msgid "" |
| 100 |
"You can see this process in action by using the debug option |dbgi|. Just " |
| 101 |
"specify the path to a folder for the debug output. During conversion, " |
| 102 |
"calibre will place the XHTML generated by the various stages of the " |
| 103 |
"conversion pipeline in different sub-folders. The four sub-folders are:" |
| 104 |
msgstr "" |
| 105 |
|
| 106 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:38 |
| 107 |
msgid "Debug icon" |
| 108 |
msgstr "" |
| 109 |
|
| 110 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:70 |
| 111 |
msgid "Stages of the conversion pipeline" |
| 112 |
msgstr "" |
| 113 |
|
| 114 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:73 |
| 115 |
msgid "Folder" |
| 116 |
msgstr "" |
| 117 |
|
| 118 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:73 |
| 119 |
msgid "Description" |
| 120 |
msgstr "" |
| 121 |
|
| 122 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:75 |
| 123 |
msgid "input" |
| 124 |
msgstr "ورودی" |
| 125 |
|
| 126 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:75 |
| 127 |
msgid "" |
| 128 |
"This contains the HTML output by the Input plugin. Use this to debug the " |
| 129 |
"Input plugin." |
| 130 |
msgstr "" |
| 131 |
|
| 132 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:76 |
| 133 |
msgid "parsed" |
| 134 |
msgstr "" |
| 135 |
|
| 136 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:76 |
| 137 |
msgid "" |
| 138 |
"The result of pre-processing and converting to XHTML the output from the " |
| 139 |
"Input plugin. Use to debug structure detection." |
| 140 |
msgstr "" |
| 141 |
|
| 142 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:77 |
| 143 |
msgid "structure" |
| 144 |
msgstr "" |
| 145 |
|
| 146 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:77 |
| 147 |
msgid "" |
| 148 |
"Post structure detection, but before CSS flattening and font size " |
| 149 |
"conversion. Use to debug font size conversion and CSS transforms." |
| 150 |
msgstr "" |
| 151 |
|
| 152 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:78 |
| 153 |
msgid "processed" |
| 154 |
msgstr "" |
| 155 |
|
| 156 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:78 |
| 157 |
msgid "" |
| 158 |
"Just before the e-book is passed to the Output plugin. Use to debug the " |
| 159 |
"Output plugin." |
| 160 |
msgstr "" |
| 161 |
|
| 162 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:81 |
| 163 |
msgid "" |
| 164 |
"If you want to edit the input document a little before having calibre " |
| 165 |
"convert it, the best thing to do is edit the files in the :file:`input` sub-" |
| 166 |
"folder, then zip it up, and use the ZIP file as the input format for " |
| 167 |
"subsequent conversions. To do this use the :guilabel:`Edit meta information`" |
| 168 |
" dialog to add the ZIP file as a format for the book and then, in the top " |
| 169 |
"left corner of the conversion dialog, select ZIP as the input format." |
| 170 |
msgstr "" |
| 171 |
|
| 172 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:87 |
| 173 |
msgid "" |
| 174 |
"This document will deal mainly with the various transforms that operate on " |
| 175 |
"the intermediate XHTML and how to control them. At the end are some tips " |
| 176 |
"specific to each input/output format." |
| 177 |
msgstr "" |
| 178 |
|
| 179 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:91 |
| 180 |
msgid "Look & feel" |
| 181 |
msgstr "نگاه کن و احساس کن" |
| 182 |
|
| 183 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:97 |
| 184 |
msgid "" |
| 185 |
"This group of options controls various aspects of the look and feel of the " |
| 186 |
"converted e-book." |
| 187 |
msgstr "" |
| 188 |
|
| 189 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:102 |
| 190 |
msgid "Fonts" |
| 191 |
msgstr "قلم ها" |
| 192 |
|
| 193 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:104 |
| 194 |
msgid "" |
| 195 |
"One of the nicest features of the e-reading experience is the ability to " |
| 196 |
"easily adjust font sizes to suit individual needs and lighting conditions. " |
| 197 |
"calibre has sophisticated algorithms to ensure that all the books it outputs" |
| 198 |
" have a consistent font sizes, no matter what font sizes are specified in " |
| 199 |
"the input document." |
| 200 |
msgstr "" |
| 201 |
|
| 202 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:109 |
| 203 |
msgid "" |
| 204 |
"The base font size of a document is the most common font size in that " |
| 205 |
"document, i.e., the size of the bulk of text in that document. When you " |
| 206 |
"specify a :guilabel:`Base font size`, calibre automatically rescales all " |
| 207 |
"font sizes in the document proportionately, so that the most common font " |
| 208 |
"size becomes the specified base font size and other font sizes are rescaled " |
| 209 |
"appropriately. By choosing a larger base font size, you can make the fonts " |
| 210 |
"in the document larger and vice versa. When you set the base font size, for " |
| 211 |
"best results, you should also set the font size key." |
| 212 |
msgstr "" |
| 213 |
|
| 214 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:117 |
| 215 |
msgid "" |
| 216 |
"Normally, calibre will automatically choose a base font size appropriate to " |
| 217 |
"the output profile you have chosen (see :ref:`page-setup`). However, you can" |
| 218 |
" override this here in case the default is not suitable for you." |
| 219 |
msgstr "" |
| 220 |
|
| 221 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:121 |
| 222 |
msgid "" |
| 223 |
"The :guilabel:`Font size key` option lets you control how non-base font " |
| 224 |
"sizes are rescaled. The font rescaling algorithm works using a font size " |
| 225 |
"key, which is simply a comma-separated list of font sizes. The font size key" |
| 226 |
" tells calibre how many \"steps\" bigger or smaller a given font size should" |
| 227 |
" be compared to the base font size. The idea is that there should be a " |
| 228 |
"limited number of font sizes in a document. For example, one size for the " |
| 229 |
"body text, a couple of sizes for different levels of headings and a couple " |
| 230 |
"of sizes for super/sub scripts and footnotes. The font size key allows " |
| 231 |
"calibre to compartmentalize the font sizes in the input documents into " |
| 232 |
"separate \"bins\" corresponding to the different logical font sizes." |
| 233 |
msgstr "" |
| 234 |
|
| 235 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:130 |
| 236 |
msgid "" |
| 237 |
"Let's illustrate with an example. Suppose the source document we are " |
| 238 |
"converting was produced by someone with excellent eyesight and has a base " |
| 239 |
"font size of 8pt. That means the bulk of the text in the document is sized " |
| 240 |
"at 8pts, while headings are somewhat larger (say 10 and 12pt) and footnotes " |
| 241 |
"somewhat smaller at 6pt. Now if we use the following settings::" |
| 242 |
msgstr "" |
| 243 |
|
| 244 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:139 |
| 245 |
msgid "" |
| 246 |
"The output document will have a base font size of 12pt, headings of 14 and " |
| 247 |
"16pt and footnotes of 8pt. Now suppose we want to make the largest heading " |
| 248 |
"size stand out more and make the footnotes a little larger as well. To " |
| 249 |
"achieve this, the font key should be changed to::" |
| 250 |
msgstr "" |
| 251 |
|
| 252 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:145 |
| 253 |
msgid "" |
| 254 |
"The largest headings will now become 18pt, while the footnotes will become " |
| 255 |
"9pt. You can play with these settings to try and figure out what would be " |
| 256 |
"optimum for you by using the font rescaling wizard, which can be accessed by" |
| 257 |
" clicking the little button next to the :guilabel:`Font size key` setting." |
| 258 |
msgstr "" |
| 259 |
|
| 260 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:150 |
| 261 |
msgid "" |
| 262 |
"All the font size rescaling in the conversion can also be disabled here, if " |
| 263 |
"you would like to preserve the font sizes in the input document." |
| 264 |
msgstr "" |
| 265 |
|
| 266 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:153 |
| 267 |
msgid "" |
| 268 |
"A related setting is :guilabel:`Line height`. Line height controls the " |
| 269 |
"vertical height of lines. By default, (a line height of 0), no manipulation " |
| 270 |
"of line heights is performed. If you specify a non-default value, line " |
| 271 |
"heights will be set in all locations that don't specify their own line " |
| 272 |
"heights. However, this is something of a blunt weapon and should be used " |
| 273 |
"sparingly. If you want to adjust the line heights for some section of the " |
| 274 |
"input, it's better to use the :ref:`Extra CSS <extra-css>`." |
| 275 |
msgstr "" |
| 276 |
|
| 277 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:160 |
| 278 |
msgid "" |
| 279 |
"In this section you can also tell calibre to embed any referenced fonts into" |
| 280 |
" the book. This will allow the fonts to work on reader devices even if they " |
| 281 |
"are not available on the device." |
| 282 |
msgstr "" |
| 283 |
|
| 284 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:165 |
| 285 |
msgid "Text" |
| 286 |
msgstr "" |
| 287 |
|
| 288 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:167 |
| 289 |
msgid "" |
| 290 |
"Text can be either justified or not. Justified text has extra spaces between" |
| 291 |
" words to give a smooth right margin. Some people prefer justified text, " |
| 292 |
"others do not. Normally, calibre will preserve the justification in the " |
| 293 |
"original document. If you want to override it you can use the " |
| 294 |
":guilabel:`Text justification` option in this section." |
| 295 |
msgstr "" |
| 296 |
|
| 297 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:173 |
| 298 |
msgid "" |
| 299 |
"You can also tell calibre to :guilabel:`Smarten punctuation` which will " |
| 300 |
"replace plain quotes, dashes and ellipses with their typographically correct" |
| 301 |
" alternatives. Note that this algorithm is not perfect so it is worth " |
| 302 |
"reviewing the results. The reverse, namely, :guilabel:`Unsmarted " |
| 303 |
"punctuation` is also available." |
| 304 |
msgstr "" |
| 305 |
|
| 306 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:178 |
| 307 |
msgid "" |
| 308 |
"Finally, there is :guilabel:`Input character encoding`. Older documents " |
| 309 |
"sometimes don't specify their character encoding. When converted, this can " |
| 310 |
"result in non-English characters or special characters like smart quotes " |
| 311 |
"being corrupted. calibre tries to auto-detect the character encoding of the" |
| 312 |
" source document, but it does not always succeed. You can force it to assume" |
| 313 |
" a particular character encoding by using this setting. `cp1252` is a " |
| 314 |
"common encoding for documents produced using Windows software. You should " |
| 315 |
"also read :ref:`char-encoding-faq` for more on encoding issues." |
| 316 |
msgstr "" |
| 317 |
|
| 318 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:188 |
| 319 |
msgid "Layout" |
| 320 |
msgstr "" |
| 321 |
|
| 322 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:190 |
| 323 |
msgid "" |
| 324 |
"Normally, paragraphs in XHTML are rendered with a blank line between them " |
| 325 |
"and no leading text indent. calibre has a couple of options to control this." |
| 326 |
" :guilabel:`Remove spacing between paragraphs` forcefully ensure that all " |
| 327 |
"paragraphs have no inter paragraph spacing. It also sets the text indent to " |
| 328 |
"1.5em (can be changed) to mark the start of every paragraph. " |
| 329 |
":guilabel:`Insert blank line` does the opposite, guaranteeing that there is " |
| 330 |
"exactly one blank line between each pair of paragraphs. Both these options " |
| 331 |
"are very comprehensive, removing spacing, or inserting it for *all* " |
| 332 |
"paragraphs (technically <p> and <div> tags). This is so that you can just " |
| 333 |
"set the option and be sure that it performs as advertised, irrespective of " |
| 334 |
"how messy the input file is. The one exception is when the input file uses " |
| 335 |
"hard line breaks to implement inter-paragraph spacing." |
| 336 |
msgstr "" |
| 337 |
|
| 338 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:201 |
| 339 |
msgid "" |
| 340 |
"If you want to remove the spacing between all paragraphs, except a select " |
| 341 |
"few, don't use these options. Instead add the following CSS code to " |
| 342 |
":ref:`Extra CSS <extra-css>`::" |
| 343 |
msgstr "" |
| 344 |
|
| 345 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:207 |
| 346 |
msgid "" |
| 347 |
"Then, in your source document, mark the paragraphs that need spacing with " |
| 348 |
"`class=\"spacious\"`. If your input document is not in HTML, use the Debug " |
| 349 |
"option, described in the Introduction to get HTML (use the :file:`input` " |
| 350 |
"sub-folder)." |
| 351 |
msgstr "" |
| 352 |
|
| 353 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:211 |
| 354 |
msgid "" |
| 355 |
"Another useful options is :guilabel:`Linearize tables`. Some badly designed" |
| 356 |
" documents use tables to control the layout of text on the page. When " |
| 357 |
"converted these documents often have text that runs off the page and other " |
| 358 |
"artifacts. This option will extract the content from the tables and present " |
| 359 |
"it in a linear fashion. Note that this option linearizes *all* tables, so " |
| 360 |
"only use it if you are sure the input document does not use tables for " |
| 361 |
"legitimate purposes, like presenting tabular information." |
| 362 |
msgstr "" |
| 363 |
|
| 364 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:220 |
| 365 |
msgid "Styling" |
| 366 |
msgstr "" |
| 367 |
|
| 368 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:224 |
| 369 |
msgid "" |
| 370 |
"The :guilabel:`Extra CSS` option allows you to specify arbitrary CSS that " |
| 371 |
"will be applied to all HTML files in the input. This CSS is applied with " |
| 372 |
"very high priority and so should override most CSS present in the **input " |
| 373 |
"document** itself. You can use this setting to fine tune the " |
| 374 |
"presentation/layout of your document. For example, if you want all " |
| 375 |
"paragraphs of class `endnote` to be right aligned, just add::" |
| 376 |
msgstr "" |
| 377 |
|
| 378 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:233 |
| 379 |
msgid "or if you want to change the indentation of all paragraphs::" |
| 380 |
msgstr "" |
| 381 |
|
| 382 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:237 |
| 383 |
msgid "" |
| 384 |
":guilabel:`Extra CSS` is a very powerful option, but you do need an " |
| 385 |
"understanding of how CSS works to use it to its full potential. You can use " |
| 386 |
"the debug pipeline option described above to see what CSS is present in your" |
| 387 |
" input document." |
| 388 |
msgstr "" |
| 389 |
|
| 390 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:241 |
| 391 |
msgid "" |
| 392 |
"A simpler option is to use :guilabel:`Filter style information`. This allows" |
| 393 |
" you to remove all CSS properties of the specified types from the document. " |
| 394 |
"For example, you can use it to remove all colors or fonts." |
| 395 |
msgstr "" |
| 396 |
|
| 397 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:246 |
| 398 |
msgid "Transform styles" |
| 399 |
msgstr "" |
| 400 |
|
| 401 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:248 |
| 402 |
msgid "" |
| 403 |
"This is the most powerful styling related facility. You can use it to define" |
| 404 |
" rules that change styles based on various conditions. For example you can " |
| 405 |
"use it to change all green colors to blue, or remove all bold styling from " |
| 406 |
"the text or color all headings a certain color, etc." |
| 407 |
msgstr "" |
| 408 |
|
| 409 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:254 |
| 410 |
msgid "Transform HTML" |
| 411 |
msgstr "" |
| 412 |
|
| 413 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:256 |
| 414 |
msgid "" |
| 415 |
"Similar to transform styles, but allows you to make changes to the HTML " |
| 416 |
"content of the book. You can replace one tag with another, add classes or " |
| 417 |
"other attributes to tags based on their content, etc." |
| 418 |
msgstr "" |
| 419 |
|
| 420 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:265 |
| 421 |
msgid "Page setup" |
| 422 |
msgstr "Page setup" |
| 423 |
|
| 424 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:267 |
| 425 |
msgid "" |
| 426 |
"The :guilabel:`Page setup` options are for controlling screen layout, like " |
| 427 |
"margins and screen sizes. There are options to setup page margins, which " |
| 428 |
"will be used by the output plugin, if the selected output format supports " |
| 429 |
"page margins. In addition, you should choose an Input profile and an output " |
| 430 |
"profile. Both sets of profiles basically deal with how to interpret " |
| 431 |
"measurements in the input/output documents, screen sizes and default font " |
| 432 |
"rescaling keys." |
| 433 |
msgstr "" |
| 434 |
|
| 435 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:274 |
| 436 |
msgid "" |
| 437 |
"If you know that the file you are converting was intended to be used on a " |
| 438 |
"particular device/software platform, choose the corresponding input profile," |
| 439 |
" otherwise just choose the default input profile. If you know the files you " |
| 440 |
"are producing are meant for a particular device type, choose the " |
| 441 |
"corresponding output profile. Otherwise, choose one of the Generic output " |
| 442 |
"profiles. If you are converting to MOBI or AZW3 then you will almost always " |
| 443 |
"want to choose one of the Kindle output profiles. Otherwise, your best bet " |
| 444 |
"for modern E-book reading devices is to choose the :guilabel:`Generic e-ink " |
| 445 |
"HD` output profile." |
| 446 |
msgstr "" |
| 447 |
|
| 448 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:283 |
| 449 |
msgid "" |
| 450 |
"The output profile also controls the screen size. This will cause, for " |
| 451 |
"example, images to be auto-resized to be fit to the screen in some output " |
| 452 |
"formats. So choose a profile of a device that has a screen size similar to " |
| 453 |
"your device." |
| 454 |
msgstr "" |
| 455 |
|
| 456 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:291 |
| 457 |
msgid "Heuristic processing" |
| 458 |
msgstr "Heuristic processing" |
| 459 |
|
| 460 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:293 |
| 461 |
msgid "" |
| 462 |
"Heuristic processing provides a variety of functions which can be used to " |
| 463 |
"try and detect and correct common problems in poorly formatted input " |
| 464 |
"documents. Use these functions if your input document suffers from poor " |
| 465 |
"formatting. Because these functions rely on common patterns, be aware that " |
| 466 |
"in some cases an option may lead to worse results, so use with care. As an " |
| 467 |
"example, several of these options will remove all non-breaking-space " |
| 468 |
"entities, or may include false positive matches relating to the function." |
| 469 |
msgstr "" |
| 470 |
|
| 471 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:299 |
| 472 |
msgid ":guilabel:`Enable heuristic processing`" |
| 473 |
msgstr "" |
| 474 |
|
| 475 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:300 |
| 476 |
msgid "" |
| 477 |
"This option activates calibre's :guilabel:`Heuristic processing` stage of " |
| 478 |
"the conversion pipeline. This must be enabled in order for various sub-" |
| 479 |
"functions to be applied" |
| 480 |
msgstr "" |
| 481 |
|
| 482 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:303 |
| 483 |
msgid ":guilabel:`Unwrap lines`" |
| 484 |
msgstr "" |
| 485 |
|
| 486 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:304 |
| 487 |
msgid "" |
| 488 |
"Enabling this option will cause calibre to attempt to detect and correct " |
| 489 |
"hard line breaks that exist within a document using punctuation clues and " |
| 490 |
"line length. calibre will first attempt to detect whether hard line breaks " |
| 491 |
"exist, if they do not appear to exist calibre will not attempt to unwrap " |
| 492 |
"lines. The line-unwrap factor can be reduced if you want to 'force' calibre " |
| 493 |
"to unwrap lines." |
| 494 |
msgstr "" |
| 495 |
|
| 496 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:309 |
| 497 |
msgid ":guilabel:`Line-unwrap factor`" |
| 498 |
msgstr "" |
| 499 |
|
| 500 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:310 |
| 501 |
msgid "" |
| 502 |
"This option controls the algorithm calibre uses to remove hard line breaks. " |
| 503 |
"For example, if the value of this option is 0.4, that means calibre will " |
| 504 |
"remove hard line breaks from the end of lines whose lengths are less than " |
| 505 |
"the length of 40% of all lines in the document. If your document only has a " |
| 506 |
"few line breaks which need correction, then this value should be reduced to " |
| 507 |
"somewhere between 0.1 and 0.2." |
| 508 |
msgstr "" |
| 509 |
|
| 510 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:315 |
| 511 |
msgid "" |
| 512 |
":guilabel:`Detect and markup unformatted chapter headings and sub headings`" |
| 513 |
msgstr "" |
| 514 |
|
| 515 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:316 |
| 516 |
msgid "" |
| 517 |
"If your document does not have chapter headings and titles formatted " |
| 518 |
"differently from the rest of the text, calibre can use this option to " |
| 519 |
"attempt to detect them and surround them with heading tags. <h2> tags are " |
| 520 |
"used for chapter headings; <h3> tags are used for any titles that are " |
| 521 |
"detected." |
| 522 |
msgstr "" |
| 523 |
|
| 524 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:320 |
| 525 |
msgid "" |
| 526 |
"This function will not create a TOC, but in many cases it will cause " |
| 527 |
"calibre's default chapter detection settings to correctly detect chapters " |
| 528 |
"and build a TOC. Adjust the XPath under Structure detection if a TOC is not" |
| 529 |
" automatically created. If there are no other headings used in the document" |
| 530 |
" then setting \"//h:h2\" under Structure detection would be the easiest way " |
| 531 |
"to create a TOC for the document." |
| 532 |
msgstr "" |
| 533 |
|
| 534 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:325 |
| 535 |
msgid "" |
| 536 |
"The inserted headings are not formatted, to apply formatting use the " |
| 537 |
":guilabel:`Extra CSS` option under the Look and Feel conversion settings. " |
| 538 |
"For example, to center heading tags, use the following::" |
| 539 |
msgstr "" |
| 540 |
|
| 541 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:330 |
| 542 |
msgid ":guilabel:`Renumber sequences of <h1> or <h2> tags`" |
| 543 |
msgstr "" |
| 544 |
|
| 545 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:331 |
| 546 |
msgid "" |
| 547 |
"Some publishers format chapter headings using multiple <h1> or <h2> tags " |
| 548 |
"sequentially. calibre's default conversion settings will cause such titles " |
| 549 |
"to be split into two pieces. This option will re-number the heading tags to" |
| 550 |
" prevent splitting." |
| 551 |
msgstr "" |
| 552 |
|
| 553 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:335 |
| 554 |
msgid ":guilabel:`Delete blank lines between paragraphs`" |
| 555 |
msgstr "" |
| 556 |
|
| 557 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:336 |
| 558 |
msgid "" |
| 559 |
"This option will cause calibre to analyze blank lines included within the " |
| 560 |
"document. If every paragraph is interleaved with a blank line, then calibre" |
| 561 |
" will remove all those blank paragraphs. Sequences of multiple blank lines " |
| 562 |
"will be considered scene breaks and retained as a single paragraph. This " |
| 563 |
"option differs from the :guilabel:`Remove paragraph spacing` option under " |
| 564 |
":guilabel:`Look and Feel` in that it actually modifies the HTML content, " |
| 565 |
"while the other option modifies the document styles. This option can also " |
| 566 |
"remove paragraphs which were inserted using calibre's :guilabel:`Insert " |
| 567 |
"blank line` option." |
| 568 |
msgstr "" |
| 569 |
|
| 570 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:346 |
| 571 |
msgid ":guilabel:`Ensure scene breaks are consistently formatted`" |
| 572 |
msgstr "" |
| 573 |
|
| 574 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:347 |
| 575 |
msgid "" |
| 576 |
"With this option calibre will attempt to detect common scene-break markers " |
| 577 |
"and ensure that they are center aligned. 'Soft' scene break markers, i.e. " |
| 578 |
"scene breaks only defined by extra white space, are styled to ensure that " |
| 579 |
"they will not be displayed in conjunction with page breaks." |
| 580 |
msgstr "" |
| 581 |
|
| 582 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:351 |
| 583 |
msgid ":guilabel:`Replace scene breaks`" |
| 584 |
msgstr "" |
| 585 |
|
| 586 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:352 |
| 587 |
msgid "" |
| 588 |
"If this option is configured then calibre will replace scene break markers " |
| 589 |
"it finds with the replacement text specified by the user. Please note that " |
| 590 |
"some ornamental characters may not be supported across all reading devices." |
| 591 |
msgstr "" |
| 592 |
|
| 593 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:355 |
| 594 |
msgid "" |
| 595 |
"In general you should avoid using HTML tags, calibre will discard any tags " |
| 596 |
"and use pre-defined markup. <hr /> tags, i.e. horizontal rules, and <img> " |
| 597 |
"tags are exceptions. Horizontal rules can optionally be specified with " |
| 598 |
"styles, if you choose to add your own style be sure to include the 'width' " |
| 599 |
"setting, otherwise the style information will be discarded. Image tags can " |
| 600 |
"used, but calibre does not provide the ability to add the image during " |
| 601 |
"conversion, this must be done after the fact using the 'Edit book' feature." |
| 602 |
msgstr "" |
| 603 |
|
| 604 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:361 |
| 605 |
msgid "" |
| 606 |
"Example image tag (place the image within an 'Images' folder inside the EPUB" |
| 607 |
" after conversion):" |
| 608 |
msgstr "" |
| 609 |
|
| 610 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:362 |
| 611 |
msgid "<img style=\"width:10%\" src=\"../Images/scenebreak.png\" />" |
| 612 |
msgstr "" |
| 613 |
|
| 614 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:364 |
| 615 |
msgid "Example horizontal rule with styles:" |
| 616 |
msgstr "" |
| 617 |
|
| 618 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:365 |
| 619 |
msgid "" |
| 620 |
"<hr style=\"width:20%;padding-top: 1px;border-top: 2px ridge black;border-" |
| 621 |
"bottom: 2px groove black;\"/>" |
| 622 |
msgstr "" |
| 623 |
|
| 624 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:367 |
| 625 |
msgid ":guilabel:`Remove unnecessary hyphens`" |
| 626 |
msgstr "" |
| 627 |
|
| 628 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:368 |
| 629 |
msgid "" |
| 630 |
"calibre will analyze all hyphenated content in the document when this option" |
| 631 |
" is enabled. The document itself is used as a dictionary for analysis. " |
| 632 |
"This allows calibre to accurately remove hyphens for any words in the " |
| 633 |
"document in any language, along with made-up and obscure scientific words. " |
| 634 |
"The primary drawback is words appearing only a single time in the document " |
| 635 |
"will not be changed. Analysis happens in two passes, the first pass " |
| 636 |
"analyzes line endings. Lines are only unwrapped if the word exists with or " |
| 637 |
"without a hyphen in the document. The second pass analyzes all hyphenated " |
| 638 |
"words throughout the document, hyphens are removed if the word exists " |
| 639 |
"elsewhere in the document without a match." |
| 640 |
msgstr "" |
| 641 |
|
| 642 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:375 |
| 643 |
msgid ":guilabel:`Italicize common words and patterns`" |
| 644 |
msgstr "" |
| 645 |
|
| 646 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:376 |
| 647 |
msgid "" |
| 648 |
"When enabled, calibre will look for common words and patterns that denote " |
| 649 |
"italics and italicize them. Examples are common text conventions such as " |
| 650 |
"~word~ or phrases that should generally be italicized, e.g. latin phrases " |
| 651 |
"like 'etc.' or 'et cetera'." |
| 652 |
msgstr "" |
| 653 |
|
| 654 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:379 |
| 655 |
msgid ":guilabel:`Replace entity indents with CSS indents`" |
| 656 |
msgstr "" |
| 657 |
|
| 658 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:380 |
| 659 |
msgid "" |
| 660 |
"Some documents use a convention of defining text indents using non-breaking " |
| 661 |
"space entities. When this option is enabled calibre will attempt to detect " |
| 662 |
"this sort of formatting and convert them to a 3% text indent using CSS." |
| 663 |
msgstr "" |
| 664 |
|
| 665 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:386 |
| 666 |
msgid "Search & replace" |
| 667 |
msgstr "Search & replace" |
| 668 |
|
| 669 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:388 |
| 670 |
msgid "" |
| 671 |
"These options are useful primarily for conversion of PDF documents or OCR " |
| 672 |
"conversions, though they can also be used to fix many document specific " |
| 673 |
"problems. As an example, some conversions can leaves behind page headers and" |
| 674 |
" footers in the text. These options use regular expressions to try and " |
| 675 |
"detect headers, footers, or other arbitrary text and remove or replace them." |
| 676 |
" Remember that they operate on the intermediate XHTML produced by the " |
| 677 |
"conversion pipeline. There is a wizard to help you customize the regular " |
| 678 |
"expressions for your document. Click the magic wand beside the expression " |
| 679 |
"box, and click the 'Test' button after composing your search expression. " |
| 680 |
"Successful matches will be highlighted in Yellow." |
| 681 |
msgstr "" |
| 682 |
|
| 683 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:396 |
| 684 |
msgid "" |
| 685 |
"The search works by using a Python regular expression. All matched text is " |
| 686 |
"simply removed from the document or replaced using the replacement pattern. " |
| 687 |
"The replacement pattern is optional, if left blank then text matching the " |
| 688 |
"search pattern will be deleted from the document. You can learn more about " |
| 689 |
"regular expressions and their syntax at :ref:`regexptutorial`." |
| 690 |
msgstr "" |
| 691 |
|
| 692 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:404 |
| 693 |
msgid "Structure detection" |
| 694 |
msgstr "Structure detection" |
| 695 |
|
| 696 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:406 |
| 697 |
msgid "" |
| 698 |
"Structure detection involves calibre trying its best to detect structural " |
| 699 |
"elements in the input document, when they are not properly specified. For " |
| 700 |
"example, chapters, page breaks, headers, footers, etc. As you can imagine, " |
| 701 |
"this process varies widely from book to book. Fortunately, calibre has very " |
| 702 |
"powerful options to control this. With power comes complexity, but if once " |
| 703 |
"you take the time to learn the complexity, you will find it well worth the " |
| 704 |
"effort." |
| 705 |
msgstr "" |
| 706 |
|
| 707 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:412 |
| 708 |
msgid "Chapters and page breaks" |
| 709 |
msgstr "" |
| 710 |
|
| 711 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:414 |
| 712 |
msgid "" |
| 713 |
"calibre has two sets of options for :guilabel:`chapter detection` and " |
| 714 |
":guilabel:`inserting page breaks`. This can sometimes be slightly confusing," |
| 715 |
" as by default, calibre will insert page breaks before detected chapters as " |
| 716 |
"well as the locations detected by the page breaks option. The reason for " |
| 717 |
"this is that there are often location where page breaks should be inserted " |
| 718 |
"that are not chapter boundaries. Also, detected chapters can be optionally " |
| 719 |
"inserted into the auto generated Table of Contents." |
| 720 |
msgstr "" |
| 721 |
|
| 722 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:419 |
| 723 |
msgid "" |
| 724 |
"calibre uses *XPath*, a powerful language to allow the user to specify " |
| 725 |
"chapter boundaries/page breaks. XPath can seem a little daunting to use at " |
| 726 |
"first, fortunately, there is a :ref:`XPath tutorial <xpath-tutorial>` in the" |
| 727 |
" User Manual. Remember that Structure detection operates on the intermediate" |
| 728 |
" XHTML produced by the conversion pipeline. Use the debug option described " |
| 729 |
"in the :ref:`conversion-introduction` to figure out the appropriate settings" |
| 730 |
" for your book. There is also a button for a XPath wizard to help with the " |
| 731 |
"generation of simple XPath expressions." |
| 732 |
msgstr "" |
| 733 |
|
| 734 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:425 |
| 735 |
msgid "" |
| 736 |
"By default, calibre uses the following expression for detecting chapters::" |
| 737 |
msgstr "" |
| 738 |
|
| 739 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:429 |
| 740 |
msgid "" |
| 741 |
"This expression is rather complex, because it tries to handle a number of " |
| 742 |
"common cases simultaneously. What it means is that calibre will assume " |
| 743 |
"chapters start at either `<h1>` or `<h2>` tags that have any of the words " |
| 744 |
"`(chapter, book, section or part)` in them or that have the " |
| 745 |
"`class=\"chapter\"` attribute." |
| 746 |
msgstr "" |
| 747 |
|
| 748 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:433 |
| 749 |
msgid "" |
| 750 |
"A related option is :guilabel:`Chapter mark`, which allows you to control " |
| 751 |
"what calibre does when it detects a chapter. By default, it will insert a " |
| 752 |
"page break before the chapter. You can have it insert a ruled line instead " |
| 753 |
"of, or in addition to the page break. You can also have it do nothing." |
| 754 |
msgstr "" |
| 755 |
|
| 756 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:437 |
| 757 |
msgid "The default setting for detecting page breaks is::" |
| 758 |
msgstr "" |
| 759 |
|
| 760 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:441 |
| 761 |
msgid "" |
| 762 |
"which means that calibre will insert page breaks before every `<h1>` and " |
| 763 |
"`<h2>` tag by default." |
| 764 |
msgstr "" |
| 765 |
|
| 766 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:445 |
| 767 |
msgid "" |
| 768 |
"The default expressions may change depending on the input format you are " |
| 769 |
"converting." |
| 770 |
msgstr "" |
| 771 |
|
| 772 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:448 |
| 773 |
msgid "Miscellaneous" |
| 774 |
msgstr "گوناگون" |
| 775 |
|
| 776 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:450 |
| 777 |
msgid "There are a few more options in this section." |
| 778 |
msgstr "" |
| 779 |
|
| 780 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:452 |
| 781 |
msgid ":guilabel:`Insert metadata as page at start of book`" |
| 782 |
msgstr "" |
| 783 |
|
| 784 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:453 |
| 785 |
msgid "" |
| 786 |
"One of the great things about calibre is that it allows you to maintain very" |
| 787 |
" complete metadata about all of your books, for example, a rating, tags, " |
| 788 |
"comments, etc. This option will create a single page with all this metadata " |
| 789 |
"and insert it into the converted e-book, typically just after the cover. " |
| 790 |
"Think of it as a way to create your own customised book jacket." |
| 791 |
msgstr "" |
| 792 |
|
| 793 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:458 |
| 794 |
msgid ":guilabel:`Remove first image`" |
| 795 |
msgstr "" |
| 796 |
|
| 797 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:459 |
| 798 |
msgid "" |
| 799 |
"Sometimes, the source document you are converting includes the cover as part" |
| 800 |
" of the book, instead of as a separate cover. If you also specify a cover in" |
| 801 |
" calibre, then the converted book will have two covers. This option will " |
| 802 |
"simply remove the first image from the source document, thereby ensuring " |
| 803 |
"that the converted book has only one cover, the one specified in calibre." |
| 804 |
msgstr "" |
| 805 |
|
| 806 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:466 |
| 807 |
msgid "Table of Contents" |
| 808 |
msgstr "فهرست محتوا" |
| 809 |
|
| 810 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:468 |
| 811 |
msgid "" |
| 812 |
"When the input document has a Table of Contents in its metadata, calibre " |
| 813 |
"will just use that. However, a number of older formats either do not support" |
| 814 |
" a metadata based Table of Contents, or individual documents do not have " |
| 815 |
"one. In these cases, the options in this section can help you automatically " |
| 816 |
"generate a Table of Contents in the converted e-book, based on the actual " |
| 817 |
"content in the input document." |
| 818 |
msgstr "" |
| 819 |
|
| 820 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:473 |
| 821 |
msgid "" |
| 822 |
"Using these options can be a little challenging to get exactly right. If you" |
| 823 |
" prefer creating/editing the Table of Contents by hand, convert to the EPUB " |
| 824 |
"or AZW3 formats and select the checkbox at the bottom of the Table of " |
| 825 |
"Contents section of the conversion dialog that says :guilabel:`Manually " |
| 826 |
"fine-tune the Table of Contents after conversion`. This will launch the ToC " |
| 827 |
"Editor tool after the conversion. It allows you to create entries in the " |
| 828 |
"Table of Contents by simply clicking the place in the book where you want " |
| 829 |
"the entry to point. You can also use the ToC Editor by itself, without doing" |
| 830 |
" a conversion. Go to :guilabel:`Preferences->Interface->Toolbars` and add " |
| 831 |
"the :guilabel:`ToC Editor` to the main toolbar. Then just select the book " |
| 832 |
"you want to edit and click the :guilabel:`ToC Editor` button." |
| 833 |
msgstr "" |
| 834 |
|
| 835 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:485 |
| 836 |
msgid "" |
| 837 |
"The first option is :guilabel:`Force use of auto-generated Table of " |
| 838 |
"Contents`. By checking this option you can have calibre override any Table " |
| 839 |
"of Contents found in the metadata of the input document with the auto " |
| 840 |
"generated one." |
| 841 |
msgstr "" |
| 842 |
|
| 843 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:489 |
| 844 |
msgid "" |
| 845 |
"The default way that the creation of the auto generated Table of Contents " |
| 846 |
"works is that, calibre will first try to add any detected chapters to the " |
| 847 |
"generated table of contents. You can learn how to customize the detection of" |
| 848 |
" chapters in the :ref:`structure-detection` section above. If you do not " |
| 849 |
"want to include detected chapters in the generated table of contents, check " |
| 850 |
"the :guilabel:`Do not add detected chapters` option." |
| 851 |
msgstr "" |
| 852 |
|
| 853 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:494 |
| 854 |
msgid "" |
| 855 |
"If less than the :guilabel:`Chapter threshold` number of chapters were " |
| 856 |
"detected, calibre will then add any hyperlinks it finds in the input " |
| 857 |
"document to the Table of Contents. This often works well: many input " |
| 858 |
"documents include a hyperlinked Table of Contents right at the start. The " |
| 859 |
":guilabel:`Number of links` option can be used to control this behavior. If " |
| 860 |
"set to zero, no links are added. If set to a number greater than zero, at " |
| 861 |
"most that number of links is added." |
| 862 |
msgstr "" |
| 863 |
|
| 864 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:500 |
| 865 |
msgid "" |
| 866 |
"calibre will automatically filter duplicates from the generated Table of " |
| 867 |
"Contents. However, if there are some additional undesirable entries, you can" |
| 868 |
" filter them using the :guilabel:`TOC Filter` option. This is a regular " |
| 869 |
"expression that will match the title of entries in the generated table of " |
| 870 |
"contents. Whenever a match is found, it will be removed. For example, to " |
| 871 |
"remove all entries titles \"Next\" or \"Previous\" use::" |
| 872 |
msgstr "" |
| 873 |
|
| 874 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:507 |
| 875 |
msgid "" |
| 876 |
"The :guilabel:`Level 1,2,3 TOC` options allow you to create a sophisticated " |
| 877 |
"multi-level Table of Contents. They are XPath expressions that match tags in" |
| 878 |
" the intermediate XHTML produced by the conversion pipeline. See the " |
| 879 |
":ref:`conversion-introduction` for how to get access to this XHTML. Also " |
| 880 |
"read the :ref:`xpath-tutorial`, to learn how to construct XPath expressions." |
| 881 |
" Next to each option is a button that launches a wizard to help with the " |
| 882 |
"creation of basic XPath expressions. The following simple example " |
| 883 |
"illustrates how to use these options." |
| 884 |
msgstr "" |
| 885 |
|
| 886 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:513 |
| 887 |
msgid "" |
| 888 |
"Suppose you have an input document that results in XHTML that look like " |
| 889 |
"this:" |
| 890 |
msgstr "" |
| 891 |
|
| 892 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:535 |
| 893 |
msgid "Then, we set the options as::" |
| 894 |
msgstr "" |
| 895 |
|
| 896 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:540 |
| 897 |
msgid "" |
| 898 |
"This will result in an automatically generated two level Table of Contents " |
| 899 |
"that looks like::" |
| 900 |
msgstr "" |
| 901 |
|
| 902 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:551 |
| 903 |
msgid "" |
| 904 |
"Not all output formats support a multi level Table of Contents. You should " |
| 905 |
"first try with EPUB output. If that works, then try your format of choice." |
| 906 |
msgstr "" |
| 907 |
|
| 908 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:555 |
| 909 |
msgid "Using images as chapter titles when converting HTML input documents" |
| 910 |
msgstr "" |
| 911 |
|
| 912 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:557 |
| 913 |
msgid "" |
| 914 |
"Suppose you want to use an image as your chapter title, but still want " |
| 915 |
"calibre to be able to automatically generate a Table of Contents for you " |
| 916 |
"from the chapter titles. Use the following HTML markup to achieve this:" |
| 917 |
msgstr "" |
| 918 |
|
| 919 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:571 |
| 920 |
msgid "" |
| 921 |
"Set the :guilabel:`Level 1 TOC` setting to ``//h:h2``. Then, for chapter " |
| 922 |
"two, calibre will take the title from the value of the ``title`` attribute " |
| 923 |
"on the ``<h2>`` tag, since the tag has no text." |
| 924 |
msgstr "" |
| 925 |
|
| 926 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:574 |
| 927 |
msgid "" |
| 928 |
"Using tag attributes to supply the text for entries in the Table of Contents" |
| 929 |
msgstr "" |
| 930 |
|
| 931 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:576 |
| 932 |
msgid "" |
| 933 |
"If you have particularly long chapter titles and want shortened versions in " |
| 934 |
"the Table of Contents, you can use the title attribute to achieve this, for " |
| 935 |
"example:" |
| 936 |
msgstr "" |
| 937 |
|
| 938 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:591 |
| 939 |
msgid "" |
| 940 |
"Set the :guilabel:`Level 1 TOC` setting to ``//h:h2/@title``. Then calibre " |
| 941 |
"will take the title from the value of the ``title`` attribute on the " |
| 942 |
"``<h2>`` tags, instead of using the text inside the tag. Note the trailing " |
| 943 |
"``/@title`` on the XPath expression, you can use this form to tell calibre " |
| 944 |
"to get the text from any attribute you like." |
| 945 |
msgstr "" |
| 946 |
|
| 947 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:598 |
| 948 |
msgid "How options are set/saved for conversion" |
| 949 |
msgstr "" |
| 950 |
|
| 951 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:600 |
| 952 |
msgid "" |
| 953 |
"There are two places where conversion options can be set in calibre. The " |
| 954 |
"first is in Preferences->Conversion. These settings are the defaults for the" |
| 955 |
" conversion options. Whenever you try to convert a new book, the settings " |
| 956 |
"set here will be used by default." |
| 957 |
msgstr "" |
| 958 |
|
| 959 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:605 |
| 960 |
msgid "" |
| 961 |
"You can also change settings in the conversion dialog for each book " |
| 962 |
"conversion. When you convert a book, calibre remembers the settings you used" |
| 963 |
" for that book, so that if you convert it again, the saved settings for the " |
| 964 |
"individual book will take precedence over the defaults set in " |
| 965 |
":guilabel:`Preferences`. You can restore the individual settings to defaults" |
| 966 |
" by using the :guilabel:`Restore defaults` button in the individual book " |
| 967 |
"conversion dialog. You can remove the saved settings for a group of books by" |
| 968 |
" selecting all the books and then clicking the :guilabel:`Edit metadata` " |
| 969 |
"button to bring up the bulk metadata edit dialog, near the bottom of the " |
| 970 |
"dialog is an option to remove stored conversion settings." |
| 971 |
msgstr "" |
| 972 |
|
| 973 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:616 |
| 974 |
msgid "" |
| 975 |
"When you bulk convert a set of books, settings are taken in the following " |
| 976 |
"order (last one wins):" |
| 977 |
msgstr "" |
| 978 |
|
| 979 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:618 |
| 980 |
msgid "From the defaults set in Preferences->Conversion" |
| 981 |
msgstr "" |
| 982 |
|
| 983 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:620 |
| 984 |
msgid "" |
| 985 |
"From the saved conversion settings for each book being converted (if any). " |
| 986 |
"This can be turned off by the option in the top left corner of the Bulk " |
| 987 |
"conversion dialog." |
| 988 |
msgstr "" |
| 989 |
|
| 990 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:624 |
| 991 |
msgid "From the settings set in the Bulk conversion dialog" |
| 992 |
msgstr "" |
| 993 |
|
| 994 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:626 |
| 995 |
msgid "" |
| 996 |
"Note that the final settings for each book in a Bulk conversion will be " |
| 997 |
"saved and re-used if the book is converted again. Since the highest priority" |
| 998 |
" in Bulk Conversion is given to the settings in the Bulk conversion dialog, " |
| 999 |
"these will override any book specific settings. So you should only bulk " |
| 1000 |
"convert books together that need similar settings. The exceptions are " |
| 1001 |
"metadata and input format specific settings. Since the Bulk conversion " |
| 1002 |
"dialog does not have settings for these two categories, they will be taken " |
| 1003 |
"from book specific settings (if any) or the defaults." |
| 1004 |
msgstr "" |
| 1005 |
|
| 1006 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:637 |
| 1007 |
msgid "" |
| 1008 |
"You can see the actual settings used during any conversion by clicking the " |
| 1009 |
"rotating icon in the lower right corner and then double clicking the " |
| 1010 |
"individual conversion job. This will bring up a conversion log that will " |
| 1011 |
"contain the actual settings used, near the top." |
| 1012 |
msgstr "" |
| 1013 |
|
| 1014 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:642 |
| 1015 |
msgid "Format specific tips" |
| 1016 |
msgstr "" |
| 1017 |
|
| 1018 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:644 |
| 1019 |
msgid "" |
| 1020 |
"Here you will find tips specific to the conversion of particular formats. " |
| 1021 |
"Options specific to particular format, whether input or output are available" |
| 1022 |
" in the conversion dialog under their own section, for example `TXT input` " |
| 1023 |
"or `EPUB output`." |
| 1024 |
msgstr "" |
| 1025 |
|
| 1026 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:649 |
| 1027 |
msgid "Convert Microsoft Word documents" |
| 1028 |
msgstr "" |
| 1029 |
|
| 1030 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:651 |
| 1031 |
msgid "" |
| 1032 |
"calibre can automatically convert ``.docx`` files created by Microsoft Word " |
| 1033 |
"2007 and newer. Just add the file to calibre and click convert." |
| 1034 |
msgstr "" |
| 1035 |
|
| 1036 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:655 |
| 1037 |
msgid "" |
| 1038 |
"There is a :download_file:`demo .docx file <demos/demo.docx>` that " |
| 1039 |
"demonstrates the capabilities of the calibre conversion engine. Just " |
| 1040 |
"download it and convert it to EPUB or AZW3 to see what calibre can do." |
| 1041 |
msgstr "" |
| 1042 |
|
| 1043 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:659 |
| 1044 |
msgid "" |
| 1045 |
"calibre will automatically generate a Table of Contents based on headings if" |
| 1046 |
" you mark your headings with the ``Heading 1``, ``Heading 2``, etc. styles " |
| 1047 |
"in Microsoft Word. Open the output e-book in the calibre E-book viewer and " |
| 1048 |
"click the :guilabel:`Table of Contents` button to view the generated Table " |
| 1049 |
"of Contents." |
| 1050 |
msgstr "" |
| 1051 |
|
| 1052 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:665 |
| 1053 |
msgid "Older .doc files" |
| 1054 |
msgstr "" |
| 1055 |
|
| 1056 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:667 |
| 1057 |
msgid "" |
| 1058 |
"For older .doc files, you can save the document as HTML with Microsoft Word " |
| 1059 |
"and then convert the resulting HTML file with calibre. When saving as HTML, " |
| 1060 |
"be sure to use the \"Save as Web Page, Filtered\" option as this will " |
| 1061 |
"produce clean HTML that will convert well. Note that Word produces really " |
| 1062 |
"messy HTML, converting it can take a long time, so be patient. If you have a" |
| 1063 |
" newer version of Word available, you can directly save it as .docx as well." |
| 1064 |
msgstr "" |
| 1065 |
|
| 1066 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:674 |
| 1067 |
msgid "" |
| 1068 |
"Another alternative is to use the free LibreOffice. Open your .doc file in " |
| 1069 |
"LibreOffice and save it as .docx, which can be directly converted in " |
| 1070 |
"calibre." |
| 1071 |
msgstr "" |
| 1072 |
|
| 1073 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:678 |
| 1074 |
msgid "Convert TXT documents" |
| 1075 |
msgstr "" |
| 1076 |
|
| 1077 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:680 |
| 1078 |
msgid "" |
| 1079 |
"TXT documents have no well defined way to specify formatting like bold, " |
| 1080 |
"italics, etc, or document structure like paragraphs, headings, sections and " |
| 1081 |
"so on, but there are a variety of conventions commonly used. By default " |
| 1082 |
"calibre attempts automatic detection of the correct formatting and markup " |
| 1083 |
"based on those conventions." |
| 1084 |
msgstr "" |
| 1085 |
|
| 1086 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:685 |
| 1087 |
msgid "" |
| 1088 |
"TXT input supports a number of options to differentiate how paragraphs are " |
| 1089 |
"detected." |
| 1090 |
msgstr "" |
| 1091 |
|
| 1092 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:687 |
| 1093 |
msgid ":guilabel:`Paragraph style: Auto`" |
| 1094 |
msgstr "" |
| 1095 |
|
| 1096 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:688 |
| 1097 |
msgid "" |
| 1098 |
"Analyzes the text file and attempts to automatically determine how " |
| 1099 |
"paragraphs are defined. This option will generally work fine, if you " |
| 1100 |
"achieve undesirable results try one of the manual options." |
| 1101 |
msgstr "" |
| 1102 |
|
| 1103 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:691 |
| 1104 |
msgid ":guilabel:`Paragraph style: Block`" |
| 1105 |
msgstr "" |
| 1106 |
|
| 1107 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:692 |
| 1108 |
msgid "Assumes one or more blank lines are a paragraph boundary::" |
| 1109 |
msgstr "" |
| 1110 |
|
| 1111 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:699 |
| 1112 |
msgid ":guilabel:`Paragraph style: Single`" |
| 1113 |
msgstr "" |
| 1114 |
|
| 1115 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:700 |
| 1116 |
msgid "Assumes that every line is a paragraph::" |
| 1117 |
msgstr "" |
| 1118 |
|
| 1119 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:706 |
| 1120 |
msgid ":guilabel:`Paragraph style: Print`" |
| 1121 |
msgstr "" |
| 1122 |
|
| 1123 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:707 |
| 1124 |
msgid "" |
| 1125 |
"Assumes that every paragraph starts with an indent (either a tab or 2+ " |
| 1126 |
"spaces). Paragraphs end when the next line that starts with an indent is " |
| 1127 |
"reached::" |
| 1128 |
msgstr "" |
| 1129 |
|
| 1130 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:717 |
| 1131 |
msgid ":guilabel:`Paragraph style: Unformatted`" |
| 1132 |
msgstr "" |
| 1133 |
|
| 1134 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:718 |
| 1135 |
msgid "" |
| 1136 |
"Assumes that the document has no formatting, but does use hard line breaks." |
| 1137 |
" Punctuation and median line length are used to attempt to re-create " |
| 1138 |
"paragraphs." |
| 1139 |
msgstr "" |
| 1140 |
|
| 1141 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:721 |
| 1142 |
msgid ":guilabel:`Formatting style: Auto`" |
| 1143 |
msgstr "" |
| 1144 |
|
| 1145 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:722 |
| 1146 |
msgid "" |
| 1147 |
"Attempts to detect the type of formatting markup being used. If no markup " |
| 1148 |
"is used then heuristic formatting will be applied." |
| 1149 |
msgstr "" |
| 1150 |
|
| 1151 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:725 |
| 1152 |
msgid ":guilabel:`Formatting style: Heuristic`" |
| 1153 |
msgstr "" |
| 1154 |
|
| 1155 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:726 |
| 1156 |
msgid "" |
| 1157 |
"Analyzes the document for common chapter headings, scene breaks, and " |
| 1158 |
"italicized words and applies the appropriate HTML markup during conversion." |
| 1159 |
msgstr "" |
| 1160 |
|
| 1161 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:729 |
| 1162 |
msgid ":guilabel:`Formatting style: Markdown`" |
| 1163 |
msgstr "" |
| 1164 |
|
| 1165 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:730 |
| 1166 |
msgid "" |
| 1167 |
"calibre also supports running TXT input though a transformation preprocessor" |
| 1168 |
" known as Markdown. Markdown allows for basic formatting to be added to TXT " |
| 1169 |
"documents, such as bold, italics, section headings, tables, lists, a Table " |
| 1170 |
"of Contents, etc. Marking chapter headings with a leading # and setting the " |
| 1171 |
"chapter XPath detection expression to \"//h:h1\" is the easiest way to have " |
| 1172 |
"a proper table of contents generated from a TXT document. You can learn more" |
| 1173 |
" about the Markdown syntax at `daringfireball " |
| 1174 |
"<https://daringfireball.net/projects/markdown/syntax>`_." |
| 1175 |
msgstr "" |
| 1176 |
|
| 1177 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:736 |
| 1178 |
msgid ":guilabel:`Formatting style: None`" |
| 1179 |
msgstr "" |
| 1180 |
|
| 1181 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:737 |
| 1182 |
msgid "" |
| 1183 |
"Applies no special formatting to the text, the document is converted to HTML" |
| 1184 |
" with no other changes." |
| 1185 |
msgstr "" |
| 1186 |
|
| 1187 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:742 |
| 1188 |
msgid "Convert PDF documents" |
| 1189 |
msgstr "" |
| 1190 |
|
| 1191 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:744 |
| 1192 |
msgid "" |
| 1193 |
"PDF documents are one of the worst formats to convert from. They are a fixed" |
| 1194 |
" page size and text placement format. Meaning, it is very difficult to " |
| 1195 |
"determine where one paragraph ends and another begins. calibre will try to " |
| 1196 |
"unwrap paragraphs using a configurable, :guilabel:`Line un-wrapping factor`." |
| 1197 |
" This is a scale used to determine the length at which a line should be " |
| 1198 |
"unwrapped. Valid values are a decimal between 0 and 1. The default is 0.45, " |
| 1199 |
"just under the median line length. Lower this value to include more text in " |
| 1200 |
"the unwrapping. Increase to include less. You can adjust this value in the " |
| 1201 |
"conversion settings under :guilabel:`PDF Input`." |
| 1202 |
msgstr "" |
| 1203 |
|
| 1204 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:751 |
| 1205 |
msgid "" |
| 1206 |
"Also, they often have headers and footers as part of the document that will " |
| 1207 |
"become included with the text. Use the :guilabel:`Search and replace` panel " |
| 1208 |
"to remove headers and footers to mitigate this issue. If the headers and " |
| 1209 |
"footers are not removed from the text it can throw off the paragraph " |
| 1210 |
"unwrapping. To learn how to use the header and footer removal options, read " |
| 1211 |
":ref:`regexptutorial`." |
| 1212 |
msgstr "" |
| 1213 |
|
| 1214 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:756 |
| 1215 |
msgid "Some limitations of PDF input are:" |
| 1216 |
msgstr "" |
| 1217 |
|
| 1218 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:758 |
| 1219 |
msgid "Complex, multi-column, and image based documents are not supported." |
| 1220 |
msgstr "" |
| 1221 |
|
| 1222 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:759 |
| 1223 |
msgid "" |
| 1224 |
"Extraction of vector images and tables from within the document is also not " |
| 1225 |
"supported." |
| 1226 |
msgstr "" |
| 1227 |
|
| 1228 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:760 |
| 1229 |
msgid "" |
| 1230 |
"Some PDFs use special glyphs to represent ll or ff or fi, etc. Conversion of" |
| 1231 |
" these may or may not work depending on just how they are represented " |
| 1232 |
"internally in the PDF." |
| 1233 |
msgstr "" |
| 1234 |
|
| 1235 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:761 |
| 1236 |
msgid "Links and Tables of Contents are not supported" |
| 1237 |
msgstr "" |
| 1238 |
|
| 1239 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:762 |
| 1240 |
msgid "" |
| 1241 |
"PDFs that use embedded non-Unicode fonts to represent non-English characters" |
| 1242 |
" will result in garbled output for those characters" |
| 1243 |
msgstr "" |
| 1244 |
|
| 1245 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:763 |
| 1246 |
msgid "" |
| 1247 |
"Some PDFs are made up of photographs of the page with OCRed text behind " |
| 1248 |
"them. In such cases calibre uses the OCRed text, which can be very different" |
| 1249 |
" from what you see when you view the PDF file" |
| 1250 |
msgstr "" |
| 1251 |
|
| 1252 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:764 |
| 1253 |
msgid "" |
| 1254 |
"PDFs that are used to display complex text, like right to left languages and" |
| 1255 |
" math typesetting will not convert correctly" |
| 1256 |
msgstr "" |
| 1257 |
|
| 1258 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:766 |
| 1259 |
msgid "" |
| 1260 |
"To re-iterate **PDF is a really, really bad** format to use as input. If you" |
| 1261 |
" absolutely must use PDF, then be prepared for an output ranging anywhere " |
| 1262 |
"from decent to unusable, depending on the input PDF." |
| 1263 |
msgstr "" |
| 1264 |
|
| 1265 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:770 |
| 1266 |
msgid "Comic book collections" |
| 1267 |
msgstr "" |
| 1268 |
|
| 1269 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:772 |
| 1270 |
msgid "" |
| 1271 |
"A comic book collection is a .cbc file. A .cbc file is a ZIP file that " |
| 1272 |
"contains other CBZ/CBR files. In addition the .cbc file must contain a " |
| 1273 |
"simple text file called comics.txt, encoded in UTF-8. The comics.txt file " |
| 1274 |
"must contain a list of the comics files inside the .cbc file, in the form " |
| 1275 |
"filename:title, as shown below::" |
| 1276 |
msgstr "" |
| 1277 |
|
| 1278 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:780 |
| 1279 |
msgid "The .cbc file will then contain::" |
| 1280 |
msgstr "" |
| 1281 |
|
| 1282 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:787 |
| 1283 |
msgid "" |
| 1284 |
"calibre will automatically convert this .cbc file into a e-book with a Table" |
| 1285 |
" of Contents pointing to each entry in comics.txt." |
| 1286 |
msgstr "" |
| 1287 |
|
| 1288 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:791 |
| 1289 |
msgid "EPUB advanced formatting demo" |
| 1290 |
msgstr "" |
| 1291 |
|
| 1292 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:793 |
| 1293 |
msgid "" |
| 1294 |
"Various advanced formatting for EPUB files is demonstrated in this " |
| 1295 |
":download_file:`demo file <demos/demo.epub>`. The file was created from hand" |
| 1296 |
" coded HTML using calibre and is meant to be used as a template for your own" |
| 1297 |
" EPUB creation efforts." |
| 1298 |
msgstr "" |
| 1299 |
|
| 1300 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:796 |
| 1301 |
msgid "" |
| 1302 |
"The source HTML it was created from is available :download_file:`demo.zip " |
| 1303 |
"<demos/demo.zip>`. The settings used to create the EPUB from the ZIP file " |
| 1304 |
"are::" |
| 1305 |
msgstr "" |
| 1306 |
|
| 1307 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:801 |
| 1308 |
msgid "" |
| 1309 |
"Note that because this file explores the potential of EPUB, most of the " |
| 1310 |
"advanced formatting is not going to work on readers less capable than " |
| 1311 |
"calibre's built-in EPUB viewer." |
| 1312 |
msgstr "" |
| 1313 |
|
| 1314 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:805 |
| 1315 |
msgid "Convert ODT documents" |
| 1316 |
msgstr "" |
| 1317 |
|
| 1318 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:807 |
| 1319 |
msgid "" |
| 1320 |
"calibre can directly convert ODT (OpenDocument Text) files. You should use " |
| 1321 |
"styles to format your document and minimize the use of direct formatting. " |
| 1322 |
"When inserting images into your document you need to anchor them to the " |
| 1323 |
"paragraph, images anchored to a page will all end up in the front of the " |
| 1324 |
"conversion." |
| 1325 |
msgstr "" |
| 1326 |
|
| 1327 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:810 |
| 1328 |
msgid "" |
| 1329 |
"To enable automatic detection of chapters, you need to mark them with the " |
| 1330 |
"built-in styles called :guilabel:`Heading 1`, :guilabel:`Heading 2`, ..., " |
| 1331 |
":guilabel:`Heading 6` (:guilabel:`Heading 1` equates to the HTML tag " |
| 1332 |
"``<h1>``, :guilabel:`Heading 2` to ``<h2>``, etc). When you convert in " |
| 1333 |
"calibre you can enter which style you used into the :guilabel:`Detect " |
| 1334 |
"chapters at` box. Example:" |
| 1335 |
msgstr "" |
| 1336 |
|
| 1337 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:816 |
| 1338 |
msgid "" |
| 1339 |
"If you mark Chapters with style :guilabel:`Heading 2`, you have to set the " |
| 1340 |
"'Detect chapters at' box to ``//h:h2``" |
| 1341 |
msgstr "" |
| 1342 |
|
| 1343 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:817 |
| 1344 |
msgid "" |
| 1345 |
"For a nested TOC with Sections marked with :guilabel:`Heading 2` and the " |
| 1346 |
"Chapters marked with :guilabel:`Heading 3` you need to enter " |
| 1347 |
"``//h:h2|//h:h3``. On the Convert - TOC page set the :guilabel:`Level 1 TOC`" |
| 1348 |
" box to ``//h:h2`` and the :guilabel:`Level 2 TOC` box to ``//h:h3``." |
| 1349 |
msgstr "" |
| 1350 |
|
| 1351 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:819 |
| 1352 |
msgid "" |
| 1353 |
"Well-known document properties (Title, Keywords, Description, Creator) are " |
| 1354 |
"recognized and calibre will use the first image (not to small, and with good" |
| 1355 |
" aspect-ratio) as the cover image." |
| 1356 |
msgstr "" |
| 1357 |
|
| 1358 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:821 |
| 1359 |
msgid "" |
| 1360 |
"There is also an advanced property conversion mode, which is activated by " |
| 1361 |
"setting the custom property ``opf.metadata`` ('Yes or No' type) to Yes in " |
| 1362 |
"your ODT document (File->Properties->Custom Properties). If this property is" |
| 1363 |
" detected by calibre, the following custom properties are recognized " |
| 1364 |
"(``opf.authors`` overrides document creator)::" |
| 1365 |
msgstr "" |
| 1366 |
|
| 1367 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:834 |
| 1368 |
msgid "" |
| 1369 |
"In addition to this, you can specify the picture to use as the cover by " |
| 1370 |
"naming it ``opf.cover`` (right click, Picture->Options->Name) in the ODT. If" |
| 1371 |
" no picture with this name is found, the 'smart' method is used. As the " |
| 1372 |
"cover detection might result in double covers in certain output formats, the" |
| 1373 |
" process will remove the paragraph (only if the only content is the cover!) " |
| 1374 |
"from the document. But this works only with the named picture!" |
| 1375 |
msgstr "" |
| 1376 |
|
| 1377 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:841 |
| 1378 |
msgid "" |
| 1379 |
"To disable cover detection you can set the custom property ``opf.nocover`` " |
| 1380 |
"('Yes or No' type) to Yes in advanced mode." |
| 1381 |
msgstr "" |
| 1382 |
|
| 1383 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:844 |
| 1384 |
msgid "Converting to PDF" |
| 1385 |
msgstr "" |
| 1386 |
|
| 1387 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:846 |
| 1388 |
msgid "" |
| 1389 |
"The first, most important, setting to decide on when converting to PDF is " |
| 1390 |
"the page size. By default, calibre uses a page size of \"U.S. Letter\". You " |
| 1391 |
"can change this to another standard page size or a completely custom size in" |
| 1392 |
" the :guilabel:`PDF Output` section of the conversion dialog. If you are " |
| 1393 |
"generating a PDF to be used on a specific device, you can turn on the option" |
| 1394 |
" to use the page size from the :guilabel:`output profile` instead. So if " |
| 1395 |
"your output profile is set to Kindle, calibre will create a PDF with page " |
| 1396 |
"size suitable for viewing on the small Kindle screen." |
| 1397 |
msgstr "" |
| 1398 |
|
| 1399 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:856 |
| 1400 |
msgid "Headers and Footers" |
| 1401 |
msgstr "" |
| 1402 |
|
| 1403 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:857 |
| 1404 |
msgid "" |
| 1405 |
"You can insert arbitrary headers and footers on each page of the PDF by " |
| 1406 |
"specifying header and footer templates. Templates are just snippets of HTML " |
| 1407 |
"code that get rendered in the header and footer locations. For example, to " |
| 1408 |
"display page numbers centered at the bottom of every page, in green, use the" |
| 1409 |
" following footer template::" |
| 1410 |
msgstr "" |
| 1411 |
|
| 1412 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:865 |
| 1413 |
msgid "" |
| 1414 |
"calibre will automatically replace :code:`_PAGENUM_` with the current page " |
| 1415 |
"number. You can even put different content on even and odd pages, for " |
| 1416 |
"example the following header template will show the title on odd pages and " |
| 1417 |
"the author on even pages::" |
| 1418 |
msgstr "" |
| 1419 |
|
| 1420 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:874 |
| 1421 |
msgid "" |
| 1422 |
"calibre will automatically replace :code:`_TITLE_` and :code:`_AUTHOR_` with" |
| 1423 |
" the title and author of the document being converted. Setting " |
| 1424 |
":code:`justify-content` to :code:`flex-end` will cause the text to be right " |
| 1425 |
"aligned." |
| 1426 |
msgstr "" |
| 1427 |
|
| 1428 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:879 |
| 1429 |
msgid "" |
| 1430 |
"You can also display text at the left and right edges and change the font " |
| 1431 |
"size, as demonstrated with this header template::" |
| 1432 |
msgstr "" |
| 1433 |
|
| 1434 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:887 |
| 1435 |
msgid "" |
| 1436 |
"This will display the title at the left and the author at the right, in a " |
| 1437 |
"font size smaller than the main text." |
| 1438 |
msgstr "" |
| 1439 |
|
| 1440 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:890 |
| 1441 |
msgid "You can also use the current section in templates, as shown below::" |
| 1442 |
msgstr "" |
| 1443 |
|
| 1444 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:894 |
| 1445 |
msgid "" |
| 1446 |
":code:`_SECTION_` is replaced by whatever the name of the current section " |
| 1447 |
"is. These names are taken from the metadata Table of Contents in the " |
| 1448 |
"document (the PDF Outline). If the document has no table of contents then it" |
| 1449 |
" will be replaced by empty text. If a single PDF page has multiple sections," |
| 1450 |
" the first section on the page will be used. Similarly, there is a variable " |
| 1451 |
"named :code:`_TOP_LEVEL_SECTION_` that can be used to get the name of the " |
| 1452 |
"current top-level section." |
| 1453 |
msgstr "" |
| 1454 |
|
| 1455 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:901 |
| 1456 |
msgid "" |
| 1457 |
"You can even use JavaScript inside the header and footer templates, for " |
| 1458 |
"example, the following template will cause page numbers to start at 4 " |
| 1459 |
"instead of 1::" |
| 1460 |
msgstr "" |
| 1461 |
|
| 1462 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:911 |
| 1463 |
msgid "" |
| 1464 |
"In addition there are some more variables you can use in the headers and " |
| 1465 |
"footers, documented below:" |
| 1466 |
msgstr "" |
| 1467 |
|
| 1468 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:914 |
| 1469 |
msgid "" |
| 1470 |
"``_TOTAL_PAGES_`` - total number of pages in the PDF file, useful for " |
| 1471 |
"implementing a progress counter, for example." |
| 1472 |
msgstr "" |
| 1473 |
|
| 1474 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:916 |
| 1475 |
msgid "" |
| 1476 |
"``_TOP_LEVEL_SECTION_PAGES_`` - total number of pages in the current top " |
| 1477 |
"level section" |
| 1478 |
msgstr "" |
| 1479 |
|
| 1480 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:918 |
| 1481 |
msgid "" |
| 1482 |
"``_TOP_LEVEL_SECTION_PAGENUM_`` - the page number of the current page within" |
| 1483 |
" the current top level section" |
| 1484 |
msgstr "" |
| 1485 |
|
| 1486 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:920 |
| 1487 |
msgid "``_WIDTH_PIXELS_`` - the width of the header/footer area in pixels" |
| 1488 |
msgstr "" |
| 1489 |
|
| 1490 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:921 |
| 1491 |
msgid "``_HEIGHT_PIXELS_`` - the height of the header/footer area in pixels" |
| 1492 |
msgstr "" |
| 1493 |
|
| 1494 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:923 |
| 1495 |
msgid "" |
| 1496 |
"When adding headers and footers make sure you set the page top and bottom " |
| 1497 |
"margins to large enough values, under the :guilabel:`PDF Output` section of " |
| 1498 |
"the conversion dialog." |
| 1499 |
msgstr "" |
| 1500 |
|
| 1501 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:928 |
| 1502 |
msgid "Printable Table of Contents" |
| 1503 |
msgstr "" |
| 1504 |
|
| 1505 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:930 |
| 1506 |
msgid "" |
| 1507 |
"You can also insert a printable Table of Contents at the end of the PDF that" |
| 1508 |
" lists the page numbers for every section. This is very useful if you intend" |
| 1509 |
" to print out the PDF to paper. If you wish to use the PDF on an electronic " |
| 1510 |
"device, then the PDF Outline provides this functionality and is generated by" |
| 1511 |
" default." |
| 1512 |
msgstr "" |
| 1513 |
|
| 1514 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:935 |
| 1515 |
msgid "" |
| 1516 |
"You can customize the look of the generated Table of contents by using the " |
| 1517 |
"Extra CSS conversion setting under the Look & feel part of the conversion " |
| 1518 |
"dialog. The default CSS used is listed below, simply copy it and make " |
| 1519 |
"whatever changes you like." |
| 1520 |
msgstr "" |
| 1521 |
|
| 1522 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:955 |
| 1523 |
msgid "Custom page margins for individual HTML files" |
| 1524 |
msgstr "" |
| 1525 |
|
| 1526 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:957 |
| 1527 |
msgid "" |
| 1528 |
"If you are converting an EPUB or AZW3 file with multiple individual HTML " |
| 1529 |
"files inside it and you want to change the page margins for a particular " |
| 1530 |
"HTML file you can add the following style block to the HTML file using the " |
| 1531 |
"calibre E-book editor:" |
| 1532 |
msgstr "" |
| 1533 |
|
| 1534 |
#: ../../../__w/calibre/calibre/manual/conversion.rst:974 |
| 1535 |
msgid "" |
| 1536 |
"Then, in the PDF output section of the conversion dialog, turn on the option" |
| 1537 |
" to :guilabel:`Use page margins from the document being converted`. Now all " |
| 1538 |
"pages generated from this HTML file will have ``10pt`` margins." |
| 1539 |
msgstr "" |