Debian Codegraph @

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