Man page - weasyprint(1)

Packages contains this manual

Package: weasyprint
apt-get install weasyprint

Manuals in package:

weasyprint(1)

Documentations in package:

weasyprint

Manual

WEASYPRINT

NAME
AUTHOR
COPYRIGHT

NAME

weasyprint - The Awesome Document Factory
weasyprint.__main__.main(argv=sys.argv)

The weasyprint program takes at least two arguments:

weasyprint [options] <input> <output>

	input		URL or filename of the HTML input, or - for stdin.
	output		Filename where output is written, or - for stdout.

-e <encoding>, --encoding <encoding>

Force the input character encoding.

-s <stylesheet>, --stylesheet <stylesheet>

URL or filename for a user CSS stylesheet.

This option can be passed multiple times.

-m <media-type>, --media-type <media-type>

Media type to use for @media, defaults to print.

-u <base-url>, --base-url <base-url>

Base for relative URLs in the HTML input, defaults to the input’s own filename or URL or the current directory for stdin.

-a <attachment>, --attachment <attachment>

URL or filename of a file to attach to the PDF document.

This option can be passed multiple times.

--pdf-identifier <pdf-identifier>

PDF file identifier.

--pdf-variant <pdf-variant>

PDF variant to generate.

Possible choices: pdf/a-1b, pdf/a-2b, pdf/a-3b, pdf/a-4b, pdf/a-2u, pdf/a-3u, pdf/a-4u, pdf/ua-1.

--pdf-version <pdf-version>

PDF version number.

--pdf-forms

Include PDF forms.

--uncompressed-pdf

Do not compress PDF content, mainly for debugging purpose.

--custom-metadata

Include custom HTML meta tags in PDF metadata.

-p, --presentational-hints

Follow HTML presentational hints.

--optimize-images

Optimize size of embedded images with no quality loss.

-j <jpeg-quality>, --jpeg-quality <jpeg-quality>

JPEG quality between 0 (worst) to 95 (best).

--full-fonts

Embed unmodified font files when possible.

--hinting

Keep hinting information in embedded fonts.

-c <cache-folder>, --cache-folder <cache-folder>

Store cache on disk instead of memory, folder is created if needed and cleaned after the PDF is generated.

-D <dpi>, --dpi <dpi>

Set maximum resolution of images embedded in the PDF.

-v, --verbose

Show warnings and information messages.

-d, --debug

Show debugging messages.

-q, --quiet

Hide logging messages.

--version

Print WeasyPrint’s version number and exit.

-i, --info

Print system information and exit.

-t <timeout>, --timeout <timeout>

Set timeout in seconds for HTTP requests.

-h, --help

Show this help message and exit.

The Awesome Document Factory

WeasyPrint is a smart solution helping web developers to create PDF documents. It turns simple HTML pages into gorgeous statistical reports, invoices, tickets…

From a technical point of view, WeasyPrint is a visual rendering engine for HTML and CSS that can export to PDF. It aims to support web standards for printing. WeasyPrint is free software made available under a BSD license.

It is based on various libraries but not on a full rendering engine like WebKit or Gecko. The CSS layout engine is written in Python, designed for pagination, and meant to be easy to hack on.

	•		Free software: BSD license
	•		For Python 3.9+, tested on CPython and PyPy
	•		Documentation: https://doc.courtbouillon.org/weasyprint
	•		Examples: https://weasyprint.org/#samples
	•		Changelog: https://github.com/Kozea/WeasyPrint/releases
	•		Code, issues, tests: https://github.com/Kozea/WeasyPrint
	•		Code of conduct: https://www.courtbouillon.org/code-of-conduct
	•		Professional support: https://www.courtbouillon.org
	•		Donation: https://opencollective.com/courtbouillon

WeasyPrint has been created and developed by Kozea ( https://kozea.fr/ ). Professional support, maintenance and community management is provided by CourtBouillon ( https://www.courtbouillon.org/ ).

Copyrights are retained by their contributors, no copyright assignment is required to contribute to WeasyPrint. Unless explicitly stated otherwise, any contribution intentionally submitted for inclusion is licensed under the BSD 3-clause license, without any additional terms or conditions. For full authorship information, see the version control history.

AUTHOR

Simon Sapin and contributors

COPYRIGHT

Simon Sapin and contributors