EBOOK-CONVERT(1) calibre EBOOK-CONVERT(1) NAME ebook-convert - ebook-convert ebook-convert input_file output_file [options] Convert an e-book from one format to another. input_file is the input and output_file is the output. Both must be specified as the first two arguments to the command. The output e-book format is guessed from the file extension of output_file. output_file can also be of the special format .EXT where EXT is the output file extension. In this case, the name of the output file is derived from the name of the input file. Note that the filenames must not start with a hyphen. Finally, if output_file has no extension, then it is treated as a folder and an "open e-book" (OEB) consisting of HTML files is written to that folder. These files are the files that would normally have been passed to the output plugin. After specifying the input and output file you can customize the conversion by specifying various options. The available options depend on the input and output file types. To get help on them specify the input and output file and then use the -h option. For full documentation of the conversion system see Whenever you pass arguments to ebook-convert that have spaces in them, enclose the arguments in quotation marks. For example: "/some path/with spaces" The options and default values for the options change depending on both the input and output formats, so you should always check with: ebook-convert myfile.input_format myfile.output_format -h Below are the options that are common to all conversion, followed by the options specific to every input and output format. o o o o (Heuristic) o o o o o --help, -h --input-profile . . , (, ). : cybookg3, cybook_opus, default, hanlinv3, hanlinv5, illiad, irexdr1000, irexdr800, kindle, msreader, mobipocket, nook, sony, sony300, sony900 --list-recipes . : ebook-convert " .recipe" .epub --output-profile . . , , . :cybookg3, cybook_opus, default, hanlinv3, hanlinv5, illiad, ipad, ipad3, irexdr1000, irexdr800, jetbook5, kindle, kindle_dx, kindle_fire, kindle_oasis, kindle_pw, kindle_pw3, kindle_scribe, kindle_voyage, kobo, msreader, mobipocket, nook, nook_color, nook_hd_plus, pocketbook_inkpad3, pocketbook_lux, pocketbook_hd, pocketbook_900, pocketbook_pro_912, galaxy, sony, sony300, sony900, sony-landscape, sonyt3, generic_eink, generic_eink_hd, generic_eink_large, tablet --version . mobi . --input-encoding . . . epub . --dont-split-on-page-breaks . . . , . --epub-flatten EPUB FBReaderJ . EPUB , . --epub-inline-toc . --epub-max-image-size The maximum image size (width x height). A value of none means use the screen size from the output profile. A value of profile means no maximum size is specified. For example, a value of 100x200 will cause all images to be resized so that their width is no more than 100 pixels and their height is no more than 200 pixels. Note that this only affects the size of the actual image files themselves. Any given image may be rendered at a different size depending on the styling applied to it in the document. --epub-toc-at-end . --epub-version The version of the EPUB file to generate. EPUB 2 is the most widely compatible, only use EPUB 3 if you know you actually need it. --extract-to Extract the contents of the generated EPUB file to the specified folder. The contents of the folder are first deleted, so be careful. --flow-size Split all HTML files larger than this size (in KB). This is necessary as most EPUB readers cannot handle large file sizes. The default of 260KB is the size required for Adobe Digital Editions. Set to 0 to disable size based splitting. --no-default-epub-cover , , , . . --no-svg-cover SVG . EPUB iPhone JetBook Lite SVG . , . --preserve-cover-aspect-ratio SVG ( ) . , . . --pretty-print , . . --toc-title Title for any generated inline table of contents. --asciiize Transliterate Unicode characters to an ASCII representation. Use with care because this will replace Unicode characters with ASCII. For instance it will replace "Pele" with "Pele". Also, note that in cases where there are multiple representations of a character (characters shared by Chinese and Japanese for instance) the representation based on the current calibre interface language will be used. --base-font-size pts . . , . 0 , . --change-justification . "" (, ) . " " . ""() . . --disable-font-rescaling . --embed-all-fonts . . EPUB, AZW3, DOCX PDF . . --embed-font-family . "" . . . EPUB, AZW3 DOCX . --expand-css By default, calibre will use the shorthand form for various CSS properties such as margin, padding, border, etc. This option will cause it to use the full expanded form instead. Note that CSS is always expanded when generating EPUB files with the output profile set to one of the Nook profiles as the Nook cannot handle shorthand CSS. --extra-css CSS CSS . CSS . --filter-css CSS , , CSS . . : font-family, color, margin-left, margin-right --font-size-mapping CSS pts . , 12,12,14,16,18,20,22,24 . xx-small xx-large , huge font . . . --insert-blank-line . (

,

) . --insert-blank-line-size (em ). . --keep-ligatures Preserve ligatures present in the input document. A ligature is a combined character of a pair of characters like ff, fi, fl et cetera. Most readers do not have support for ligatures in their default fonts, so they are unlikely to render correctly. By default, calibre will turn a ligature into the corresponding pair of normal characters. Note that ligatures here mean only unicode ligatures not ligatures created via CSS or font styles. This option will preserve them instead. --line-height pt . . , . , . --linearize-tables . , . . --margin-bottom pt . 5.0. 0 ( ). : PDF DOCX . --margin-left pt . 5.0. 0 ( ). : PDF DOCX . --margin-right pt . 5.0. 0 ( ). : PDF DOCX . --margin-top pt . 5.0. 0 ( ). : PDF DOCX . --minimum-line-height . . 0 . 120%. . , 240 " " . --remove-paragraph-spacing . 1.5em . (

,

) . --remove-paragraph-spacing-indent-size , . (em ) . , (, ). --smarten-punctuation Convert plain quotes, dashes and ellipsis to their typographically correct equivalents. For details, see https://daringfireball.net/projects/smartypants. --subset-embedded-fonts (embedded font) . . . --transform-css-rules Path to a file containing rules to transform the CSS styles in this book. The easiest way to create such a file is to use the wizard for creating rules in the calibre GUI. Access it in the "Look & feel->Transform styles" section of the conversion dialog. Once you create the rules, you can use the "Export" button to save them to a file. --transform-html-rules Path to a file containing rules to transform the HTML in this book. The easiest way to create such a file is to use the wizard for creating rules in the calibre GUI. Access it in the "Look & feel->Transform HTML" section of the conversion dialog. Once you create the rules, you can use the "Export" button to save them to a file. --unsmarten-punctuation , , . (HEURISTIC) . . --enable-heuristics . --disable-* . --disable-dehyphenate . . --disable-delete-blank-paragraphs --disable-fix-indents CSS . --disable-format-scene-breaks . . --disable-italicize-common-cases . --disable-markup-chapter-headings () . h2 h3 . . --disable-renumber-headings

