RST2PDF(1)

NAME
rst2pdf - Convert reStructuredText documents to PDF

SYNOPSIS

rst2pdf [options] [input] [-o output]

DESCRIPTION

The usual way of creating PDF from reStructuredText (ReST) is by going through LaTeX. The rst2pdf utility provides an alternative by producing PDF directly using the ReportLab library.

OPTIONS

-h, --help
    Show this help message and exit

--config=FILE
    Config file to use. Default=~/.rst2pdf/config

-o FILE, --output=FILE
    Write the PDF to FILE

-s STYLESHEETS, --stylesheets=STYLESHEETS
    A comma-separated list of custom stylesheets. Default=""

--stylesheet-path=FOLDERLIST
    A colon-separated list of folders to search for stylesheets. Default=""

-c, --compressed
    Create a compressed PDF. Default=False

--print-stylesheet
    Print the default stylesheet and exit

--font-folder=FOLDER
    Search this folder for fonts. (Deprecated)

--font-path=FOLDERLIST
    A colon-separated list of folders to search for fonts. Default=""

--baseurl=URL
    The base URL for relative URLs.

-l LANG, --language=LANG
    Language to be used for hyphenation and docutils localization. Default=None

--header=HEADER
    Page header if not specified in the document.

--footer=FOOTER
    Page footer if not specified in the document.

--smart-quotes=VALUE
    Try to convert ASCII quotes, ellipsis and dashes to the typographically correct equivalent. Default=0

    The possible values are:

0.  Suppress all transformations. (Do nothing.)

1.  Performs default SmartyPants transformations: quotes (including backticks-style), em-dashes, and ellipses. "--" (dash dash) is used to signify an em-dash; there is no support for en-dashes.

2.  Same as --smart-quotes=1, except that it uses the old-school typewriter shorthand for dashes: "--" (dash dash) for en-dashes, "---" (dash dash dash) for em-dashes.

3.  Same as --smart-quotes=2, but inverts the shorthand for dashes: "--" (dash dash) for em-dashes, and "---" (dash dash dash) for en-dashes.

--fit-literal-mode=MODE
    What to do when a literal is too wide. One of error,overflow,shrink,truncate. Default="shrink"

-b LEVEL, --break-level=LEVEL
    Maximum section level that starts in a new page. Default: 0

--inline-links
    Shows target between parenthesis instead of active link

--repeat-table-rows
    Repeats header row for each splitted table

-q, --quiet
    Print less information.

-v, --verbose
    Print debug information.

--very-verbose
    Print even more debug information.

--version
    Print version number and exit.

--no-footnote-backlinks
    Disable footnote backlinks. Default: False

--inline-footnotes
    Show footnotes inline. Default: True

--default-dpi=NUMBER
    DPI for objects sized in pixels. Default=300

EXAMPLES

$ rst2pdf rest.txt -o out.pdf

Produce an out.pdf file which is a PDF version of the ReST document rest.txt.

AUTHOR
Chris Lamb <chris@chris-lamb.co.uk> for the Debian project