| WEASYPRINT(1) | WeasyPrint | WEASYPRINT(1) |
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/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.8+, 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
| March 15, 2024 | 61.2 |