|
Options affecting specific writers
--self-contained
- Produce a standalone HTML file with no external dependencies, using
data: URIs to incorporate the contents of linked scripts, stylesheets, images, and videos. The resulting file should be “self-contained,” in the sense that it needs no external files and no net access to be displayed properly by a browser. This option works only with HTML output formats, including html , html5 , html+lhs , html5+lhs , s5 , slidy , slideous , and dzslides . Scripts, images, and stylesheets at absolute URLs will be downloaded; those at relative URLs will be sought first relative to the working directory, then relative to the user data directory (see --data-dir ), and finally relative to pandoc’s default data directory.
--offline
- Deprecated synonym for
--self-contained .
-5 , --html5
- Produce HTML5 instead of HTML4. This option has no effect for writers other than
html . (Deprecated: Use the html5 output format instead.)
--ascii
- Use only ascii characters in output. Currently supported only for HTML output (which uses numerical entities instead of UTF-8 when this option is selected).
--reference-links
- Use reference-style links, rather than inline links, in writing markdown or reStructuredText. By default inline links are used.
--atx-headers
- Use ATX style headers in markdown output. The default is to use setext-style headers for levels 1-2, and then ATX headers.
--chapters
- Treat top-level headers as chapters in LaTeX, ConTeXt, and DocBook output. When the LaTeX template uses the report, book, or memoir class, this option is implied. If
--beamer is used, top-level headers will become \part{..} .
-N , --number-sections
- Number section headings in LaTeX, ConTeXt, or HTML output. By default, sections are not numbered.
--no-tex-ligatures
- Do not convert quotation marks, apostrophes, and dashes to the TeX ligatures when writing LaTeX or ConTeXt. Instead, just use literal unicode characters. This is needed for using advanced OpenType features with XeLaTeX and LuaLaTeX. Note: normally
--smart is selected automatically for LaTeX and ConTeXt output, but it must be specified explicitly if --no-tex-ligatures is selected. If you use literal curly quotes, dashes, and ellipses in your source, then you may want to use --no-tex-ligatures without --smart .
--listings
- Use listings package for LaTeX code blocks
-i , --incremental
- Make list items in slide shows display incrementally (one by one). The default is for lists to be displayed all at once.
--slide-level =NUMBER
- Specifies that headers with the specified level create slides (for
beamer , s5 , slidy , slideous , dzslides ). Headers above this level in the hierarchy are used to divide the slide show into sections; headers below this level create subheads within a slide. The default is to set the slide level based on the contents of the document; see Structuring the slide show, below.
--section-divs
- Wrap sections in
<div> tags (or <section> tags in HTML5), and attach identifiers to the enclosing <div> (or <section> ) rather than the header itself. See Section identifiers, below.
--email-obfuscation= none|javascript|references
- Specify a method for obfuscating
mailto: links in HTML documents. none leaves mailto: links as they are. javascript obfuscates them using javascript. references obfuscates them by printing their letters as decimal or hexadecimal character references. If --strict is specified, references is used regardless of the presence of this option.
--id-prefix =STRING
- Specify a prefix to be added to all automatically generated identifiers in HTML output. This is useful for preventing duplicate identifiers when generating fragments to be included in other pages.
-T STRING, --title-prefix= STRING
- Specify STRING as a prefix at the beginning of the title that appears in the HTML header (but not in the title as it appears at the beginning of the HTML body). Implies
--standalone .
-c URL, --css= URL
- Link to a CSS style sheet.
--reference-odt= FILE
- Use the specified file as a style reference in producing an ODT. For best results, the reference ODT should be a modified version of an ODT produced using pandoc. The contents of the reference ODT are ignored, but its stylesheets are used in the new ODT. If no reference ODT is specified on the command line, pandoc will look for a file
reference.odt in the user data directory (see --data-dir ). If this is not found either, sensible defaults will be used.
--reference-docx= FILE
- Use the specified file as a style reference in producing a docx file. For best results, the reference docx should be a modified version of a docx file produced using pandoc. The contents of the reference docx are ignored, but its stylesheets are used in the new docx. If no reference docx is specified on the command line, pandoc will look for a file
reference.docx in the user data directory (see --data-dir ). If this is not found either, sensible defaults will be used.
--epub-stylesheet= FILE
- Use the specified CSS file to style the EPUB. If no stylesheet is specified, pandoc will look for a file
epub.css in the user data directory (see --data-dir ). If it is not found there, sensible defaults will be used.
--epub-cover-image= FILE
- Use the specified image as the EPUB cover. It is recommended that the image be less than 1000px in width and height.
--epub-metadata= FILE
Look in the specified XML file for metadata for the EPUB. The file should contain a series of Dublin Core elements, as documented at http://dublincore.org/documents/dces/. For example:
<dc:rights>Creative Commons</dc:rights>
<dc:language>es-AR</dc:language>
By default, pandoc will include the following metadata elements: <dc:title> (from the document title), <dc:creator> (from the document authors), <dc:date> (from the document date, which should be in ISO 8601 format), <dc:language> (from the lang variable, or, if is not set, the locale), and <dc:identifier id="BookId"> (a randomly generated UUID). Any of these may be overridden by elements in the metadata file.
--epub-embed-font= FILE
Embed the specified font in the EPUB. This option can be repeated to embed multiple fonts. To use embedded fonts, you will need to add declarations like the following to your CSS (see --epub-stylesheet ):
@font-face {
font-family: DejaVuSans;
font-style: normal;
font-weight: normal;
src:url("DejaVuSans-Regular.ttf");
}
@font-face {
font-family: DejaVuSans;
font-style: normal;
font-weight: bold;
src:url("DejaVuSans-Bold.ttf");
}
@font-face {
font-family: DejaVuSans;
font-style: italic;
font-weight: normal;
src:url("DejaVuSans-Oblique.ttf");
}
@font-face {
font-family: DejaVuSans;
font-style: italic;
font-weight: bold;
src:url("DejaVuSans-BoldOblique.ttf");
}
body { font-family: "DejaVuSans"; }
--latex-engine= pdflatex|lualatex|xelatex
- Use the specified LaTeX engine when producing PDF output. The default is
pdflatex . If the engine is not in your PATH, the full path of the engine may be specified here.
|