weasyprint - The Awesome Document Factory

       Simon Sapin and contributors

       Simon Sapin and contributors

62.3                                              Jun 27, 2024                                     WEASYPRINT(1)

       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.

       TheAwesomeDocumentFactory

       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.