any2epub

Langue: en

Autres versions - même langue

Version: April 2009 (ubuntu - 07/07/09)

Section: 1 (Commandes utilisateur)

NAME

any2epub - part of calibre

SYNOPSIS

any2epub [options] filename

DESCRIPTION

Convert any of a large number of ebook formats to a EPUB file. Supported formats are: ['html', 'rar', 'zip', 'oebzip', 'lit', 'fb2', 'mobi', 'epub', 'prc', 'pdf', 'txt', 'odt', 'rtf', 'azw']

Whenever you pass arguments to any2epub that have spaces in them, enclose the arguments in quotation marks.

OPTIONS

--version
show program's version number and exit
-h, --help
show this help message and exit
--encoding=ENCODING
Character encoding for HTML files. Default is to auto detect.
-o OUTPUT, --output=OUTPUT
The output EPUB file. If not specified, it is derived from the input file name.
--profile=PROFILE
Profile of the target device this EPUB is meant for. Set to None to create a device independent EPUB. The profile is used for device specific restrictions on the EPUB. Choices are: ['PRS505', 'None']
--override-css=OVERRIDE_CSS
Either the path to a CSS stylesheet or raw CSS. This CSS will override any existing CSS declarations in the source files.

PAGE LAYOUT:

Control page layout
--margin-top=MARGIN_TOP
Set the top margin in pts. Default is 5.0
--margin-bottom=MARGIN_BOTTOM
Set the bottom margin in pts. Default is 5.0
--margin-left=MARGIN_LEFT
Set the left margin in pts. Default is 5.0
--margin-right=MARGIN_RIGHT
Set the right margin in pts. Default is 5.0
--base-font-size=BASE_FONT_SIZE2
The base font size in pts. Default is 12.0pt. Set to 0 to disable rescaling of fonts.
--remove-paragraph-spacing
Remove spacing between paragraphs. Also sets a indent on paragraphs of 1.5em. You can override this by adding p {text-indent: 0cm} to --override-css. Spacing removal will not work if the source file forces interparagraph spacing.
--no-justification
Do not force text to be justified in output.
--linearize-tables
Remove table markup, converting it into paragraphs. This is useful if your source file uses a table to manage layout.
--preserve-tag-structure
Preserve the HTML tag structure while splitting large HTML files. This is only neccessary if the HTML files contain CSS that uses sibling selectors. Enabling this greatly slows down processing of large HTML files.

TRAVERSAL:

Control the following of links in HTML files.
--breadth-first
Traverse links in HTML files breadth first. Normally, they are traversed depth first
--max-levels=MAX_LEVELS
Maximum levels of recursion when following links in HTML files. Must be non-negative. 0 implies that no links in the root HTML file are followed.

TOC:

Control the automatic generation of a Table of Contents. If an OPF file is detected and it specifies a Table of Contents, then that will be used rather than trying to auto-generate a Table of Contents.
--max-toc-links=MAX_TOC_LINKS
Maximum number of links to insert into the TOC. Set to 0 to disable. Default is: 50. Links are only added to the TOC if less than the --toc-threshold number of chapters were detected.
--no-chapters-in-toc
Don't add auto-detected chapters to the Table of Contents.
--toc-threshold=TOC_THRESHOLD
If fewer than this number of chapters is detected, then links are added to the Table of Contents. Default: 6
--level1-toc=LEVEL1_TOC
XPath expression that specifies all tags that should be added to the Table of Contents at level one. If this is specified, it takes precedence over other forms of auto-detection.
--level2-toc=LEVEL2_TOC
XPath expression that specifies all tags that should be added to the Table of Contents at level two. Each entry is added under the previous level one entry.
--level3-toc=LEVEL3_TOC
XPath expression that specifies all tags that should be added to the Table of Contents at level three. Each entry is added under the previous level two entry.
--from-ncx=FROM_NCX
Path to a .ncx file that contains the table of contents to use for this ebook. The NCX file should contain links relative to the directory it is placed in. See http://www.niso.org/workrooms/daisy/Z39-86-200 5.html#NCX for an overview of the NCX format.
--use-auto-toc
Normally, if the source file already has a Table of Contents, it is used in preference to the autodetected one. With this option, the autodetected one is always used.

DEBUG:

Options useful for debugging
-v, --verbose
Be more verbose while processing. Can be specified multiple times to increase verbosity.
--pretty-print
Output HTML is "pretty printed" for easier parsing by humans
--show-opf
Print generated OPF file to stdout
--show-ncx
Print generated NCX file to stdout
--keep-intermediate-files
Keep intermediate files during processing by html2epub
--extract-to=EXTRACT_TO
Extract the contents of the produced EPUB file to the specified directory.

STRUCTURE DETECTION:

Control auto-detection of document structure.
--chapter=CHAPTER
An XPath expression to detect chapter titles. The default is to consider <h1> or <h2> tags that contain the words "chapter","book","section" or "part" as chapter titles as well as any tags that have class="chapter". The expression used must evaluate to a list of elements. To disable chapter detection, use the expression "/". See the XPath Tutorial in the calibre User Manual for further help on using this feature.
--chapter-mark=CHAPTER_MARK
Specify how to mark detected chapters. A value of "pagebreak" will insert page breaks before chapters. A value of "rule" will insert a line before chapters. A value of "none" will disable chapter marking and a value of "both" will use both page breaks and lines to mark chapters.
--cover=COVER
Path to the cover to be used for this book
--prefer-metadata-cover
Use the cover detected from the source file in preference to the specified cover.
--remove-first-image
Remove the first image from the input ebook. Useful if the first image in the source file is a cover and you are specifying an external cover.
--dont-split-on-page-breaks
Turn off splitting at page breaks. Normally, input files are automatically split at every page break into two files. This gives an output ebook that can be parsed faster and with less resources. However, splitting is slow and if your source file contains a very large number of page breaks, you should turn off splitting on page breaks.
--page=PAGE
XPath expression to detect page boundaries for building a custom pagination map, as used by AdobeDE. Default is not to build an explicit pagination map.
--page-names=PAGE_NAMES
XPath expression to find the name of each page in the pagination map relative to its boundary element. Default is to number all pages staring with 1.

METADATA:

Set metadata of the generated ebook
-t TITLE, --title=TITLE
Set the title. Default is to autodetect.
-a AUTHORS, --authors=AUTHORS
The author(s) of the ebook, as a & separated list.
--subjects=TAGS
The subject(s) of this book, as a comma separated list.
--publisher=PUBLISHER
Set the publisher of this book.
--comment=COMMENTS
A summary of this book.
--metadata-from=FROM_OPF
Load metadata from the specified OPF file

Created by Kovid Goyal <kovid@kovidgoyal.net>

SEE ALSO

http://calibre.kovidgoyal.net