. . --disable-unwrap-lines . --enable-heuristics . . --html-unwrap-factor . 0 1 . 0.4, . --replace-scene-breaks . , . . --search-replace Path to a file containing search and replace regular expressions. The file must contain alternating lines of regular expression followed by replacement pattern (which can be an empty line). The regular expression must be in the Python regex syntax and the file must be UTF-8 encoded. --sr1-replace sr1-search . --sr1-search sr1-replace (). --sr2-replace sr2-search . --sr2-search Search pattern (regular expression) to be replaced with sr2-replace. --sr3-replace sr3-search . --sr3-search Search pattern (regular expression) to be replaced with sr3-replace. . --add-alt-text-to-img When an tag has no alt attribute, check the associated image file for metadata that specifies alternate text, and use it to fill in the alt attribute. The alt attribute is used by screen readers for assisting the visually challenged. --chapter () XPath . "chapter", "book", "section", "prologue", "epilogue", "part"

class="chapter" . . "/" . XPath . --chapter-mark . "pagebreak" . "rule" . "none" , "both" . --disable-remove-fake-margins . . . . --insert-metadata . / . --page-breaks-before XPath . . : / --prefer-metadata-cover . --remove-first-image . . , . --start-reading-at XPath . ( Kindle) . XPath . . , . --duplicate-links-in-toc , . , . --level1-toc 1 XPath . , . XPath . --level2-toc 2 XPath . 1 . XPath . --level3-toc 3 XPath . 2 . XPath . --max-toc-links . 0 . : 50. . --no-chapters-in-toc () . --toc-filter . () . --toc-threshold () , . : 6 --use-auto-toc , . , . . --author-sort . --authors . && . --book-producer . --comments . --cover URL --isbn ISBN . --language . --pubdate Set the publication date (assumed to be in the local timezone, unless the timezone is explicitly specified) --publisher . --rating . 1 5 . --read-metadata-from-opf, --from-opf, -m OPF . . --series . --series-index . --tags . (,) . --timestamp ( ) --title . --title-sort . --debug-pipeline, -d Save the output from different stages of the conversion pipeline to the specified folder. Useful if you are unsure at which stage of the conversion process a bug is occurring. --verbose, -v Level of verbosity. Specify multiple times for greater verbosity. Specifying it twice will result in full verbosity, once medium verbosity and zero times least verbosity. AUTHOR Kovid Goyal COPYRIGHT Kovid Goyal 7.17.0 8 23, 2024 EBOOK-CONVERT(1)