Debian Codegraph @

translations/manual/fa/conversion.po

raw
1 # SOME DESCRIPTIVE TITLE.
2 # Copyright (C) Kovid Goyal
3 # This file is distributed under the same license as the calibre package.
4 #
5 # Translators:
6 msgid ""
7 msgstr ""
8 "Project-Id-Version: calibre\n"
9 "Report-Msgid-Bugs-To: \n"
10 "POT-Creation-Date: 2025-09-17 17:36+0000\n"
11 "PO-Revision-Date: 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 ""