Rechercher une page de manuel
html2lrf
Langue: en
Version: April 2009 (ubuntu - 07/07/09)
Section: 1 (Commandes utilisateur)
Sommaire
NAME
html2lrf - part of calibreSYNOPSIS
html2lrf [options] mybook.htmlDESCRIPTION
html2lrf converts mybook.html to mybook.lrf. html2lrf follows all links in mybook.html that point to local files recursively. Thus, you can use it to convert a whole tree of HTML files.Whenever you pass arguments to html2lrf 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
- -o OUTPUT, --output=OUTPUT
- Output file name. Default is derived from input filename
- --ignore-tables
- Render HTML tables as blocks of text instead of actual tables. This is neccessary if the HTML contains very large or complex tables.
- --minimize-memory-usage
- Minimize memory usage at the cost of longer processing times. Use this option if you are on a memory constrained machine.
- --encoding=ENCODING
- Specify the character encoding of the source file. If the output LRF file contains strange characters, try changing this option. A common encoding for files from windows computers is cp-1252. Another common choice is utf-8. The default is to try and guess the encoding.
METADATA OPTIONS:
- -t TITLE, --title=TITLE
- Set the title. Default: filename.
- -a AUTHOR, --author=AUTHOR
- Set the author(s). Multiple authors should be set as a comma separated list. Default: Unknown
- --comment=FREETEXT
- Set the comment.
- --category=CATEGORY
- Set the category
- --title-sort=TITLE_SORT
- Sort key for the title
- --author-sort=AUTHOR_SORT
- Sort key for the author
- --publisher=PUBLISHER
- Publisher
- --cover=COVER
- Path to file containing image to be used as cover
- --use-metadata-cover
- If there is a cover graphic detected in the source file, use that instead of the specified cover.
LOOK AND FEEL:
- --base-font-size=BASE_FONT_SIZE
- Specify the base font size in pts. All fonts are rescaled accordingly. This option obsoletes the --font-delta option and takes precedence over it. To use --font-delta, set this to 0. Default: 10.0pt
- --enable-autorotation
- Enable autorotation of images that are wider than the screen width.
- --wordspace=WORDSPACE
- Set the space between words in pts. Default is 2.5
- --blank-after-para
- Separate paragraphs by blank lines.
- --header
- Add a header to all the pages with title and author.
- --headerformat=HEADERFORMAT
- Set the format of the header. %a is replaced by the author and %t by the title. Default is %t by %a
- --header-separation=HEADER_SEPARATION
- Add extra spacing below the header. Default is 0 px.
- --override-css=_OVERRIDE_CSS
- Override the CSS. Can be either a path to a CSS stylesheet or a string. If it is a string it is interpreted as CSS.
- --use-spine
- Use the <spine> element from the OPF file to determine the order in which the HTML files are appended to the LRF. The .opf file must be in the same directory as the base HTML file.
- --minimum-indent=MINIMUM_INDENT
- Minimum paragraph indent (the indent of the first line of a paragraph) in pts. Default: 0
- --font-delta=FONT_DELTA
- Increase the font size by 2 * FONT_DELTA pts and the line spacing by FONT_DELTA pts. FONT_DELTA can be a fraction.If FONT_DELTA is negative, the font size is decreased.
- --ignore-colors
- Render all content as black on white instead of the colors specified by the HTML or CSS.
PAGE OPTIONS:
- -p PROFILE, --profile=PROFILE
- Profile of the target device for which this LRF is being generated. The profile determines things like the resolution and screen size of the target device. Default: prs500 Supported profiles: prs500
- --left-margin=LEFT_MARGIN
- Left margin of page. Default is 20 px.
- --right-margin=RIGHT_MARGIN
- Right margin of page. Default is 20 px.
- --top-margin=TOP_MARGIN
- Top margin of page. Default is 10 px.
- --bottom-margin=BOTTOM_MARGIN
- Bottom margin of page. Default is 0 px.
- --render-tables-as-images
- Render tables in the HTML as images (useful if the document has large or complex tables)
- --text-size-multiplier-for-rendered-tables=TEXT_SIZE_MULTIPLIER_FOR_RENDERED_TABLES
- Multiply the size of text in rendered tables by this factor. Default is 1.0
LINK PROCESSING OPTIONS:
- --link-levels=LINK_LEVELS
- The maximum number of levels to recursively process links. A value of 0 means thats links are not followed. A negative value means that <a> tags are ignored.
- --link-exclude=LINK_EXCLUDE
- A regular expression. <a> tags whose href matches will be ignored. Defaults to @
- --no-links-in-toc
- Don't add links to the table of contents.
CHAPTER OPTIONS:
- --disable-chapter-detection
- Prevent the automatic detection chapters.
- --chapter-regex=CHAPTER_REGEX
- The regular expression used to detect chapter titles. It is searched for in heading tags (h1-h6). Defaults to chapter|book|appendix
- --chapter-attr=CHAPTER_ATTR
- Detect a chapter beginning at an element having the specified attribute. The format for this option is tagname regexp,attribute name,attribute value regexp. For example to match all heading tags that have the attribute class="chapter" you would use "h\d,class,chapter". You can set the attribute to "none" to match only on tag names. So for example, to match all h2 tags, you would use "h2,none,". Default is $,,$
- --page-break-before-tag=PAGE_BREAK
- If html2lrf does not find any page breaks in the html file and cannot detect chapter headings, it will automatically insert page-breaks before the tags whose names match this regular expression. Defaults to h[12]. You can disable it by setting the regexp to "$". The purpose of this option is to try to ensure that there are no really long pages as this degrades the page turn performance of the LRF. Thus this option is ignored if the current page has only a few elements.
- --force-page-break-before-tag=FORCE_PAGE_BREAK
- Force a page break before tags whose names match this regular expression.
- --force-page-break-before-attr=FORCE_PAGE_BREAK_ATTR
- Force a page break before an element having the specified attribute. The format for this option is tagname regexp,attribute name,attribute value regexp. For example to match all heading tags that have the attribute class="chapter" you would use "h\d,class,chapter". Default is $,,$
- --add-chapters-to-toc
- Add detected chapters to the table of contents.
PREPROCESSING OPTIONS:
- --baen
- Preprocess Baen HTML files to improve generated LRF.
- --pdftohtml
- You must add this option if processing files generated by pdftohtml, otherwise conversion will fail.
- --book-designer
- Use this option on html0 files from Book Designer.
FONT FAMILIES:
- Specify trutype font families for serif, sans-serif and monospace fonts. These fonts will be embedded in the LRF file. Note that custom fonts lead to slower page turns. For example: --serif-family "Times New Roman"
- --serif-family=SERIF_FAMILY
- The serif family of fonts to embed
- --sans-family=SANS_FAMILY
- The sans-serif family of fonts to embed
- --mono-family=MONO_FAMILY
- The monospace family of fonts to embed
DEBUG OPTIONS:
- --verbose
- Be verbose while processing
- --lrs
- Convert to LRS
Created by Kovid Goyal <kovid@kovidgoyal.net>
SEE ALSO
http://calibre.kovidgoyal.netContenus ©2006-2024 Benjamin Poulain
Design ©2006-2024 Maxime Vantorre