Debian Codegraph @

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