[ { "path": ".github/FUNDING.yml", "content": "# These are supported funding model platforms\n\nopen_collective: courtbouillon\n" }, { "path": ".github/workflows/doconfly.yml", "content": "name: doconfly\non:\n push:\n branches:\n - main\n tags:\n - \"*\"\n\njobs:\n doconfly:\n name: doconfly job\n runs-on: ubuntu-latest\n env:\n PORT: ${{ secrets.PORT }}\n SSH_PRIVATE_KEY: ${{ secrets.SSH_PRIVATE_KEY }}\n TAKOYAKI: ${{ secrets.TAKOYAKI }}\n USER: ${{ secrets.USER }}\n DOCUMENTATION_PATH: ${{ secrets.DOCUMENTATION_PATH }}\n DOCUMENTATION_URL: ${{ secrets.DOCUMENTATION_URL }}\n steps:\n - run: |\n which ssh-agent || ( apt-get update -y && apt-get install openssh-client -y )\n eval $(ssh-agent -s)\n echo \"$SSH_PRIVATE_KEY\" | tr -d '\\r' | ssh-add -\n mkdir -p ~/.ssh\n chmod 700 ~/.ssh\n ssh-keyscan -p $PORT $TAKOYAKI >> ~/.ssh/known_hosts\n chmod 644 ~/.ssh/known_hosts\n ssh $USER@$TAKOYAKI -p $PORT \"doconfly/doconfly.sh $GITHUB_REPOSITORY $GITHUB_REF $DOCUMENTATION_PATH $DOCUMENTATION_URL\"\n" }, { "path": ".github/workflows/exe.yml", "content": "name: WeasyPrint’s exe generation\non: [push]\n\njobs:\n generate:\n name: ${{ matrix.os }}\n runs-on: 'windows-latest'\n steps:\n - uses: actions/checkout@v4\n - uses: actions/setup-python@v5\n with:\n python-version: '3.13'\n - name: Use absolute imports and install Pango (Windows)\n run: |\n C:\\msys64\\usr\\bin\\bash -lc 'pacman -S mingw-w64-x86_64-pango mingw-w64-x86_64-sed --noconfirm'\n C:\\msys64\\mingw64\\bin\\sed -i 's/^from \\. /from weasyprint /' weasyprint/__main__.py\n C:\\msys64\\mingw64\\bin\\sed -i 's/^from \\./from weasyprint\\./' weasyprint/__main__.py\n echo \"C:\\msys64\\mingw64\\bin\" | Out-File -FilePath $env:GITHUB_PATH\n rm C:\\msys64\\mingw64\\bin\\python.exe\n - name: Install requirements\n run: python -m pip install . pyinstaller\n - name: Generate executable\n run: python -m PyInstaller weasyprint/__main__.py -n weasyprint -F\n - name: Test executable\n run: dist/weasyprint --info\n - name: Store executable\n uses: actions/upload-artifact@v4\n with:\n name: weasyprint-windows\n path: |\n dist/weasyprint\n dist/weasyprint.exe\n README.rst\n LICENSE\n" }, { "path": ".github/workflows/release.yml", "content": "name: Release new version\non:\n push:\n tags:\n - v*\n\njobs:\n pypi-publish:\n name: Upload release to PyPI\n runs-on: ubuntu-latest\n environment:\n name: pypi\n url: https://pypi.org/p/weasyprint\n permissions:\n id-token: write\n steps:\n - uses: actions/checkout@v4\n - uses: actions/setup-python@v5\n - name: Install requirements\n run: python -m pip install flit\n - name: Build packages\n run: flit build\n - name: Publish package distributions to PyPI\n uses: pypa/gh-action-pypi-publish@release/v1\n add-version:\n name: Add version to GitHub\n runs-on: ubuntu-latest\n permissions:\n contents: write\n steps:\n - name: Checkout code\n uses: actions/checkout@v4\n - name: Install requirements\n run: sudo apt-get install pandoc\n - name: Generate content\n run: |\n pandoc docs/changelog.rst -f rst -t gfm | csplit - /##/ \"{1}\" -f .part\n sed -r \"s/^([A-Z].*)\\:\\$/## \\1/\" .part01 | sed -r \"s/^ *//\" | sed -rz \"s/([^\\n])\\n([^\\n^-])/\\1 \\2/g\" | tail -n +5 > .body\n - name: Create Release\n uses: softprops/action-gh-release@v2\n with:\n body_path: .body\n" }, { "path": ".github/workflows/test_pdfa.yml", "content": "name: WeasyPrint's PDF/A tests\non: [push, pull_request]\n\nenv:\n PDF_FOLDER: 'pdfs'\n VERA_FOLDER: 'vera'\n\njobs:\n pdf-ua:\n name: Test PDF/A samples\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v4\n - name: Install requirements\n run: python -m pip install .\n - name: Create output folders\n run: |\n mkdir ${{env.PDF_FOLDER}}\n mkdir ${{env.VERA_FOLDER}}\n - name: Clone samples repository\n run: git clone https://github.com/CourtBouillon/weasyprint-samples.git\n - name: Generate samples\n run: |\n python -m weasyprint --pdf-variant pdf/a-1a weasyprint-samples/book/book.html -s weasyprint-samples/book/book-classical.css ${{env.PDF_FOLDER}}/book-classical.pdf\n python -m weasyprint --pdf-variant pdf/a-2u weasyprint-samples/book/book.html -s weasyprint-samples/book/book.css -s <(echo '* { image-rendering: crisp-edges }') ${{env.PDF_FOLDER}}/book-fancy.pdf\n python -m weasyprint --pdf-variant pdf/a-2b weasyprint-samples/letter/letter.html -s <(echo '* { image-rendering: crisp-edges }') ${{env.PDF_FOLDER}}/letter.pdf\n python -m weasyprint --pdf-variant pdf/a-3a -s <(echo '* { image-rendering: crisp-edges }') weasyprint-samples/report/report.html ${{env.PDF_FOLDER}}/report.pdf\n - name: Install VeraPDF\n run: |\n wget https://software.verapdf.org/releases/verapdf-installer.zip\n unzip verapdf-installer.zip\n java -DINSTALL_PATH=/tmp -jar verapdf-greenfield-*/verapdf-izpack-installer-*.jar -options-system\n - name: Generate VeraPDF reports\n run: |\n /tmp/verapdf -f 1a --format html ${{env.PDF_FOLDER}}/book-classical.pdf > ${{env.VERA_FOLDER}}/book-classical-verapdf.html\n /tmp/verapdf -f 2u --format html ${{env.PDF_FOLDER}}/book-fancy.pdf > ${{env.VERA_FOLDER}}/book-fancy-verapdf.html\n /tmp/verapdf -f 2b --format html ${{env.PDF_FOLDER}}/letter.pdf > ${{env.VERA_FOLDER}}/letter-verapdf.html\n /tmp/verapdf -f 3a --format html ${{env.PDF_FOLDER}}/report.pdf > ${{env.VERA_FOLDER}}/report-verapdf.html\n /tmp/verapdf --format html ${{env.PDF_FOLDER}}/ > ${{env.VERA_FOLDER}}/summary.html\n - name: Archive generated PDFs\n if: ${{ always() }}\n uses: actions/upload-artifact@v4\n with:\n name: vera-results\n path: |\n ${{env.VERA_FOLDER}}\n ${{env.PDF_FOLDER}}\n retention-days: 1\n" }, { "path": ".github/workflows/test_pdfua.yml", "content": "name: WeasyPrint's PDF/UA tests\non: [push, pull_request]\n\nenv:\n PDF_FOLDER: 'pdfs'\n VERA_FOLDER: 'vera'\n\njobs:\n pdf-ua:\n name: Test PDF/UA samples\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v4\n - name: Install requirements\n run: python -m pip install .\n - name: Create output folders\n run: |\n mkdir ${{env.PDF_FOLDER}}\n mkdir ${{env.VERA_FOLDER}}\n - name: Clone samples repository\n run: git clone https://github.com/CourtBouillon/weasyprint-samples.git\n - name: Generate samples\n run: |\n python -m weasyprint --pdf-variant pdf/ua-1 weasyprint-samples/book/book.html -s weasyprint-samples/book/book-classical.css ${{env.PDF_FOLDER}}/book-classical.pdf\n python -m weasyprint --pdf-variant pdf/ua-1 weasyprint-samples/book/book.html -s weasyprint-samples/book/book.css ${{env.PDF_FOLDER}}/book-fancy.pdf\n python -m weasyprint --pdf-variant pdf/ua-1 weasyprint-samples/letter/letter.html ${{env.PDF_FOLDER}}/letter.pdf\n python -m weasyprint --pdf-variant pdf/ua-1 weasyprint-samples/report/report.html ${{env.PDF_FOLDER}}/report.pdf\n - name: Install VeraPDF\n run: |\n wget https://software.verapdf.org/releases/verapdf-installer.zip\n unzip verapdf-installer.zip\n java -DINSTALL_PATH=/tmp -jar verapdf-greenfield-*/verapdf-izpack-installer-*.jar -options-system\n - name: Generate VeraPDF reports\n run: |\n /tmp/verapdf -f ua1 --format html ${{env.PDF_FOLDER}}/book-classical.pdf > ${{env.VERA_FOLDER}}/book-classical-verapdf.html\n /tmp/verapdf -f ua1 --format html ${{env.PDF_FOLDER}}/book-fancy.pdf > ${{env.VERA_FOLDER}}/book-fancy-verapdf.html\n /tmp/verapdf -f ua1 --format html ${{env.PDF_FOLDER}}/letter.pdf > ${{env.VERA_FOLDER}}/letter-verapdf.html\n /tmp/verapdf -f ua1 --format html ${{env.PDF_FOLDER}}/report.pdf > ${{env.VERA_FOLDER}}/report-verapdf.html\n /tmp/verapdf -f ua1 --format html ${{env.PDF_FOLDER}}/ > ${{env.VERA_FOLDER}}/summary.html\n - name: Archive generated PDFs\n if: ${{ always() }}\n uses: actions/upload-artifact@v4\n with:\n name: vera-results\n path: |\n ${{env.VERA_FOLDER}}\n ${{env.PDF_FOLDER}}\n retention-days: 1\n" }, { "path": ".github/workflows/test_samples.yml", "content": "name: WeasyPrint's samples tests\non: [push, pull_request]\n\nenv:\n REPORTS_FOLDER: 'report'\n\njobs:\n samples:\n name: Generate samples\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v4\n - uses: actions/setup-python@v5\n with:\n python-version: ${{ matrix.python-version }}\n - name: Upgrade pip and setuptools\n run: python -m pip install --upgrade pip setuptools\n - name: Install requirements\n run: python -m pip install .\n - name: Clone samples repository\n run: git clone https://github.com/CourtBouillon/weasyprint-samples.git\n - name: Create output folder\n run: mkdir ${{env.REPORTS_FOLDER}}\n - name: Book classical\n run: python -m weasyprint weasyprint-samples/book/book.html -s weasyprint-samples/book/book-classical.css ${{env.REPORTS_FOLDER}}/book-classical.pdf\n - name: Book fancy\n run: python -m weasyprint weasyprint-samples/book/book.html -s weasyprint-samples/book/book.css ${{env.REPORTS_FOLDER}}/book-fancy.pdf\n - name: Invoice\n run: python -m weasyprint weasyprint-samples/invoice/invoice.html ${{env.REPORTS_FOLDER}}/invoice.pdf\n - name: Letter\n run: python -m weasyprint weasyprint-samples/letter/letter.html ${{env.REPORTS_FOLDER}}/letter.pdf\n - name: Poster\n run: python -m weasyprint weasyprint-samples/poster/poster.html -s weasyprint-samples/poster/poster.css ${{env.REPORTS_FOLDER}}/poster.pdf\n - name: Flyer\n run: python -m weasyprint weasyprint-samples/poster/poster.html -s weasyprint-samples/poster/flyer.css ${{env.REPORTS_FOLDER}}/flyer.pdf\n - name: Report\n run: python -m weasyprint weasyprint-samples/report/report.html ${{env.REPORTS_FOLDER}}/report.pdf\n - name: Ticket\n run: python -m weasyprint weasyprint-samples/ticket/ticket.html ${{env.REPORTS_FOLDER}}/ticket.pdf\n - name: Archive generated PDFs\n uses: actions/upload-artifact@v4\n with:\n name: generated-documents\n path: ${{env.REPORTS_FOLDER}}\n retention-days: 1\n" }, { "path": ".github/workflows/tests.yml", "content": "name: WeasyPrint's tests\non: [push, pull_request]\n\njobs:\n tests:\n name: ${{ matrix.os }} - ${{ matrix.python-version }}\n runs-on: ${{ matrix.os }}\n strategy:\n matrix:\n os: [ubuntu-latest, macos-latest, windows-latest]\n python-version: ['3.14']\n include:\n - os: ubuntu-latest\n python-version: '3.10'\n - os: ubuntu-latest\n python-version: 'pypy-3.11'\n steps:\n - uses: actions/checkout@v4\n - uses: actions/setup-python@v5\n with:\n python-version: ${{ matrix.python-version }}\n - name: Install Ghostscript (Ubuntu)\n if: matrix.os == 'ubuntu-latest'\n run: sudo apt-get update -y && sudo apt-get install ghostscript -y\n - name: Install DejaVu, Pango and Ghostscript (MacOS)\n if: matrix.os == 'macos-latest'\n run: |\n brew update\n brew install --cask font-dejavu\n brew install pango ghostscript\n - name: Install DejaVu, Pango and Ghostscript (Windows)\n if: matrix.os == 'windows-latest'\n run: |\n C:\\msys64\\usr\\bin\\bash -lc 'pacman -S mingw-w64-x86_64-ttf-dejavu mingw-w64-x86_64-pango mingw-w64-x86_64-ghostscript --noconfirm'\n xcopy \"C:\\msys64\\mingw64\\share\\fonts\\TTF\" \"C:\\Users\\runneradmin\\.fonts\" /e /i\n echo \"C:\\msys64\\mingw64\\bin\" | Out-File -FilePath $env:GITHUB_PATH\n rm C:\\msys64\\mingw64\\bin\\python.exe\n - name: Upgrade pip and setuptools\n run: python -m pip install --upgrade pip setuptools\n - name: Install tests’ requirements\n run: python -m pip install .[test] pytest-xdist\n - name: Launch tests\n run: python -m pytest -n auto\n env:\n DYLD_FALLBACK_LIBRARY_PATH: /opt/homebrew/lib\n - name: Check coding style\n run: python -m ruff check\n" }, { "path": ".gitignore", "content": "*.pyc\n.cache\n/.coverage\n/build\n/dist\n/docs/_build\n/pytest_cache\n/tests/draw/results\n/venv\n" }, { "path": "LICENSE", "content": "BSD 3-Clause License\n\nCopyright (c) 2011-2021, Simon Sapin and contributors.\nAll rights reserved.\n\nRedistribution and use in source and binary forms, with or without\nmodification, are permitted provided that the following conditions are met:\n\n* Redistributions of source code must retain the above copyright notice, this\n list of conditions and the following disclaimer.\n\n* Redistributions in binary form must reproduce the above copyright notice,\n this list of conditions and the following disclaimer in the documentation\n and/or other materials provided with the distribution.\n\n* Neither the name of the copyright holder nor the names of its\n contributors may be used to endorse or promote products derived from\n this software without specific prior written permission.\n\nTHIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS \"AS IS\"\nAND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE\nIMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE\nDISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE\nFOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL\nDAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR\nSERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER\nCAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,\nOR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE\nOF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n" }, { "path": "README.rst", "content": "**The Awesome Document Factory**\n\nWeasyPrint is a smart solution helping web developers to create PDF\ndocuments. It turns simple HTML pages into gorgeous statistical reports,\ninvoices, tickets…\n\nFrom a technical point of view, WeasyPrint is a visual rendering engine for\nHTML and CSS that can export to PDF. It aims to support web standards for\nprinting. WeasyPrint is free software made available under a BSD license.\n\nIt is based on various libraries but *not* on a full rendering engine like\nWebKit or Gecko. The CSS layout engine is written in Python, designed for\npagination, and meant to be easy to hack on.\n\n* Free software: BSD license\n* For Python 3.10+, tested on CPython and PyPy\n* Documentation: https://doc.courtbouillon.org/weasyprint\n* Examples: https://weasyprint.org/#samples\n* Changelog: https://github.com/Kozea/WeasyPrint/releases\n* Code, issues, tests: https://github.com/Kozea/WeasyPrint\n* Code of conduct: https://www.courtbouillon.org/code-of-conduct\n* Professional support: https://www.courtbouillon.org\n* Donation: https://opencollective.com/courtbouillon\n\nWeasyPrint has been created and developed by Kozea (https://kozea.fr/).\nProfessional support, maintenance and community management is provided by\nCourtBouillon (https://www.courtbouillon.org/).\n\nCopyrights are retained by their contributors, no copyright assignment is\nrequired to contribute to WeasyPrint. Unless explicitly stated otherwise, any\ncontribution intentionally submitted for inclusion is licensed under the BSD\n3-clause license, without any additional terms or conditions. For full\nauthorship information, see the version control history.\n" }, { "path": "docs/api_reference.rst", "content": "API Reference\n=============\n\n.. currentmodule:: weasyprint\n\n\nThis page is for WeasyPrint |version|. See :doc:`changelog ` for\nolder versions.\n\n\nAPI Stability\n-------------\n\nEverything described here is considered “public”: this is what you can rely\non. We will try to maintain backward-compatibility, and we really often do, but\nthere is no hard promise.\n\nAnything else should not be used outside of WeasyPrint itself. We reserve\nthe right to change it or remove it at any point. Use it at your own risk,\nor have dependency to a specific WeasyPrint version.\n\n\nVersioning\n----------\n\nWeasyPrint provides frequent major releases, and minor releases with only bug\nfixes. Versioning is close to what many browsers do, including Firefox and\nChrome: big major numbers, small minor numbers.\n\nEven if each version does not break the API, each version does break the way\ndocuments are rendered, which is what really matters at the end. Providing\nminor versions would give the illusion that developers can just update\nWeasyPrint without checking that everything works.\n\nUnfortunately, we have the same problem as the other browsers: when a new\nversion is released, most of the user's websites are rendered exactly the same,\nbut a small part is not. And the only ways to know that, for web developers,\nare to read the changelog and to check that their pages are correctly rendered.\n\nMore about this choice can be found in\nissue `#900`_.\n\n.. _#900: https://github.com/Kozea/WeasyPrint/issues/900\n\n\nCommand-line API\n----------------\n\n.. autofunction:: weasyprint.__main__.main(argv=sys.argv)\n\n\nPython API\n----------\n\n.. autoclass:: HTML(input, **kwargs)\n :members:\n.. autoclass:: CSS(input, **kwargs)\n.. autoclass:: Attachment(input, **kwargs)\n.. autodata:: DEFAULT_OPTIONS\n\n.. module:: weasyprint.document\n.. autoclass:: Document\n :members:\n.. autoclass:: DocumentMetadata()\n :members:\n.. autoclass:: Page()\n :members:\n :exclude-members: paint\n\n.. module:: weasyprint.urls\n.. autoclass:: URLFetcher\n :members:\n :member-order: bysource\n.. autoclass:: URLFetcherResponse\n.. autoclass:: FatalURLFetchingError\n\n.. module:: weasyprint.text.fonts\n.. autoclass:: FontConfiguration()\n\n.. module:: weasyprint.css.counters\n.. autoclass:: CounterStyle()\n\n\nSupported Features\n------------------\n\n\nURLs\n~~~~\n\nWeasyPrint can read normal files, HTTP, FTP and `data URIs`_. It will follow\nHTTP redirects but more advanced features like cookies and authentication\nare currently not supported, although a custom :ref:`URL fetcher\n` can help.\n\n.. _data URIs: https://en.wikipedia.org/wiki/Data_URI_scheme\n\n\nHTML\n~~~~\n\nSupported HTML Tags\n+++++++++++++++++++\n\nMany HTML elements are implemented in CSS through the HTML5\n`User-Agent stylesheet`_.\n\nSome elements need special treatment:\n\n* The ```` element, if present, determines the base for relative URLs.\n* CSS stylesheets can be embedded in ``\n …\n\nAutomatic hyphenation can be disabled again with the ``manual`` value:\n\n.. code-block:: css\n\n html { hyphens: auto }\n a[href]::after { content: ' [' attr(href) ']'; hyphens: manual }\n\nThe other features provided by `CSS Text Module Level 3`_ are **not**\nsupported:\n\n- the ``line-break`` property;\n- the ``match-parent`` value of the ``text-align`` property;\n- the ``text-indent`` and ``hanging-punctuation`` properties.\n\nThe other features provided by `CSS Text Module Level 4`_ are **not**\nsupported:\n\n- the ``text-space-collapse`` and ``text-space-trim`` properties;\n- the ``text-wrap``, ``wrap-before``, ``wrap-after`` and ``wrap-inside``\n properties;\n- the ``text-align`` property with an alignment character;\n- the ``pre-wrap-auto`` value of the ``white-space`` property; and\n- the ``text-spacing`` property.\n\n.. _#1153: https://github.com/Kozea/WeasyPrint/issues/1153\n.. _supported by Pyphen: https://github.com/Kozea/Pyphen/tree/main/pyphen/dictionaries\n.. _hyphenation: https://www.w3.org/TR/css-text-3/#hyphenation\n.. _CSS Text Module Level 3: https://www.w3.org/TR/css-text-3/\n.. _CSS Text Module Level 4: https://www.w3.org/TR/css-text-4/\n\nCSS Fonts Module Level 3 / 4\n++++++++++++++++++++++++++++\n\nThe `CSS Fonts Module Level 3`_ is a candidate recommendation describing \"how\nfont properties are specified and how font resources are loaded dynamically\".\n\nWeasyPrint supports the ``font-size``, ``font-stretch``, ``font-style`` and\n``font-weight`` properties, coming from CSS 2.1.\n\nWeasyPrint also supports the following font features added in Level 3:\n- ``font-kerning``,\n- ``font-variant-ligatures``,\n- ``font-variant-position``,\n- ``font-variant-caps``,\n- ``font-variant-numeric``,\n- ``font-variant-east-asian``,\n- ``font-feature-settings``, and\n- ``font-language-override``.\n\n``font-family`` is supported. The string is given to Pango that tries to find a\nmatching font in a way different from what is defined in the recommendation,\nbut that should not be a problem for common use.\n\nThe shorthand ``font`` and ``font-variant`` properties are supported.\n\nWeasyPrint supports the ``@font-face`` rule.\n\nWeasyPrint does **not** support the ``@font-feature-values`` rule and the\nvalues of ``font-variant-alternates`` other than ``normal`` and\n``historical-forms``.\n\nFrom `CSS Fonts Module Level 4`_ we only support the\n``font-variation-settings`` property enabling specific font variations.\n\n.. _CSS Fonts Module Level 3: https://www.w3.org/TR/css-fonts-3/\n.. _CSS Fonts Module Level 4: https://www.w3.org/TR/css-fonts-4/\n\n\nCSS Paged Media Module Level 3\n++++++++++++++++++++++++++++++\n\nThe `CSS Paged Media Module Level 3`_ is a working draft including features for\npaged media \"describing how:\n\n- page breaks are created and avoided;\n- the page properties such as size, orientation, margins, border, and padding\n are specified;\n- headers and footers are established within the page margins;\n- content such as page counters are placed in the headers and footers; and\n- orphans and widows can be controlled.\"\n\nAll the features of this draft are available, including:\n\n- the ``@page`` rule and the ``:left``, ``:right``, ``:first`` and ``:blank``\n selectors;\n- the page margin boxes;\n- the page-based counters (with known limitations `#93`_);\n- the page ``size``, ``bleed`` and ``marks`` properties;\n- the named pages.\n\n.. _CSS Paged Media Module Level 3: https://drafts.csswg.org/css-page-3/\n.. _#93: https://github.com/Kozea/WeasyPrint/issues/93\n\nCSS Generated Content for Paged Media Module\n++++++++++++++++++++++++++++++++++++++++++++\n\nThe `CSS Generated Content for Paged Media Module`_ (GCPM) is a working draft\ndefining \"new properties and values, so that authors may bring new techniques\n(running headers and footers, footnotes, page selection) to paged media\".\n\n`Page selectors`_ are supported by WeasyPrint. You can select pages according\nto their position in the document:\n\n.. code-block:: css\n\n @page :nth(3) { background: red } /* Third page */\n @page :nth(2n+1) { background: green } /* Odd pages */\n @page :nth(1 of chapter) { background: blue } /* First pages of chapters */\n\nYou can also use `running elements`_ to put HTML boxes into the page margins\n(but the ``start`` parameter of ``element()`` is not supported).\n\nFootnotes_ are supported. You can put a box in the footnote area using the\n``float: footnote`` property. Footnote markers and footnote calls can be\ndefined using the ``::footnote-marker`` and ``::footnote-call``\npseudo-elements. You can also change the way footnotes are displayed using the\n``footnote-display`` property (``compact`` is not supported), and influence\nover the rendering of difficult pages with ``footnote-policy``.\n\n.. _CSS Generated Content for Paged Media Module: https://www.w3.org/TR/css-gcpm-3/\n.. _Page selectors: https://www.w3.org/TR/css-gcpm-3/#document-page-selectors\n.. _running elements: https://www.w3.org/TR/css-gcpm-3/#running-elements\n.. _Footnotes: https://www.w3.org/TR/css-gcpm-3/#footnotes\n\nCSS Generated Content Module Level 3\n++++++++++++++++++++++++++++++++++++\n\nThe `CSS Generated Content Module Level 3`_ is a working draft helping \"authors\n[who] sometimes want user agents to render content that does not come from the\ndocument tree. One familiar example of this is numbered headings\n[…]. Similarly, authors may want the user agent to insert the word \"Figure\"\nbefore the caption of a figure […], or replacing elements with images or other\nmultimedia content.\"\n\n`Named strings`_ are supported by WeasyPrint. You can define strings related to\nthe first or last element of a type present on a page, and display these\nstrings in page borders. This feature is really useful to add the title of the\ncurrent chapter at the top of the pages of a book for example.\n\nThe named strings can embed static strings, counters, cross-references, tag\ncontents and tag attributes.\n\n.. code-block:: css\n\n @top-center { content: string(chapter) }\n h2 { string-set: chapter \"Current chapter: \" content() }\n\n`Cross-references`_ retrieve counter or content values from targets (anchors or\nidentifiers) in the current document:\n\n.. code-block:: css\n\n a::after { content: \", on page \" target-counter(attr(href), page) }\n a::after { content: \", see \" target-text(attr(href)) }\n\nIn particular, ``target-counter()`` and ``target-text()`` are useful when it\ncomes to tables of contents (see `an example`_).\n\nYou can also control `PDF bookmarks`_ with WeasyPrint. Using the\n``bookmark-level``, ``bookmark-label`` and ``bookmark-state`` properties, you\ncan add bookmarks that will be available in your PDF reader.\n\nBookmarks have already been added in the WeasyPrint's `user agent stylesheet`_,\nso your generated documents will automatically have bookmarks on headers (from\n``

`` to ``

``). But for example, if you have only one top-level ``

``\nand do not wish to include it in the bookmarks, add this in your stylesheet:\n\n.. code-block:: css\n\n h1 { bookmark-level: none }\n\n`Leaders`_ are also supported:\n\n.. code-block:: css\n\n li a::after {\n content: ' ' leader(dotted) ' ' target-counter(attr(href), page);\n }\n\nThe other features of this module are **not** implemented:\n\n- quotes (``content: *-quote``);\n\n.. _CSS Generated Content Module Level 3: https://www.w3.org/TR/css-content-3/\n.. _Quotes: https://www.w3.org/TR/css-content-3/#quotes\n.. _Named strings: https://www.w3.org/TR/css-content-3/#named-strings\n.. _Cross-references: https://www.w3.org/TR/css-content-3/#cross-references\n.. _an example: https://github.com/Kozea/WeasyPrint/pull/652#issuecomment-403276559\n.. _PDF bookmarks: https://www.w3.org/TR/css-content-3/#bookmark-generation\n.. _user agent stylesheet: https://github.com/Kozea/WeasyPrint/blob/main/weasyprint/css/html5_ua.css\n.. _Leaders: https://www.w3.org/TR/css-content-3/#leaders\n\nCSS Color Module Level 4 / 5\n++++++++++++++++++++++++++++\n\nThe `CSS Color Module Level 4`_ is a recommendation defining \"CSS properties which allow\nauthors to specify the foreground color and opacity of the text content of an element\".\nIts main goal is to specify how colors are defined, including color keywords and many\ncolor notations including ``#rgba``, ``rgb()``, ``hsl()``, ``hwb()``, ``lab()``, etc.\nThe standard ``color()`` function gives a common way to define colors giving their color\nspace. Opacity and alpha compositing are also defined in this document.\n\nThis recommendation is fully implemented in WeasyPrint, except the deprecated\nSystem Colors.\n\nThe `CSS Color Module Level 5`_ is a working draft adding \"color modification functions,\ncustom color spaces (ICC profiles), ``contrast-color()``, ``light-dark()`` and\n``device-cmyk()``\" to level 4.\n\nWeasyPrint supports the ``light-dark()`` and ``device-cmyk()`` properties, and the\n``@color-profile`` at-rule.\n\nWeasyPrint does **not** support the ``color-mix()`` and ``contrast-color()`` properties.\n\n.. _CSS Color Module Level 4: https://www.w3.org/TR/css-color-4/\n.. _CSS Color Module Level 5: https://www.w3.org/TR/css-color-5/\n\nCSS Transforms Module Level 1\n+++++++++++++++++++++++++++++\n\nThe `CSS Transforms Module Level 1`_ working draft \"describes a coordinate\nsystem within each element is positioned. This coordinate space can be modified\nwith the transform property. Using transform, elements can be translated,\nrotated and scaled in two or three dimensional space.\"\n\nWeasyPrint supports the ``transform`` and ``transform-origin`` properties, and\nall the 2D transformations (``matrix``, ``rotate``, ``translate``,\n``translateX``, ``translateY``, ``scale``, ``scaleX``, ``scaleY``, ``skew``,\n``skewX``, ``skewY``).\n\nWeasyPrint does **not** support the ``transform-style``, ``perspective``,\n``perspective-origin`` and ``backface-visibility`` properties, and all the 3D\ntransformations (``matrix3d``, ``rotate3d``, ``rotateX``, ``rotateY``,\n``rotateZ``, ``translate3d``, ``translateZ``, ``scale3d``, ``scaleZ``).\n\n.. _CSS Transforms Module Level 1: https://drafts.csswg.org/css-transforms-1/\n\nCSS Backgrounds and Borders Module Level 3\n++++++++++++++++++++++++++++++++++++++++++\n\nThe `CSS Backgrounds and Borders Module Level 3`_ is a candidate recommendation\ndefining properties dealing \"with the decoration of the border area and with\nthe background of the content, padding and border areas\".\n\nThe `border part`_ of this module is supported, as it is already included in\nthe the CSS 2.1 specification.\n\nWeasyPrint supports the `background part`_ of this module (allowing multiple\nbackground layers per box), including the ``background``, ``background-color``,\n``background-image``, ``background-repeat``, ``background-attachment``,\n``background-position``, ``background-clip``, ``background-origin`` and\n``background-size`` properties.\n\nWeasyPrint also supports the `rounded corners part`_ of this module, including\nthe ``border-radius`` property.\n\nWeasyPrint also supports the `border images part`_ of this module, including the\n``border-image``, ``border-image-source``, ``border-image-slice``,\n``border-image-width``, ``border-image-outset`` and ``border-image-repeat``\nproperties.\n\nWeasyPrint does **not** support the `box shadow part`_ of this module,\nincluding the ``box-shadow`` property. This feature has been implemented in a\n`git branch`_ that is not released, as it relies on raster implementation of\nshadows.\n\n.. _CSS Backgrounds and Borders Level 3: https://www.w3.org/TR/css-backgrounds-3/\n.. _border part: https://www.w3.org/TR/css-backgrounds-3/#borders\n.. _background part: https://www.w3.org/TR/css-backgrounds-3/#backgrounds\n.. _rounded corners part: https://www.w3.org/TR/css-backgrounds-3/#corners\n.. _border images part: https://www.w3.org/TR/css-backgrounds-3/#border-images\n.. _box shadow part: https://www.w3.org/TR/css-backgrounds-3/#misc\n.. _git branch: https://github.com/Kozea/WeasyPrint/pull/149\n\nCSS Image Values and Replaced Content Module Level 3 / 4\n++++++++++++++++++++++++++++++++++++++++++++++++++++++++\n\nThe `Image Values and Replaced Content Module Level 3`_ is a candidate\nrecommendation introducing \"additional ways of representing 2D images, for\nexample as a list of URIs denoting fallbacks, or as a gradient\", defining\n\"several properties for manipulating raster images and for sizing or\npositioning replaced elements\" and \"generic sizing algorithm for replaced\nelements\".\n\nThe `Image Values and Replaced Content Module Level 4`_ is a working draft on\nthe same subject.\n\nThe ``linear-gradient()``, ``radial-gradient()`` and\n``repeating-radial-gradient()`` properties are supported as background images.\n\nThe the ``url()`` notation is supported, but the ``image()`` notation is\n**not** supported for background images.\n\nThe ``object-fit`` and ``object-position`` properties are supported.\n\nThe ``from-image`` and ``snap`` values of the ``image-resolution`` property are\n**not** supported, but the ``resolution`` value is supported.\n\nThe ``image-rendering`` and ``image-orientation`` properties are supported.\n\n.. _Image Values and Replaced Content Module Level 3: https://www.w3.org/TR/css-images-3/\n.. _Image Values and Replaced Content Module Level 4: https://www.w3.org/TR/css-images-4/\n\nCSS Box Sizing Module Level 3\n+++++++++++++++++++++++++++++\n\nThe `CSS Box Sizing Module Level 3`_ is a candidate recommendation extending\n\"the CSS sizing properties with keywords that represent content-based\n'intrinsic' sizes and context-based 'extrinsic' sizes.\"\n\nThe new property defined in this document is implemented in WeasyPrint:\n``box-sizing``.\n\nThe ``min-content``, ``max-content`` and ``fit-content()`` sizing values are\n**not** supported.\n\n.. _CSS Box Sizing Module Level 3: https://www.w3.org/TR/css-sizing-3/\n\nCSS Overflow Module Level 3\n+++++++++++++++++++++++++++\n\nThe `CSS Overflow Module Level 3`_ is a working draft containing \"the features\nof CSS relating to scrollable overflow handling in visual media.\"\n\nThe ``overflow`` property is supported, as defined in CSS2. ``overflow-x``,\n``overflow-y``, ``overflow-clip-margin``, ``overflow-inline`` and\n``overflow-block`` are **not** supported.\n\nThe ``text-overflow``, ``block-ellipsis``, ``line-clamp``, ``max-lines`` and\n``continue`` properties are supported.\n\n.. _CSS Overflow Module Level 3: https://www.w3.org/TR/2020/WD-css-overflow-3-20200603/\n\nCSS Values and Units Module Level 3 / 4\n+++++++++++++++++++++++++++++++++++++++\n\nThe `CSS Values and Units Module Level 3`_ defines various units and\nkeywords used in \"value definition field of each CSS property\".\n\nThe `CSS Values and Units Module Level 4`_ adds many new units, unit types and math\nfunctions.\n\nThe ``initial`` and ``inherit`` CSS-wide keywords are supported, but the\n``unset`` keyword is **not** supported.\n\nQuoted strings, URLs and numeric data types are supported.\n\nFont-relative lengths (``*em``, ``*ex``, ``*ch``, ``*cap``, ``*ic``, ``*lh``),\nviewport-relative lengths (``*vw``, ``*vh``, ``*vi``, ``*vb``, ``*vmin``, ``*vmax``),\nabsolute lengths (``cm``, ``mm``, ``q``, ``in``, ``pt``, ``pc``, ``px``), angles\n(``rad``, ``grad``, ``turn``, ``deg``), resolutions (``dpi``, ``dpcm``, ``dppx``, ``x``)\nare supported.\n\nUnspecified page-relative units (``pvw``, ``pvh``…) are also supported. They are\nrelative to the whole page size (including page margins), while all the other units are\nrelative to the page area size (without page margins).\n\nThe ``attr()`` functional notation is allowed in the ``content`` and\n``string-set`` properties.\n\nAll the mathematical functions (``calc()``…) are supported.\n\n.. _CSS Values and Units Module Level 3: https://www.w3.org/TR/css3-values/\n.. _CSS Values and Units Module Level 4: https://www.w3.org/TR/css4-values/\n\nCSS Multi-column Layout Module\n++++++++++++++++++++++++++++++\n\nThe `CSS Multi-column Layout Module`_ \"describes multi-column layouts in CSS, a\nstyle sheet language for the web. Using functionality described in the\nspecification, content can be flowed into multiple columns with a gap and a\nrule between them.\"\n\nSimple multi-column layouts are supported in WeasyPrint. Features such as\nconstrained height, spanning columns or column breaks are **not**\nsupported. Pagination and overflow are not seriously tested.\n\nThe ``column-width`` and ``column-count`` properties, and the ``columns``\nshorthand property are supported.\n\nThe ``column-gap``, ``column-rule-color``, ``column-rule-style`` and\n``column-rule-width`` properties, and the ``column-rule`` shorthand property\nare supported.\n\nThe ``break-before``, ``break-after`` and ``break-inside`` properties are\nsupported.\n\nThe ``column-span`` property is supported for direct children of columns.\n\nThe ``column-fill`` property is supported, with a column balancing algorithm\nthat should be efficient with simple cases.\n\n.. _CSS Multi-column Layout Module: https://www.w3.org/TR/css-multicol-1/\n\nCSS Fragmentation Module Level 3 / 4\n++++++++++++++++++++++++++++++++++++\n\nThe `CSS Fragmentation Module Level 3`_ \"describes the fragmentation model that\npartitions a flow into pages, columns, or regions. It builds on the Page model\nmodule and introduces and defines the fragmentation model. It adds\nfunctionality for pagination, breaking variable fragment size and orientation,\nwidows and orphans.\"\n\nThe `CSS Fragmentation Module Level 4`_ is a working draft on the same subject.\n\nThe ``break-before``, ``break-after`` and ``break-inside`` properties are\nsupported for pages, but **not** for columns and regions. ``page-break-*``\naliases as defined in CSS2 are supported too.\n\nThe ``orphans`` and ``widows`` properties are supported.\n\nThe ``box-decoration-break`` property is supported, but backgrounds are always\nrepeated and not extended through the whole box as it should be with 'slice'\nvalue.\n\nThe ``margin-break`` property is supported.\n\n.. _CSS Fragmentation Module Level 3: https://www.w3.org/TR/css-break-3/\n.. _CSS Fragmentation Module Level 4: https://www.w3.org/TR/css-break-4/\n\nCSS Custom Properties for Cascading Variables Module Level 1\n++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++\n\nThe `CSS Custom Properties for Cascading Variables Module Level 1`_ \"introduces\ncascading variables as a new primitive value type that is accepted by all CSS\nproperties, and custom properties for defining them.\"\n\nThe custom properties and the ``var()`` notation are supported.\n\n.. _CSS Custom Properties for Cascading Variables Module Level 1: https://www.w3.org/TR/css-variables/\n\nCSS Text Decoration Module Level 3 / 4\n++++++++++++++++++++++++++++++++++++++\n\nThe `CSS Text Decoration Module Level 3`_ \"contains the features of CSS\nrelating to text decoration, such as underlines, text shadows, and emphasis\nmarks.\"\n\nThe `CSS Text Decoration Module Level 4`_ is a working draft on the same subject.\n\nThe ``text-decoration-line``, ``text-decoration-style``,\n``text-decoration-color``, ``text-decoration-thickness`` and\n``text-underline-offset`` properties are supported. The ``text-decoration``\nshorthand is also supported.\n\nThe other properties (``text-underline-position``, ``text-emphasis-*``,\n``text-shadow``) are not supported.\n\n.. _CSS Text Decoration Module Level 3: https://www.w3.org/TR/css-text-decor-3/\n.. _CSS Text Decoration Module Level 4: https://www.w3.org/TR/css-text-decor-4/\n\nCSS Flexible Box Layout Module Level 1\n++++++++++++++++++++++++++++++++++++++\n\nThe `CSS Flexible Box Layout Module Level 1`_ \"describes a CSS box model\noptimized for user interface design\", also known as \"flexbox\".\n\nThis module works for simple use cases but is not deeply tested.\n\nAll the ``flex-*``, ``align-*``, ``justify-*`` and ``order`` properties are\nsupported. The ``flex`` and ``flex-flow`` shorthands are supported too.\n\n.. _CSS Flexible Box Layout Module Level 1: https://www.w3.org/TR/css-flexbox-1/\n\nCSS Grid Layout Module Level 2\n++++++++++++++++++++++++++++++\n\nThe `CSS Grid Layout Module Level 2`_ \"defines a two-dimensional grid-based layout\nsystem, optimized for user interface design\".\n\nThis module works for simple cases, but has some limitations. Here are\nnon-exhaustive lists of supported/unsupported features.\n\nSupported:\n\n- ``display: grid``,\n- ``grid-auto-*``, ``grid-template-*`` and other ``grid-*`` properties,\n- ``grid`` and other ``grid-*`` shorthands,\n- flexible lengths (``fr`` unit),\n- line names,\n- grid areas,\n- auto rows and auto columns,\n- ``z-index``,\n- ``repeat(X, *)``,\n- ``minmax()``,\n- ``align-*`` and ``justify-*`` alignment properties,\n- ``gap`` and ``*-gap`` properties for gutters,\n- dense auto flow,\n- ``order``,\n- margins, borders, padding on grid containers and grid items,\n- fragmentation between rows.\n\nUnsupported or untested:\n\n- ``display: inline-grid``,\n- auto content size for grid containers,\n- ``grid-auto-flow: column``,\n- subgrids,\n- ``repeat(auto-fill, *)`` and ``repeat(auto-fit, *)``,\n- auto margins for grid items,\n- ``span`` with line names,\n- ``span`` for flexible tracks,\n- ``safe`` and ``unsafe`` alignments,\n- baseline alignment,\n- grid items with intrinsic size (images),\n- distribute space beyond limits,\n- grid items larger than grid containers,\n- ``min-width``, ``max-width``, ``min-height``, ``max-height`` on grid items,\n- complex ``min-content`` and ``max-content`` cases,\n- absolutely positioned and floating grid items,\n- fragmentation in rows.\n\n.. _CSS Grid Layout Module Level 2: https://www.w3.org/TR/css-grid-2/\n\nCSS Basic User Interface Module Level 3/4\n+++++++++++++++++++++++++++++++++++++++++\n\nThe `CSS Basic User Interface Module Level 3/4`_ \"enables authors to style user\ninterface related properties and values.\"\n\nThe ``outline-width``, ``outline-style``, ``outline-color`` properties and the\n``outline`` shorthand are supported. The ``outline-offset`` property is also\nsupported.\n\nThe ``resize``, ``cursor``, ``caret-*`` and ``nav-*`` properties are **not**\nsupported.\n\nThe ``appearance`` property is supported. When set to ``auto``, it displays\nform fields as PDF form fields (supported for text inputs, check boxes, text\nareas, and select only).\n\nThe ``accent-color`` property is **not** supported.\n" }, { "path": "docs/changelog.rst", "content": "Changelog\n=========\n\n\nVersion 68.1\n------------\n\nReleased on 2026-02-06.\n\nBug fixes:\n\n* `#2662 `_:\n Don’t crash when SVG clip paths are not in defs tags\n* `#2665 `_:\n Fix position of box bounding box\n* `#2663 `_:\n Fix transparency with Acrobat and Edge\n* `#2666 `_:\n Don’t rely on random default font to define test page size\n* `#2670 `_:\n Fix pattern detection of URL schemes\n* `#2671 `_:\n Improve API compatibility between URLFetcherResponse and addinfourl\n* `#2672 `_:\n Fix charset for old URL fetcher requests\n* `#2675 `_,\n `#2673 `_:\n Fix calc for many properties\n\nContributors:\n\n* Guillaume Ayoub\n\nBackers and sponsors:\n\n* Spacinov\n* Syslifters\n* Kobalt\n* Simon Sapin\n* Grip Angebotssoftware\n* Manuel Barkhau\n* Simonsoft\n* KontextWork\n* Menutech\n* TrainingSparkle\n* Healthchecks.io\n* Method B\n* FieldHub\n* Hammerbacher\n* Yanal-Yves Fargialla\n* Morntag\n* Piloterr\n* Xavid\n* Charlie S.\n* Prothesis Dental Solutions\n* Kai DeLorenzo\n\n\nVersion 68.0\n------------\n\nReleased on 2026-01-19.\n\n**This is a security update (CVE-2025-68616).**\n\nWe strongly recommend to upgrade WeasyPrint to the latest version if you use the\n``default_url_fetcher`` function in your custom URL fetcher, or if you use the\n``allowed_protocols`` parameter of the ``default_url_fetcher`` function.\n\nSecurity:\n\n* Always use URL fetcher for HTTP redirects\n\nPython API:\n\n* ``default_url_fetcher()`` is deprecated, use the new ``URLFetcher`` class instead, see\n :ref:`URL Fetchers` for more information about URL fetchers\n* ``DocumentMetadata.generate_rdf_metadata`` is now a method that can be overridden\n instead of a parameter, see :ref:`Factur-X / ZUGFeRD (Electronic Invoices)` for\n examples to create e-invoices\n\nFeatures:\n\n* `#2609 `_,\n `#2603 `_,\n `#351 `_:\n Refactor URL fetcher API\n* `#2632 `_:\n Support legacy 0 value for angles\n* `#2627 `_:\n Add font-face support to SVG\n* `#2646 `_,\n `#2255 `_:\n Add font shorthand support for SVG text elements\n* `#2590 `_,\n `#1749 `_:\n Honor language-specific rules for text-transform\n* `#2645 `_,\n `#2613 `_:\n Improve SVG and SVG emojis rendering\n* `#2658 `_,\n `#2583 `_:\n Add CLI for Factur-X / ZUGFeRD e-invoices\n\nBug fixes:\n\n* `#2649 `_:\n Refactor URL fetcher API\n* `#2643 `_,\n `#2628 `_:\n Handle box-sizing: border-box in grid layout\n* `#2641 `_,\n `#1875 `_:\n Process whitespace after checking all pending targets\n* `#2488 `_,\n `#2485 `_:\n Preserve page groups during layout repagination\n* `#2642 `_,\n `#2631 `_:\n Don’t use isolated transparency groups\n* `#2637 `_:\n Fix repeating radial gradients rendering\n* `#2622 `_:\n Fix validation of colors\n* `#2626 `_:\n Share grid items rendering advancement between a box and its copies\n* `#2621 `_:\n Correctly handle fallback values of attr()\n* `#2619 `_:\n Fix SVG fonts\n* `#2629 `_:\n Always define extra skip height that may be used after\n* `#2648 `_:\n Fix numbers validation in font-feature-settings\n* `#2648 `_:\n Fix keyword values for text-decoration-thickness\n* `#2661 `_:\n Respect inline images when defining minimum table width\n\nDocumentation:\n\n* `#2638 `_:\n Update Python command for Windows installation steps\n\nContributors:\n\n* Guillaume Ayoub\n* Jurriaan Pruis\n* Mohamed Hamed\n* Alexandra Usatenko\n* Andrea Corna\n* Aoishik Khan\n* Joe\n\nBackers and sponsors:\n\n* Spacinov\n* Syslifters\n* Kobalt\n* Simon Sapin\n* Grip Angebotssoftware\n* Manuel Barkhau\n* Simonsoft\n* KontextWork\n* Menutech\n* TrainingSparkle\n* Healthchecks.io\n* Method B\n* FieldHub\n* Hammerbacher\n* Yanal-Yves Fargialla\n* Morntag\n* Piloterr\n* Xavid\n* Charlie S.\n* Prothesis Dental Solutions\n* Kai DeLorenzo\n\n\nVersion 67.0\n------------\n\nReleased on 2025-12-02.\n\nDependencies:\n\n* Python 3.10+ is now needed, Python 3.9 is not supported anymore\n* tinycss2 1.5.0+ is now needed\n* fontTools 4.59.2+ is now needed\n\nFeatures:\n\n* `#2560 `_,\n `#640 `_,\n `#844 `_,\n `#1091 `_,\n `#2517 `_:\n Support CMYK colors, PDF/X, color profiles and light-dark() function\n* `#2558 `_,\n `#1175 `_:\n Support ::first-line, with financial support from Karte Technology\n* `#2552 `_:\n Support CSS layers, with financial support from Code & Co.\n* `#2564 `_,\n `#2599 `_,\n `#2397 `_:\n Allow page breaks in grid rows, with financial support from Ocean Recap\n* `#2568 `_,\n `#357 `_:\n Support calc() and other mathematical functions\n* `#2575 `_,\n `#2574 `_:\n Support PDF/A-1a, PDF/A-2a and PDF/A-3a\n* `#2611 `_,\n `#2573 `_:\n Support PDF/A-4e and PDF/A-4f\n* `#2523 `_:\n Display tofu for missing glyphs\n* `#2581 `_:\n Add option to disable protocols in URL resolution\n* `#2570 `_:\n Support rch, cap, rcap, rex, ic and ric font-relative units\n* `#2547 `_,\n `#2140 `_:\n Support \"only\" keyword in media queries\n\nBug fixes:\n\n* `#2516 `_,\n `#1510 `_:\n Fix rendering of first line of text with nested right float\n* `#2510 `_,\n `#1073 `_,\n `#2507 `_:\n Avoid Pango crashes and font mismatches with @font-face rules referencing local fonts\n* `#2532 `_,\n `#2531 `_:\n Use fonttools instancer instead of deprecated mutator API\n* `#2541 `_:\n Fix syntax of functions\n* `#2543 `_:\n Allow font-related units to access @font-face fonts\n* `#2525 `_:\n Respect top margins and avoid overlapping footnotes for columns, with financial support from Code & Co.\n* `#2536 `_:\n Remove Subtype key from font descriptor\n* `#2539 `_:\n Fix min width for SVGs with intrinsic ratio but no intrinsic size\n* `#2537 `_,\n `#2533 `_:\n Fix order of operators when drawing SVGs\n* `#2538 `_:\n Don’t crash with nested unknown functions\n* `#2542 `_:\n Don’t crash when lh and rlh are used for line height or font size\n* `#2540 `_,\n `#2528 `_:\n Use locale encoding instead of filesystem encoding for font paths\n* `#2563 `_,\n `#2479 `_:\n Don’t avoid float collisions for atomic flex items\n* `#2569 `_:\n Don’t be case-sensitive for units\n* `#2567 `_,\n `#2566 `_:\n Add x-default attribute for metadata description to be compliant with PDF/A\n* `#2586 `_,\n `#2571 `_:\n Improve formatting contexts management\n* `#2600 `_:\n Fix SVG image aspect ratio when only width or height is specified\n* `#2612 `_,\n `#2595 `_:\n Clean block layout and fix corner cases\n* `#2522 `_:\n Ignore preserveAspectRatio when SVG has no viewBox\n* `#2544 `_:\n Allow to use a variable twice in a function\n* `#2555 `_:\n Fix flex gap in right-to-left context\n* `#2591 `_:\n Respect non-auto widths and fix padding of grid items\n* `#2601 `_:\n Don’t crash when tagged tables are not displayed as tables\n* `#2607 `_:\n Fix rendering of multiline textareas with PDF forms\n* `#2106 `_:\n Force variable initialization to avoid crashes during column layout\n* `#2618 `_,\n `#2617 `_:\n Fix rendering of relative grid and flex items\n\nDocumentation:\n\n* `#2535 `_:\n `#2534 `_:\n Removed reference to defunct site\n\nContributors:\n\n* Guillaume Ayoub\n* Fazle Rabbi Ferdaus\n* Lucie Anglade\n* Luca Vercelli\n* ChickenF622\n* Ernie Chu\n* Mark Pullin\n* Malte Laukötter\n* Markus Mohanty\n* Yvonne Kothmeier\n* Jarom Ort\n* kuypan\n\nBackers and sponsors:\n\n* Spacinov\n* Syslifters\n* Kobalt\n* Simon Sapin\n* Grip Angebotssoftware\n* Manuel Barkhau\n* Simonsoft\n* KontextWork\n* Menutech\n* TrainingSparkle\n* Healthchecks.io\n* Method B\n* FieldHub\n* Hammerbacher\n* Yanal-Yves Fargialla\n* Morntag\n* Piloterr\n* Xavid\n* Charlie S.\n* Prothesis Dental Solutions\n* Kai DeLorenzo\n\n\nVersion 66.0\n------------\n\nReleased on 2025-07-24.\n\nFeatures:\n\n* `#2475 `_:\n Add support for 'lh' and 'rlh' units\n* `#2432 `_,\n `#2437 `_:\n Report footnotes when text overflows because of orphans, with financial support from Code & Co.\n* `#2256 `_,\n `#2466 `_:\n Handle transform-origin in SVG\n* `#2445 `_:\n Add parameter to have additional HTTP headers for url_fetcher\n\nBug fixes:\n\n* `#2471 `_,\n `#2506 `_,\n `#2500 `_,\n `#2460 `_,\n `#2363 `_,\n `#2470 `_,\n `#1872 `_,\n `#2153 `_,\n `#1838 `_,\n `#1837 `_,\n `#1784 `_,\n `#1835 `_,\n `#2444 `_,\n `#2497 `_,\n `#2505 `_,\n `#2503 `_,\n `#1836 `_,\n `#2467 `_:\n Improve PDF/UA support, with financial support from NLnet\n* `#2425 `_,\n `#1557 `_:\n Improve position of outside markers\n* `#2409 `_,\n `#2265 `_:\n Draw circles instead of rectangles when drawing dotted borders\n* `#2416 `_,\n `#2270 `_:\n Correctly split words for automatic hyphenation\n* `#2439 `_,\n `#2426 `_:\n Don’t rely on URL protocols outside URL fetcher function\n* `#2433 `_:\n Disable style for deprecated outline algorithm\n* `#2447 `_,\n `#2441 `_,\n `#2448 `_:\n Improve min- and max-content calculation, with financial support from Menutech\n* `#2454 `_,\n `#2442 `_,\n `#2449 `_:\n Minor fixes for flex layout\n* `#2473 `_,\n `#2459 `_:\n Include out-of-flow boxes in page layout progress, with financial support from Pathfindr\n* `#2458 `_:\n Replace deprecated warn logger function\n* `#2494 `_,\n `#1856 `_:\n Fix bug with bottom margins in columns\n* `#2435 `_:\n Make footnote calls inherit from footnotes\n* `#2484 `_,\n `#2456 `_:\n Allow to avoid page breaks after table-row-group elements\n* `#2450 `_:\n Draw background and borders for relative grid containers\n* `#2453 `_:\n Don’t advance position_y for collapsed margins of discarded children\n* `#2493 `_:\n Fix endless loop with CSS variables referencing each other\n* `#2502 `_:\n Ignore bottom margin when calculating footnote overflow\n\nContributors:\n\n* Guillaume Ayoub\n* Lucie Anglade\n* Alvaro Garcia Fernandez\n* Emmanuel Ferdman\n* Gabriel Corona\n* Markus Mohanty\n* Luca Vercelli\n* Tre Huang\n\nBackers and sponsors:\n\n* Spacinov\n* Kobalt\n* Grip Angebotssoftware\n* Syslifters\n* Simon Sapin\n* Manuel Barkhau\n* Simonsoft\n* Menutech\n* KontextWork\n* TrainingSparkle\n* Healthchecks.io\n* Hammerbacher\n* DocRaptor\n* Yanal-Yves Fargialla\n* Method B\n* FieldHub\n* Morntag\n* Xavid\n* Kai DeLorenzo\n* Charlie S.\n* Alan Villalobos\n\n\nVersion 65.1\n------------\n\nReleased on 2025-04-14.\n\nBug fixes:\n\n* `#2414 `_:\n Correctly handle flex columns split between pages\n* `1b24ad9 `_:\n Include padding in outer size of item elements\n* `#2419 `_:\n Set main tag as block by default\n* `#2415 `_:\n Fix support of replaced block box as flex items\n* `83da2fe0 `_:\n Fix margins and padding for rtl lists\n* `#2429 `_,\n `#1076 `_,\n `#2431 `_:\n Fix page groups\n\nContributors:\n\n* Guillaume Ayoub\n\nBackers and sponsors:\n\n* Spacinov\n* Kobalt\n* Grip Angebotssoftware\n* Syslifters\n* Simon Sapin\n* Manuel Barkhau\n* Simonsoft\n* Menutech\n* KontextWork\n* TrainingSparkle\n* Healthchecks.io\n* Hammerbacher\n* DocRaptor\n* Yanal-Yves Fargialla\n* Method B\n* FieldHub\n* Morntag\n* Xavid\n* Kai DeLorenzo\n* Charlie S.\n* Alan Villalobos\n\n\nVersion 65.0\n------------\n\nReleased on 2025-03-20.\n\nDependencies:\n\n* CSSSelect2 0.8.0 is now needed\n\nFeatures:\n\n* `#1665 `_:\n Support gap properties in Flex layout, with financial support from NLnet\n* `#378 `_,\n `#2405 `_:\n Handle @font-face unicode-range\n* `#2394 `_:\n Modernize and improve default user agent stylesheets\n\nBug fixes:\n\n* `#2362 `_,\n `#2387 `_,\n `#601 `_,\n `#1967 `_,\n `#1805 `_,\n `#2163 `_,\n `#2342 `_,\n `#2374 `_,\n `#1109 `_,\n `#1356 `_,\n `#1327 `_,\n `#1563 `_,\n `#1652 `_,\n `#2351 `_,\n `#2312 `_,\n `#2340 `_,\n `#1311 `_,\n `#2066 `_,\n `#2359 `_,\n `#2053 `_:\n Improve Flex layout, with financial support from NLnet.\n* `#1686 `_,\n `#2404 `_:\n Fix duplicate text selection with right-to-left text\n* `#2372 `_,\n `#2389 `_:\n Fix justification of right-to-left text\n* `#2403 `_:\n Fix emoji rendering with older versions of Pango\n* `#2392 `_:\n Fix complex cases involving nested SVG text anchors\n* `#2396 `_,\n `#2398 `_:\n Fix and improve font names in PDF\n* `#2269 `_,\n `#2390 `_:\n Apply justification to non-breaking spaces\n* `#2362 `_,\n `#2387 `_:\n Improve Flex layout, with financial support from NLnet.\n\nContributors:\n\n* Guillaume Ayoub\n* Luca Vercelli\n\nBackers and sponsors:\n\n* Spacinov\n* Kobalt\n* Grip Angebotssoftware\n* Syslifters\n* Simon Sapin\n* Manuel Barkhau\n* Simonsoft\n* Menutech\n* KontextWork\n* TrainingSparkle\n* Healthchecks.io\n* Hammerbacher\n* DocRaptor\n* Yanal-Yves Fargialla\n* Method B\n* FieldHub\n* Morntag\n* Xavid\n* Kai DeLorenzo\n* Charlie S.\n* Alan Villalobos\n\n\nVersion 64.1\n------------\n\nReleased on 2025-02-20.\n\nBug fixes:\n\n* `#2368 `_:\n Fix ascent and descent font values\n* `#2370 `_:\n Avoid endless recursion for variables in nested functions\n* `#2275 `_:\n Use correct containing block to render waiting children\n* `#2375 `_:\n Ensure that we handle text-anchor only on text content elements\n* `#2090 `_:\n Only create font temporary folder when adding fonts\n* `#2383 `_:\n Fix grid-template-areas validation and allow uppercase identifiers for grid lines\n\nContributors:\n\n* Guillaume Ayoub\n\nBackers and sponsors:\n\n* Spacinov\n* Kobalt\n* Grip Angebotssoftware\n* Syslifters\n* Simon Sapin\n* Manuel Barkhau\n* Simonsoft\n* Menutech\n* KontextWork\n* TrainingSparkle\n* Healthchecks.io\n* Hammerbacher\n* DocRaptor\n* Yanal-Yves Fargialla\n* Method B\n* FieldHub\n* Morntag\n* Xavid\n* Kai DeLorenzo\n* Charlie S.\n\n\nVersion 64.0\n------------\n\nReleased on 2025-01-30.\n\nFeatures:\n\n* `#2338 `_:\n Allow custom RDF metadata for PDF/A and eInvoices\n* `#123 `_,\n `#2345 `_:\n Handle small-caps synthesis\n* `#2343 `_:\n Support outline-offset\n* `#2361 `_:\n Support text-underline-offset and text-decoration-thickness\n* `#2296 `_:\n Don’t crash with tables with rounded corners split between pages\n\nBug fixes:\n\n* `#2360 `_:\n Fix gradients with non-RGB colors\n* `#2355 `_,\n `#2358 `_:\n Align png emojis to the surrounding text\n* `#2353 `_:\n Fix alignment of SVG text with multiple nested text-anchor values\n* `#2350 `_:\n Fix logging restoration in capture_logs\n* `#2341 `_:\n Fix page groups\n* `#2314 `_:\n Use CSS 'image-rendering' attribute for images in SVGs\n* `#2332 `_:\n Fix opacity for translated SVG elements\n* `#2329 `_:\n Refactor text.line_break.get_log_attrs\n* `#2325 `_,\n `#2326 `_:\n Fix table overflow edge cases\n\nPerformance:\n\n* `#2347 `_,\n `#2364 `_:\n Improve rendering speed for text\n\nDocumentation:\n\n* `#2352 `_:\n Add more use cases in documentation, use Furo theme\n\nContributors:\n\n* Guillaume Ayoub\n* Kesara Rathnayake\n* Xavid Pretzer\n* David Tagatac\n* Ernesto Ruge\n* Niko Abeler\n* Noam Kushinsky\n\nBackers and sponsors:\n\n* Spacinov\n* Kobalt\n* Grip Angebotssoftware\n* Syslifters\n* Simon Sapin\n* Manuel Barkhau\n* Simonsoft\n* Menutech\n* KontextWork\n* TrainingSparkle\n* Healthchecks.io\n* Hammerbacher\n* DocRaptor\n* Yanal-Yves Fargialla\n* Method B\n* FieldHub\n* Morntag\n* Xavid\n* Kai DeLorenzo\n* Charlie S.\n\n\nVersion 63.1\n------------\n\nReleased on 2024-12-10.\n\nDependencies:\n\n* `#2297 `_:\n Remove upper bounds for dependencies\n\nBug fixes:\n\n* `#2300 `_,\n `#2292 `_:\n Don’t avoid floats for flex items\n* `#2301 `_,\n `#2293 `_:\n Include floats in calculation of minimum cell height\n* `#2303 `_,\n `#2302 `_:\n Set alpha even when current color channels didn’t change\n* `#2306 `_:\n Don’t try to increase column width when there’s no extra width\n* `#2304 `_:\n Don’t forget skip stack when drawing flex items\n* `#2316 `_:\n Don’t crash with SVG symbols\n* `#2320 `_:\n Fix currentcolor detection when parsing gradient color stops\n* `#2322 `_,\n `#2289 `_:\n Don’t add DLL directories when using Windows executable\n* `#2323 `_,\n `#2305 `_:\n Fix different rendering test\n\nPerformance:\n\n* `#2319 `_:\n Fix memory leaks\n\nDocumentation:\n\n* `#2299 `_:\n Update install instructions for Alpine\n* `#2321 `_:\n Add example invocation of WeasyPrint on the \"Contribute\" page\n\nContributors:\n\n* Guillaume Ayoub\n* Jó Ágila Bitsch\n* Lucie Anglade\n* Alexander Gitter\n* Luke Cousins\n\nBackers and sponsors:\n\n* Spacinov\n* Kobalt\n* Grip Angebotssoftware\n* Syslifters\n* Manuel Barkhau\n* SimonSoft\n* Menutech\n* KontextWork\n* Simon Sapin\n* TrainingSparkle\n* Healthchecks.io\n* Hammerbacher\n* Advance Insight\n* Docraptor\n* Method B\n* FieldHub\n* Yanal-Yves Fargialla\n* Morntag\n* Xavid\n\n\nVersion 63.0\n------------\n\nReleased on 2024-10-29.\n\nDependencies:\n\n* Python 3.13 is now supported\n* pydyf 0.11.0+ is now needed\n* tinycss2 1.4.0+ is now needed\n* tinyhtml5 2.0.0+ is now needed, instead of html5lib\n\nFeatures:\n\n* `#2252 `_,\n `#895 `_:\n Handle page groups, with financial support from Code & Co.\n* `#1630 `_,\n `#2286 `_:\n Support CSS Color Level 4\n* `#2192 `_:\n Add PDF variant for debugging purpose\n* `#2208 `_:\n Support submit inputs in PDF forms\n* `#2139 `_:\n Support ``mask-border-*`` properties\n* `#1831 `_,\n `#2143 `_:\n Support radio inputs in PDF forms\n\nBug fixes:\n\n* `#2262 `_:\n Avoid integer overflows when converting units from/to doubles\n* `#2260 `_:\n Avoid float collision with box establishing formatting context\n* `#2240 `_,\n `#2242 `_:\n Handle ``svg`` tags with no size\n* `#2231 `_,\n `#1171 `_,\n `#2222 `_,\n `#1208 `_:\n Fix several problems related to ``flex-direction: column``\n* `#2239 `_:\n Don’t fail when SVG markers are undefined references\n* `#2230 `_,\n `#2238 `_:\n Set explicit flags when loading DLLs on Windows\n* `#2228 `_,\n `#1942 `_:\n Store original and PDF stream images in different cache slots\n* `#2234 `_:\n Apply stylesheet and other basic operations to SVG root tag\n* `#2054 `_,\n `#2233 `_:\n Keep auto margins on flex layout boxes\n* `#1883 `_:\n Don’t crash with empty list marker strings\n* `#2216 `_:\n Fix vertical alignment of out-of-flow elements in tables\n* `#996 `_,\n `#2219 `_:\n Don’t ignore absolutely positioned elements inside flex boxes\n* `#2217 `_:\n Don’t crash with ``normal`` column gaps\n* `#1817 `_:\n Don’t assume that lines break after spaces\n* `#1868 `_:\n Don’t break rows with atomic cells\n* `#2166 `_:\n Don’t display bottom border on cells in split rows\n* `61852c4 `_:\n Capture fontTools logs when subsetting fonts\n* `#2190 `_:\n Don’t use a pattern when drawing backgrounds for no-repeat background images\n* `#2185 `_:\n Check that Harfbuzz version is at least 4.1.0 to subset fonts\n* `#2180 `_:\n Store width for all glyphs when font is not subset\n* `#2183 `_:\n Respect ``break-inside: avoid`` for flex items\n* `#2055 `_,\n `#2058 `_:\n Fix right-to-left tables with collapsed borders\n* `#2179 `_,\n `#1128 `_:\n Handle buggy Adobe Photoshop CMYK JPEGs\n* `#2175 `_:\n Don’t compress PDF metadata for PDF/A-1\n* `#2174 `_:\n Fix extra width distribution for auto table layout\n\nPerformance:\n\n* `#1155 `_:\n Improve rendering speed for large colspan values\n* `#2120 `_,\n `#2178 `_:\n Use Harfbuzz to subset fonts by default\n\nDocumentation:\n\n* `#2282 `_,\n `#2284 `_:\n Simplify Alpine install instructions\n* `#2254 `_:\n Add warning about antivirus false detection\n* `#2220 `_:\n Add extra information to debug logs\n* `#2211 `_:\n Fix link to samples\n* `#2195 `_:\n Update cache argument documentation\n* `#2105 `_,\n `#2151 `_:\n Use MSYS2 instead of GTK+3 for Windows\n\nContributors:\n\n* Guillaume Ayoub\n* David Huggins-Daines\n* Xavid Pretzer\n* Yann Trividic\n* Kevin Kays\n* Alejandro Avilés\n* Gianluca Teti\n* Gregory Goodson\n* Lucie Anglade\n* Roman Sirokov\n\nBackers and sponsors:\n\n* Spacinov\n* Kobalt\n* Grip Angebotssoftware\n* Syslifters\n* Manuel Barkhau\n* SimonSoft\n* Menutech\n* KontextWork\n* Simon Sapin\n* TrainingSparkle\n* Healthchecks.io\n* Hammerbacher\n* Advance Insight\n* Docraptor\n* Method B\n* FieldHub\n* Yanal-Yves Fargialla\n* Morntag\n* Xavid\n\n\nVersion 62.3\n------------\n\nReleased on 2024-06-21.\n\nBug fixes:\n\n* `#2174 `_:\n Fix extra width distribution for auto table layout\n* `#2175 `_:\n Don’t compress PDF metadata for PDF/A-1\n* `61f8bb3 `_:\n Set default PDF variant values in options before generating PDF\n* `2c4351e `_:\n Avoid PDF artifacts when drawing 0-width borders\n* `d9d7f62 `_:\n Don’t duplicate column when container is split on multiple pages\n* `4617b94 `_:\n Don’t set default Fontconfig values for unset properties\n* `4c81663 `_:\n Fix layout when all footnotes are removed from the footnote area\n* `#2184 `_:\n Make items overflowing grid wrap to the next row/column\n* `#2187 `_:\n Don’t append useless tracks when grid elements are positioned\n\nContributors:\n\n* Guillaume Ayoub\n\nBackers and sponsors:\n\n* Spacinov\n* Kobalt\n* Grip Angebotssoftware\n* Manuel Barkhau\n* SimonSoft\n* Menutech\n* KontextWork\n* Simon Sapin\n* René Fritz\n* TrainingSparkle\n* Healthchecks.io\n* Hammerbacher\n* Docraptor\n* Yanal-Yves Fargialla\n* Douwe van Loenen\n* Morntag\n* Xavid\n\n\nVersion 62.2\n------------\n\nReleased on 2024-06-04.\n\nFeatures:\n\n* `#2142 `_,\n `#2162 `_:\n Support grid-auto-flow: column, with financial support from Menutech\n\nBug fixes:\n\n* `#2167 `_:\n Fix space added by CSS gap at the end\n* `#2134 `_:\n Remove absolute placeholders from discarded content\n* `#2154 `_:\n Don’t crash when grid items have auto margins\n* `8cdd66f `_:\n Fix CSS nesting for nested selectors with comma\n* `3359db5 `_:\n Fix and test grid shorthand\n* `82deda4 `_:\n Fix wrong resume_at for split floats\n* `ff2acf1 `_:\n Ensure that gradient size is positive to please some PDF readers\n\nContributors:\n\n* Guillaume Ayoub\n\nBackers and sponsors:\n\n* Spacinov\n* Kobalt\n* Grip Angebotssoftware\n* Manuel Barkhau\n* SimonSoft\n* Menutech\n* KontextWork\n* Simon Sapin\n* René Fritz\n* TrainingSparkle\n* Healthchecks.io\n* Hammerbacher\n* Docraptor\n* Yanal-Yves Fargialla\n* Douwe van Loenen\n* Morntag\n* Xavid\n\n\nVersion 62.1\n------------\n\nReleased on 2024-05-06.\n\nBug fixes:\n\n* `#2144 `_,\n `#2149 `_:\n Avoid broken fonts when generating multiple documents\n* `c10c6892 `_:\n Display at least one grid row on empty pages\n* `#2146 `_:\n Don’t crash when flex container’s parent’s height is auto\n\nContributors:\n\n* Guillaume Ayoub\n* Claudius Ellsel\n\nBackers and sponsors:\n\n* Spacinov\n* Kobalt\n* Grip Angebotssoftware\n* Manuel Barkhau\n* SimonSoft\n* Menutech\n* KontextWork\n* Simon Sapin\n* René Fritz\n* TrainingSparkle\n* Healthchecks.io\n* Docraptor\n* Yanal-Yves Fargialla\n* Douwe van Loenen\n* Morntag\n* Xavid\n\n\nVersion 62.0\n------------\n\nReleased on 2024-04-30.\n\nDependencies:\n\n* Python 3.9+ is now needed, Python 3.7 and 3.8 are not supported anymore\n* pydyf 0.10.0+ is now needed\n* tinycss2 1.3.0+ is now needed\n\nFeatures:\n\n* `#543 `_,\n `#2121 `_:\n Support CSS Grid layout\n* `#2124 `_,\n `#2125 `_:\n Support border-image-* properties\n* `#2084 `_,\n `#2077 `_:\n Support CSS nesting\n* `#2101 `_:\n Support HTML maxlength attribute for form fields\n* `#2095 `_:\n Apply overflow to replaced boxes\n* `245e4f5 `_:\n Add support of PDF/A-?u\n\nBug fixes:\n\n* `#2136 `_:\n Don’t clip aligned text in SVG\n* `#2135 `_:\n Allow column-direction flex containers to use percentage-based heights\n* `#2128 `_:\n Don’t crash when a FontConfig object is destroyed early\n* `#2079 `_:\n Fix executable file for some Windows versions\n* `#2131 `_:\n Fix alpha for images before/after transparent text\n* `#2111 `_:\n Handle auto and none values for CSS quotes property\n* `#2103 `_:\n Don’t crash with overconstrained columns\n* `#2100 `_:\n Fix rounding error when detecting overflows\n* `#2093 `_,\n `#2097 `_,\n `#2094 `_:\n Mark use of md5() and sha1() as not for security\n* `#1956 `_,\n `#2087 `_:\n Use CSS table module level 3 to compute widths\n* `#2086 `_:\n Fix selects with empty values displaying None\n* `#1112 `_,\n `#2082 `_,\n `#2085 `_:\n Fix computation for outer min-content width for table cells\n* `016bd81 `_:\n Fix many different bugs with SVG markers\n\nPerformance:\n\n* `#2130 `_:\n Cache font key instead of whole font content\n\nDocumentation:\n\n* `#2108 `_:\n Update documentation about CSS leader() function\n\nContributors:\n\n* Guillaume Ayoub\n* Lucie Anglade\n* Xavid Pretzer\n* kygoh\n* Germain Gueutier\n* Vagner José Nicolodi\n\nBackers and sponsors:\n\n* Spacinov\n* Kobalt\n* Grip Angebotssoftware\n* Manuel Barkhau\n* SimonSoft\n* Menutech\n* KontextWork\n* Simon Sapin\n* René Fritz\n* TrainingSparkle\n* Healthchecks.io\n* Docraptor\n* Yanal-Yves Fargialla\n* Douwe van Loenen\n* Morntag\n* Xavid\n\n\nVersion 61.2\n------------\n\nReleased on 2024-03-08.\n\n**This is a security update.**\n\nWe strongly recommend to upgrade WeasyPrint to the latest version if you use\nWeasyPrint 61.0 or 61.1. Older versions are not impacted.\n\nSecurity:\n\n- Always use URL fetcher for attachments\n\nContributors:\n\n* Guillaume Ayoub\n* Ilia Novoselov\n\nBackers and sponsors:\n\n* Spacinov\n* Kobalt\n* Grip Angebotssoftware\n* Manuel Barkhau\n* SimonSoft\n* Menutech\n* KontextWork\n* René Fritz\n* Simon Sapin\n* Arcanite\n* TrainingSparkle\n* Healthchecks.io\n* Hammerbacher\n* Docraptor\n* Yanal-Yves Fargialla\n* Morntag\n* NBCO\n\n\nVersion 61.1\n------------\n\nReleased on 2024-02-26.\n\nBug fixes:\n\n- `#2075 `_:\n Use default value when variable is not defined\n- `#2070 `_:\n Don’t crash when rendering SVGs with non-text a children\n- Don’t crash when SVG file can’t be rendered\n\nDocumentation:\n\n- `#2067 `_:\n Suggest \"dnf\" instead of \"yum\" to install Fedora packages\n- Improve documentation for Windows\n- Fix required version of TinyCSS2\n\nContributors:\n\n* Guillaume Ayoub\n* Felix Schwarz\n* Lucie Anglade\n\nBackers and sponsors:\n\n* Spacinov\n* Kobalt\n* Grip Angebotssoftware\n* Manuel Barkhau\n* SimonSoft\n* Menutech\n* KontextWork\n* René Fritz\n* Simon Sapin\n* Arcanite\n* TrainingSparkle\n* Healthchecks.io\n* Hammerbacher\n* Docraptor\n* Yanal-Yves Fargialla\n* Morntag\n* NBCO\n\n\nVersion 61.0\n------------\n\nReleased on 2024-02-12.\n\nPython API:\n\n* ``DocumentMetadata.attachments`` is now a list of ``Attachment`` objects, not\n a list of ``(url, description)`` tuples.\n\nNew features:\n\n* `#1219 `_,\n `#2017 `_:\n Support var() in shorthand and multiple-value functions\n* `#1986 `_:\n Support percentages for opacity\n* `#2050 `_:\n Build executable file for Windows\n* `#2000 `_:\n Support select fields\n* `#1993 `_:\n Handle background-attachment: fixed to cover the whole page\n* `#2023 `_,\n `#2022 `_:\n Allow text-based file objects for HTML and CSS classes\n* `#2014 `_:\n Remove warnings for PDF/A and PDF/UA compatibility\n\nBug fixes:\n\n* `#2052 `_,\n `#1869 `_:\n Handle attachments for PDF/A documents\n* `#2013 `_,\n `#2051 `_:\n Apply margin to running tables\n* `#1278 `_,\n `#1884 `_:\n Draw collapsed borders of running tables\n* `#2029 `_:\n Fix page counter in non-root absolute boxes\n* `#2043 `_:\n Fix text-anchor on SVG tspan elements\n* `#1968 `_,\n `#2039 `_:\n Use cell's border-height to calculate table row height\n* `#2030 `_:\n Ensure that bounding box is set to invisible text tags\n* `#2040 `_,\n `#2041 `_:\n Don’t crash on malformed URLs\n* `#2026 `_:\n Don’t break pages when fixed-height elements don’t overflow page\n* `#2038 `_:\n Don’t mix original streams when drawing transparent text\n* `#2016 `_:\n Avoid duplication when breaking out-of-flow boxes\n* `#2012 `_:\n Don’t crash when CSS properties have no value\n* `#2010 `_,\n `#1287 `_:\n Fix many corner cases with CSS variables\n* `#1996 `_:\n Don’t crash when drawing groove/ridge collapsed borders\n* `#1982 `_:\n Fix SVG markers size, position and drawing\n\nDocumentation:\n\n* `#2021 `_,\n `#2048 `_:\n Replace non-virtualenv installation instructions with distribution packages\n\nContributors:\n\n* Guillaume Ayoub\n* kygoh\n* Lucie Anglade\n* Timo Ramsauer\n* Alexander Gitter\n* Michael Lisitsa\n* Vagner José Nicolodi\n* Manolis Stamatogiannakis\n* Pascal de Bruijn\n* Viktor Shevtsov\n* Eduardo Gonzalez\n* Kesara Rathnayake\n\nBackers and sponsors:\n\n* Spacinov\n* Kobalt\n* Grip Angebotssoftware\n* Manuel Barkhau\n* SimonSoft\n* Menutech\n* KontextWork\n* René Fritz\n* Simon Sapin\n* Arcanite\n* TrainingSparkle\n* Healthchecks.io\n* Hammerbacher\n* Docraptor\n* Yanal-Yves Fargialla\n* Morntag\n* NBCO\n\n\nVersion 60.2\n------------\n\nReleased on 2023-12-11.\n\nBug fixes:\n\n* `#1982 `_:\n Fix SVG markers size, position and drawing\n* `23cfc775 `_:\n Draw background behind absolutely positioned replaced boxes\n* `fe2f0c69 `_:\n Don’t crash with bitmap fonts with no \"glyf\" table\n* `14605225 `_:\n Improve SVG text-anchor attribute\n\nContributors:\n\n* Guillaume Ayoub\n\nBackers and sponsors:\n\n* Spacinov\n* Kobalt\n* Grip Angebotssoftware\n* Manuel Barkhau\n* SimonSoft\n* Menutech\n* KontextWork\n* NCC Group\n* René Fritz\n* Nicola Auchmuty\n* Syslifters\n* Hammerbacher\n* TrainingSparkle\n* Daniel Kucharski\n* Healthchecks.io\n* Yanal-Yves Fargialla\n* WakaTime\n* Paheko\n* Synapsium\n* DocRaptor\n\n\nVersion 60.1\n------------\n\nReleased on 2023-09-29.\n\nBug fixes:\n\n* `#1973 `_:\n Fix crash caused by wrong UTF-8 indices\n\nContributors:\n\n* Guillaume Ayoub\n\nBackers and sponsors:\n\n* Spacinov\n* Kobalt\n* Grip Angebotssoftware\n* Manuel Barkhau\n* SimonSoft\n* Menutech\n* KontextWork\n* NCC Group\n* René Fritz\n* Nicola Auchmuty\n* Syslifters\n* Hammerbacher\n* TrainingSparkle\n* Daniel Kucharski\n* Healthchecks.io\n* Yanal-Yves Fargialla\n* WakaTime\n* Paheko\n* Synapsium\n* DocRaptor\n\n\nVersion 60.0\n------------\n\nReleased on 2023-09-25.\n\nNew features:\n\n* `#1903 `_:\n Print form fields\n* `#1922 `_:\n Add support for textLength and lengthAdjust in SVG text elements\n* `#1965 `_:\n Handle tag\n* `#1970 `_:\n Handle y offset of glyphs\n* `#1909 `_:\n Add a --timeout option\n\nBug fixes:\n\n* `#1887 `_:\n Fix footnote-call displayed incorrectly for some fonts\n* `#1890 `_:\n Fix page-margin boxes layout algorithm\n* `#1908 `_:\n Fix IndexError when rendering PDF version 1.4\n* `#1906 `_:\n Apply text transformations to first-letter pseudo elements\n* `#1915 `_:\n Avoid footnote appearing before its call\n* `#1934 `_:\n Fix balance before \"column-span: all\"\n* `#1935 `_:\n Only draw required glyph with OpenType-SVG fonts\n* `#1595 `_:\n Don’t draw clipPath when defined after reference\n* `#1895 `_:\n Don’t ignore min-width when computing cell size\n* `#1899 `_:\n Fix named pages inheritance\n* `#1936 `_:\n Avoid page breaks caused by children of overflow hidden boxes\n* `#1943 `_:\n Use bleed area for page’s painting area\n* `#1946 `_:\n Use margin box of children to define available width for leaders\n\nContributors:\n\n* Guillaume Ayoub\n* Sahil Rohilla\n* Azharuddin Syed\n* kygoh\n* Andy Lenards\n* Gaurav Samudra\n* Michael Wedl\n* Lucie Anglade\n* Obeida Shamoun\n* Evgeniy Krysanov\n\nBackers and sponsors:\n\n* Spacinov\n* Kobalt\n* Grip Angebotssoftware\n* Manuel Barkhau\n* SimonSoft\n* Menutech\n* KontextWork\n* NCC Group\n* René Fritz\n* Nicola Auchmuty\n* Syslifters\n* Hammerbacher\n* TrainingSparkle\n* Daniel Kucharski\n* Healthchecks.io\n* Yanal-Yves Fargialla\n* WakaTime\n* Paheko\n* Synapsium\n* DocRaptor\n\n\nVersion 59.0\n------------\n\nReleased on 2023-05-11.\n\nThis version also includes the changes from unstable b1 version listed\nbelow.\n\nBug fixes:\n\n* `#1864 `_:\n Handle overflow for svg and symbol tags in SVG images\n* `#1867 `_:\n Remove duplicate compression of attachments\n* `d0ad5c1 `_:\n Override use tag children instead of drawing their references\n* `93df1a5 `_:\n Don’t resize the same image twice when the --dpi option is set\n* `#1874 `_:\n Drawn underline and overline behind text\n\nContributors:\n\n* Guillaume Ayoub\n* Timo Ramsauer\n* Alexander Mankuta\n\nBackers and sponsors:\n\n* Castedo Ellerman\n* Kobalt\n* Spacinov\n* Grip Angebotssoftware\n* Crisp BV\n* Manuel Barkhau\n* SimonSoft\n* Menutech\n* KontextWork\n* NCC Group\n* René Fritz\n* Moritz Mahringer\n* Yanal-Yves Fargialla\n* Piotr Horzycki\n* Healthchecks.io\n* TrainingSparkle\n* Hammerbacher\n* Synapsium\n\n\nVersion 59.0b1\n--------------\n\nReleased on 2023-04-14.\n\n**This version is experimental, don't use it in production. If you find bugs,\nplease report them!**\n\nCommand-line API:\n\n* The ``--optimize-size`` option and its short equivalent ``-O`` have been\n deprecated. To activate or deactivate different size optimizations, you can\n now use:\n\n * ``--uncompressed-pdf``,\n * ``--optimize-images``,\n * ``--full-fonts``,\n * ``--hinting``,\n * ``--dpi ``, and\n * ``--jpeg-quality ``.\n\n* A new ``--cache-folder `` option has been added to store temporary\n data in the given folder on the disk instead of keeping them in memory.\n\nPython API:\n\n* Global rendering options are now given in ``**options`` instead of dedicated\n parameters, with slightly different names. It means that the signature of the\n ``HTML.render()``, ``HTML.write_pdf()`` and ``Document.write_pdf()`` has\n changed. Here are the steps to port your Python code to v59.0:\n\n 1. Use named parameters for these functions, not positioned parameters.\n 2. Rename some the parameters:\n\n * ``image_cache`` becomes ``cache`` (see below),\n * ``identifier`` becomes ``pdf_identifier``,\n * ``variant`` becomes ``pdf_variant``,\n * ``version`` becomes ``pdf_version``,\n * ``forms`` becomes ``pdf_forms``.\n\n* The ``optimize_size`` parameter of ``HTML.render()``, ``HTML.write_pdf()``\n and ``Document()`` has been removed and will be ignored. You can now use the\n ``uncompressed_pdf``, ``full_fonts``, ``hinting``, ``dpi`` and\n ``jpeg_quality`` parameters that are included in ``**options``.\n\n* The ``cache`` parameter can be included in ``**options`` to replace\n ``image_cache``. If it is a dictionary, this dictionary will be used to store\n temporary data in memory, and can be even shared between multiple documents.\n If it’s a folder Path or string, WeasyPrint stores temporary data in the\n given temporary folder on disk instead of keeping them in memory.\n\nNew features:\n\n* `#1853 `_,\n `#1854 `_:\n Reduce PDF size, with financial support from Code & Co.\n* `#1824 `_,\n `#1829 `_:\n Reduce memory use for images\n* `#1858 `_:\n Add an option to keep hinting information in embedded fonts\n\nBug fixes:\n\n* `#1855 `_:\n Fix position of emojis in justified text\n* `#1852 `_:\n Don’t crash when line can be split before trailing spaces\n* `#1843 `_:\n Fix syntax of dates in metadata\n* `#1827 `_,\n `#1832 `_:\n Fix word-spacing problems with nested tags\n\nDocumentation:\n\n* `#1841 `_:\n Add a paragraph about unsupported calc() function\n\nContributors:\n\n* Guillaume Ayoub\n* Lucie Anglade\n* Alex Ch\n* whi_ne\n* Jonas Castro\n\nBackers and sponsors:\n\n* Castedo Ellerman\n* Kobalt\n* Spacinov\n* Grip Angebotssoftware\n* Crisp BV\n* Manuel Barkhau\n* SimonSoft\n* Menutech\n* KontextWork\n* NCC Group\n* René Fritz\n* Moritz Mahringer\n* Yanal-Yves Fargialla\n* Piotr Horzycki\n* Healthchecks.io\n* TrainingSparkle\n* Hammerbacher\n* Synapsium\n\n\nVersion 58.1\n------------\n\nReleased on 2023-03-07.\n\nBug fixes:\n\n* `#1815 `_:\n Fix bookmarks coordinates\n* `#1822 `_,\n `#1823 `_:\n Fix vertical positioning for absolute replaced elements\n\nDocumentation:\n\n* `#1814 `_:\n Fix broken link pointing to samples\n\nContributors:\n\n* Guillaume Ayoub\n* Jonas Castro\n* Lucie Anglade\n* Menelaos Kotoglou\n\nBackers and sponsors:\n\n* Kobalt\n* Grip Angebotssoftware\n* Spacinov\n* Crisp BV\n* Castedo Ellerman\n* Manuel Barkhau\n* SimonSoft\n* Menutech\n* KontextWork\n* NCC Group\n* René Fritz\n* Moritz Mahringer\n* Yanal-Yves Fargialla\n* Piotr Horzycki\n* Healthchecks.io\n* Hammerbacher\n* TrainingSparkle\n* Synapsium\n\n\nVersion 58.0\n------------\n\nReleased on 2023-02-17.\n\nThis version also includes the changes from unstable b1 version listed\nbelow.\n\nBug fixes:\n\n* `#1807 `_:\n Don’t crash when out-of-flow box is split in out-of-flow parent\n* `#1806 `_:\n Don’t crash when fixed elements aren’t displayed yet in aborted line\n* `#1809 `_:\n Fix background drawing for out-of-the-page transformed boxes\n\nContributors:\n\n* Guillaume Ayoub\n\nBackers and sponsors:\n\n* Kobalt\n* Grip Angebotssoftware\n* Crisp BV\n* Spacinov\n* Castedo Ellerman\n* Manuel Barkhau\n* SimonSoft\n* Menutech\n* KontextWork\n* NCC Group\n* René Fritz\n* Moritz Mahringer\n* Yanal-Yves Fargialla\n* Piotr Horzycki\n* Healthchecks.io\n\n\nVersion 58.0b1\n--------------\n\nReleased on 2023-02-03.\n\n**This version is experimental, don't use it in production. If you find bugs,\nplease report them!**\n\nNew features:\n\n* `#61 `_,\n `#1796 `_:\n Support PDF forms, with financial support from Personalkollen\n* `#1173 `_:\n Add style for form fields\n\nBug fixes:\n\n* `#1777 `_:\n Detect JPEG/MPO images as normal JPEG files\n* `#1771 `_:\n Improve SVG gradients\n\nContributors:\n\n* Guillaume Ayoub\n* Lucie Anglade\n\nBackers and sponsors:\n\n* Kobalt\n* Grip Angebotssoftware\n* Crisp BV\n* Spacinov\n* Castedo Ellerman\n* Manuel Barkhau\n* SimonSoft\n* Menutech\n* KontextWork\n* NCC Group\n* René Fritz\n* Moritz Mahringer\n* Yanal-Yves Fargialla\n* Piotr Horzycki\n* Healthchecks.io\n\n\nVersion 57.2\n------------\n\nReleased on 2022-12-23.\n\nBug fixes:\n\n* `0f2e377 `_:\n Print annotations with PDF/A\n* `0e9426f `_:\n Hide annotations with PDF/UA\n* `#1764 `_:\n Use reference instead of stream for annotation appearance stream\n* `#1783 `_:\n Fix multiple font weights for @font-face declarations\n\nContributors:\n\n* Guillaume Ayoub\n\nBackers and sponsors:\n\n* Grip Angebotssoftware\n* Manuel Barkhau\n* Crisp BV\n* SimonSoft\n* Menutech\n* Spacinov\n* KontextWork\n* René Fritz\n* NCC Group\n* Kobalt\n* Tom Pohl\n* Castedo Ellerman\n* Moritz Mahringer\n* Piotr Horzycki\n* Gábor Nyers\n* Sidharth Kapur\n\n\nVersion 57.1\n------------\n\nReleased on 2022-11-04.\n\nDependencies:\n\n* `#1754 `_:\n Pillow 9.1.0 is now needed\n\nBug fixes:\n\n* `#1756 `_:\n Fix rem font size for SVG images\n* `#1755 `_:\n Keep format when transposing images\n* `#1753 `_:\n Don’t use deprecated ``read_text`` function when ``files`` is available\n* `#1741 `_:\n Generate better manpage\n* `#1747 `_:\n Correctly set target counters in pages’ absolute elements\n* `#1748 `_:\n Always set font size when font is changed in line\n* `2b05137 `_:\n Fix stability of font identifiers\n\nDocumentation:\n\n* `#1750 `_:\n Fix documentation spelling\n\nContributors:\n\n* Guillaume Ayoub\n* Eli Schwartz\n* Mikhail Anikin\n* Scott Kitterman\n\nBackers and sponsors:\n\n* Grip Angebotssoftware\n* Manuel Barkhau\n* Crisp BV\n* SimonSoft\n* Menutech\n* Spacinov\n* KontextWork\n* René Fritz\n* NCC Group\n* Kobalt\n* Tom Pohl\n* John R Ellis\n* Castedo Ellerman\n* Moritz Mahringer\n* Gábor\n* Piotr Horzycki\n\n\nVersion 57.0\n------------\n\nReleased on 2022-10-18.\n\nThis version also includes the changes from unstable b1 version listed\nbelow.\n\nNew features:\n\n* `a4fc7a1 `_:\n Support image-orientation\n\nBug fixes:\n\n* `#1739 `_:\n Set baseline on all flex containers\n* `#1740 `_:\n Don’t crash when currentColor is set on root svg tag\n* `#1718 `_:\n Don’t crash with empty bitmap glyphs\n* `#1736 `_:\n Always use the font’s vector variant when possible\n* `eef8b4d `_:\n Always set color and state before drawing\n* `#1662 `_:\n Use a stable key to store stream fonts\n* `#1733 `_:\n Don’t remove attachments when adding internal anchors\n* `3c4fa50 `_,\n `c215697 `_,\n `d275dac `_,\n `b04bfff `_:\n Fix many bugs related to PDF/UA structure\n\nPerformance:\n\n* `dfccf1b `_:\n Use faces as fonts dictionary keys\n* `0dc12b6 `_:\n Cache add_font to avoid calling get_face too often\n* `75e17bf `_:\n Don’t call process_whitespace twice on many children\n* `498d3e1 `_:\n Optimize __missing__ functions\n\nDocumentation:\n\n* `863b3d6 `_:\n Update documentation of installation on macOS with Homebrew\n\nContributors:\n\n* Guillaume Ayoub\n\nBackers and sponsors:\n\n* Grip Angebotssoftware\n* Manuel Barkhau\n* Crisp BV\n* SimonSoft\n* Menutech\n* Spacinov\n* KontextWork\n* René Fritz\n* NCC Group\n* Kobalt\n* Tom Pohl\n* John R Ellis\n* Castedo Ellerman\n* Moritz Mahringer\n* Gábor\n* Piotr Horzycki\n\n\nVersion 57.0b1\n--------------\n\nReleased on 2022-09-22.\n\n**This version is experimental, don't use it in production. If you find bugs,\nplease report them!**\n\nNew features:\n\n* `#1704 `_:\n Support PDF/UA, with financial support from Novareto\n* `#1454 `_:\n Support variable fonts\n\nBug fixes:\n\n* `#1058 `_:\n Fix bullet position after page break, with financial support from OpenZeppelin\n* `#1707 `_:\n Fix footnote positioning in multicolumn layout, with financial support from Code & Co.\n* `#1722 `_:\n Handle skew transformation with only one parameter\n* `#1715 `_:\n Don’t crash when images are truncated\n* `#1697 `_:\n Don’t crash when attr() is used in text-decoration-color\n* `#1695 `_:\n Include language information in PDF metadata\n* `#1612 `_:\n Don’t lowercase letters when capitalizing text\n* `#1700 `_:\n Fix crash when rendering footnote with repagination\n* `#1667 `_:\n Follow EXIF metadata for image rotation\n* `#1669 `_:\n Take care of floats when remvoving placeholders\n* `#1638 `_:\n Use the original box when breaking waiting children\n\nContributors:\n\n* Guillaume Ayoub\n* Konstantin Weddige\n* VeteraNovis\n* Lucie Anglade\n\nBackers and sponsors:\n\n* Grip Angebotssoftware\n* Manuel Barkhau\n* Crisp BV\n* SimonSoft\n* Menutech\n* Spacinov\n* KontextWork\n* René Fritz\n* NCC Group\n* Kobalt\n* Tom Pohl\n* John R Ellis\n* Moritz Mahringer\n* Gábor\n* Piotr Horzycki\n* Andrew Ittner\n\n\nVersion 56.1\n------------\n\nReleased on 2022-07-24.\n\nBug fixes:\n\n* `#1674 `_:\n Follow max-height on footnot area, with financial support from Code & Co.\n* `#1678 `_:\n Fix gradients with opacity set\n\nContributors:\n\n* Guillaume Ayoub\n* Lucie Anglade\n\nBackers and sponsors:\n\n* Grip Angebotssoftware\n* Manuel Barkhau\n* Crisp BV\n* SimonSoft\n* Menutech\n* Spacinov\n* KontextWork\n* René Fritz\n* NCC Group\n* Kobalt\n* Tom Pohl\n* Moritz Mahringer\n* Florian Demmer\n* Yanal-Yves Fargialla\n* Gábor\n* Piotr Horzycki\n* Andrew Ittner\n\n\nVersion 56.0\n------------\n\nReleased on 2022-07-07.\n\nThis version also includes the changes from unstable b1 version listed\nbelow.\n\nNew features:\n\n* `70f9b62 `_:\n Support format 5 for bitmap glyphs\n\nBug fixes:\n\n* `#1666 `_\n Fix reproducible PDF generation with embedded images\n* `#1668 `_:\n Fix @page:nth() selector\n* `3bd9a8e `_:\n Don’t limit the opacity groups to the original box size\n* `cb9540b `_,\n `76d174f `_,\n `9ce6547 `_:\n Minor bugfixes for split table rows\n\nContributors:\n\n* Guillaume Ayoub\n\nBackers and sponsors:\n\n* Grip Angebotssoftware\n* Manuel Barkhau\n* Crisp BV\n* SimonSoft\n* Menutech\n* Spacinov\n* KontextWork\n* René Fritz\n* NCC Group\n* Kobalt\n* Des images et des mots\n* Andreas Zettl\n* Tom Pohl\n* Moritz Mahringer\n* Florian Demmer\n* Yanal-Yves Fargialla\n* Gábor\n* Piotr Horzycki\n\n\nVersion 56.0b1\n--------------\n\nReleased on 2022-06-17.\n\n**This version is experimental, don't use it in production. If you find bugs,\nplease report them!**\n\nDependencies:\n\n* pydyf 0.2.0+ is now needed\n\nNew features:\n\n* `#1660 `_:\n Support nested line-clamp, with financial support from Expert Germany\n* `#1644 `_,\n `#1645 `_:\n Support bitmap fonts, with financial support from Expert Germany\n* `#1651 `_,\n `#630 `_:\n Support PDF/A, with financial support from Blueshoe\n\nBug fixes:\n\n* `#1656 `_:\n Fix chained variables in the same selector block\n* `#1028 `_:\n Fix font weight management in @font-face rules\n* `#1653 `_:\n Don’t crash when @font-face’s src ends with a comma\n* `#1650 `_:\n Don’t check origin when URL only contains fragment\n* `e38bff8 `_:\n Don’t crash when inherited SVG attributes are not set on the parent\n\nPerformance:\n\n* `e6021da `_:\n Launch tests in parallel by default\n\nContributors:\n\n* Guillaume Ayoub\n* aschmitz\n* Lucie Anglade\n\nBackers and sponsors:\n\n* Grip Angebotssoftware\n* Manuel Barkhau\n* Crisp BV\n* SimonSoft\n* Menutech\n* Spacinov\n* KontextWork\n* René Fritz\n* NCC Group\n* Kobalt\n* Des images et des mots\n* Andreas Zettl\n* Tom Pohl\n* Moritz Mahringer\n* Florian Demmer\n* Yanal-Yves Fargialla\n* Gábor\n* Piotr Horzycki\n\n\nVersion 55.0\n------------\n\nReleased on 2022-05-12.\n\nThis version also includes the changes from unstable b1 version listed\nbelow.\n\nBug fixes:\n\n* `#1626 `_,\n `3802f88 `_:\n Fix the vertical position and available height of absolute boxes\n* `9641098 `_,\n `e5e6b88 `_:\n Minor fixes for multi-column layout\n* `0fcc7de `_:\n Don’t stop rendering SVG when CSS parsing fails\n* `#1636 `_:\n Fix sequential footnotes that could disappear when overflowing\n* `#1637 `_:\n Fix position of absolute boxes with right-to-left direction\n* `#1641 `_:\n Fix relative paths for SVG files stored as data URLs\n\nContributors:\n\n* Guillaume Ayoub\n* aschmitz\n\nBackers and sponsors:\n\n* Grip Angebotssoftware\n* Manuel Barkhau\n* Crisp BV\n* SimonSoft\n* Menutech\n* Spacinov\n* KontextWork\n* René Fritz\n* NCC Group\n* Kobalt\n* Nathalie Gutton\n* Andreas Zettl\n* Tom Pohl\n* Moritz Mahringer\n* Florian Demmer\n* Yanal-Yves Fargialla\n* Gábor\n* Piotr Horzycki\n\n\nVersion 55.0b1\n--------------\n\nReleased on 2022-04-15.\n\n**This version is experimental, don't use it in production. If you find bugs,\nplease report them!**\n\nDependencies:\n\n* Python 3.7+ is now needed, Python 3.6 is not supported anymore\n\nNew features:\n\n* `#1534 `_:\n Support ``word-break: break-all``\n* `#489 `_,\n `#1619 `_:\n Support column breaks\n* `#1553 `_:\n Allow reproducible PDF generation\n\nBug fixes:\n\n* `#1007 `_,\n `#1524 `_:\n Handle ``inherit`` in shorthand properties\n* `#1539 `_,\n `#1541 `_:\n Space out no-repeat patterns\n* `#1554 `_:\n Avoid invalid PDF operators when drawing SVG text\n* `#1564 `_,\n `#1566 `_,\n `#1570 `_:\n Don’t output footnotes before their call sites\n* `#1020 `_,\n `#1597 `_:\n Prevent infinite loops in multi-column layout\n* `#1512 `_,\n `#1613 `_:\n Fix position of absolute boxes in right-to-left contexts\n* `#1093 `_:\n Draw borders around absolute replaced boxes\n* `#984 `_,\n `#1604 `_:\n Fix skip stacks for columns\n* `#1621 `_:\n Better support of nested ``text-decoration`` properties\n* `fe1f3d9 `_:\n Fix absolute blocks in lines\n* `4650b70 `_:\n Clear adjoining margins when a container’s child doesn’t fit\n\nPerformance:\n\n* `#1548 `_:\n Improve tests speed\n* `3b0ae92 `_,\n `#1457 `_:\n Improve fonts management\n* `#1597 `_:\n Improve column layout speed\n* `#1587 `_,\n `#1607 `_,\n `#1608 `_:\n Cache ``ch`` and ``ex`` units calculations\n\nContributors:\n\n* Guillaume Ayoub\n* aschmitz\n* Lucie Anglade\n* Christoph Kepper\n* Jack Lin\n* Rian McGuire\n\nBackers and sponsors:\n\n* Grip Angebotssoftware\n* Manuel Barkhau\n* Crisp BV\n* SimonSoft\n* Menutech\n* KontextWork\n* Maykin Media\n* René Fritz\n* NCC Group\n* Spacinov\n* Nathalie Gutton\n* Andreas Zettl\n* Tom Pohl\n* Kobalt\n* Moritz Mahringer\n* Florian Demmer\n* Yanal-Yves Fargialla\n* Gábor\n* Piotr Horzycki\n* DeivGuerrero\n\n\nVersion 54.3\n------------\n\nReleased on 2022-04-04.\n\nBug fixes:\n\n* `#1588 `_:\n Support position: absolute in footnotes\n* `#1586 `_:\n Fix discarded text-align values\n\nContributors:\n\n* aschmitz\n* Guillaume Ayoub\n\nBackers and sponsors:\n\n* Grip Angebotssoftware\n* Manuel Barkhau\n* Crisp BV\n* SimonSoft\n* Menutech\n* KontextWork\n* Maykin Media\n* René Fritz\n* NCC Group\n* Spacinov\n* Nathalie Gutton\n* Andreas Zettl\n* Tom Pohl\n* Kobalt\n* Moritz Mahringer\n* Florian Demmer\n* Yanal-Yves Fargialla\n* Gábor\n* Piotr Horzycki\n* DeivGuerrero\n\n\nVersion 54.2\n------------\n\nReleased on 2022-02-27.\n\nBug fixes:\n\n* `#1575 `_:\n Always store parent blocks children as lists\n* `#1574 `_,\n `#1559 `_:\n Fix float rounding errors\n* `#1571 `_:\n Ignore unknown glyphs\n* `#1561 `_,\n `#1562 `_:\n Fix line break when breaks occur between a nbsp and an inline block\n* `#1560 `_:\n Always set the child index\n* `#1558 `_:\n Fix patterns with use tags\n\nContributors:\n\n* Guillaume Ayoub\n* Lucie Anglade\n* Jack Lin\n* aschmitz\n\nBackers and sponsors:\n\n* Grip Angebotssoftware\n* Manuel Barkhau\n* Crisp BV\n* SimonSoft\n* Menutech\n* KontextWork\n* Maykin Media\n* René Fritz\n* NCC Group\n* Spacinov\n* Nathalie Gutton\n* Andreas Zettl\n* Tom Pohl\n* Kobalt\n* Moritz Mahringer\n* Florian Demmer\n* Yanal-Yves Fargialla\n* Gábor\n* Piotr Horzycki\n* DeivGuerrero\n\n\nVersion 54.1\n------------\n\nReleased on 2022-01-31.\n\nNew features:\n\n* `#1547 `_:\n Handle break-inside: avoid on tr tags\n\nBug fixes:\n\n* `#1540 `_,\n `#1239 `_:\n Handle absolute children in running elements\n* `#1538 `_:\n Handle invalid values in text-align\n* `#1536 `_:\n Handle absolute flex boxes\n\nContirbutors:\n\n* Guillaume Ayoub\n* Lucie Anglade\n\nBackers and sponsors:\n\n* H-Net: Humanities and Social Sciences Online\n* Grip Angebotssoftware\n* Manuel Barkhau\n* SimonSoft\n* Menutech\n* KontextWork\n* Crisp BV\n* Maykin Media\n* René Fritz\n* Simon Sapin\n* NCC Group\n* Nathalie Gutton\n* Andreas Zettl\n* Tom Pohl\n* Spacinov\n* Des images et des mots\n* Moritz Mahringer\n* Florian Demmer\n* Yanal-Yves Fargialla\n* Gábor\n* Piotr Horzycki\n\n\nVersion 54.0\n------------\n\nReleased on 2022-01-08.\n\nThis version also includes the changes from unstable b1 version listed\nbelow.\n\nBug fixes:\n\n* `#1531 `_:\n Always use absolute paths to get hrefs in SVG\n* `#1523 `_:\n Fix many rendering problems of broken tables\n* `e1aee70 `_:\n Fix support of fonts with SVG emojis\n\nContirbutors:\n\n* Guillaume Ayoub\n\nBackers and sponsors:\n\n* Grip Angebotssoftware\n* Manuel Barkhau\n* SimonSoft\n* Menutech\n* KontextWork\n* Crisp BV\n* Maykin Media\n* René Fritz\n* Simon Sapin\n* NCC Group\n* Nathalie Gutton\n* Andreas Zettl\n* Tom Pohl\n* Des images et des mots\n* Moritz Mahringer\n* Florian Demmer\n* Yanal-Yves Fargialla\n* Gábor\n* Piotr Horzycki\n\n\nVersion 54.0b1\n--------------\n\nReleased on 2021-12-13.\n\n**This version is experimental, don't use it in production. If you find bugs,\nplease report them!**\n\nDependencies:\n\n* html5lib 1.1+ is now needed.\n\nNew features:\n\n* `#1509 `_:\n Support footnotes, with financial support from Code & Co.\n* `#36 `_:\n Handle parallel flows for floats, absolutes, table-cells\n* `#1389 `_:\n Support ``text-align-last`` and ``text-align-all`` properties\n* `#1434 `_:\n Draw SVG and PNG emojis\n* `#1520 `_:\n Support ``overflow-wrap: anywhere``\n* `#1435 `_:\n Add environment variable to set DLL folder on Windows\n\nPerformance:\n\n* `#1439 `_:\n Cache SVG ``use`` tags\n* `#1481 `_:\n Encode non-JPEG images as PNGs instead of JPEG2000s\n\nBug fixes:\n\n* `#137 `_:\n Don’t use ``text-transform`` text for content-based uses\n* `#1443 `_:\n Don’t serialize and parse again inline SVG files\n* `#607 `_:\n Correctly handle whitespaces in bookmark labels\n* `#1094 `_:\n Fix column height with ``column-span`` content\n* `#1473 `_:\n Fix absolutely positioned boxes in duplicated pages\n* `#1491 `_:\n Fix ``target-counter`` attribute in flex items\n* `#1515 `_,\n `#1508 `_:\n Don’t draw empty glyphs\n* `#1499 `_:\n Don’t crash when font size is really small\n\nDocumentation:\n\n* `#1519 `_:\n Fix typo\n\nPackaging:\n\n* The source package does not include a ``setup.py`` file anymore. You can find\n more information about this in\n `issue #1410 `_.\n\nContirbutors:\n\n* Guillaume Ayoub\n* Lucie Anglade\n* Colin Kinloch\n* aschmitz\n* Pablo González\n* Rian McGuire\n\nBackers and sponsors:\n\n* Grip Angebotssoftware\n* Manuel Barkhau\n* SimonSoft\n* Menutech\n* KontextWork\n* Crisp BV\n* Maykin Media\n* René Fritz\n* Simon Sapin\n* NCC Group\n* Nathalie Gutton\n* Andreas Zettl\n* Tom Pohl\n* Des images et des mots\n* Moritz Mahringer\n* Florian Demmer\n* Yanal-Yves Fargialla\n* Gábor\n* Piotr Horzycki\n\n\nVersion 53.4\n------------\n\nReleased on 2021-11-14.\n\nBug fixes:\n\n* `#1446 `_:\n Fix background on pages with a bleed property\n* `#1455 `_:\n Use SVG width/height as inner size when no viewBox is given\n* `#1469 `_:\n Only enable letter- and word-spacing when needed\n* `#1471 `_:\n Don’t display inputs with \"hidden\" type\n* `#1485 `_:\n Allow quotes in url() syntax for SVG,\n Use better approximations for font ascent and descent values in SVG\n* `#1486 `_:\n Fix images embedded from multiple pages\n* `#1489 `_:\n Use a better hash for fonts to avoid collisions\n* `abd54c4 `_:\n Set SVG ratio when width and height are 0\n\nContributors:\n\n* Guillaume Ayoub\n* Lucie Anglade\n\nBackers and sponsors:\n\n* Grip Angebotssoftware\n* SimonSoft\n* Menutech\n* Manuel Barkhau\n* Simon Sapin\n* KontextWork\n* René Fritz\n* Maykin Media\n* NCC Group\n* Crisp BV\n* Des images et des mots\n* Andreas Zettl\n* Nathalie Gutton\n* Tom Pohl\n* Moritz Mahringer\n* Florian Demmer\n* Yanal-Yves Fargialla\n* G. Allard\n* Gábor\n\n\nVersion 53.3\n------------\n\nReleased on 2021-09-10.\n\nBug fixes:\n\n* `#1431 `_,\n `#1440 `_:\n Fix crashes and malformed PDF files\n* `#1430 `_:\n Handle cx and cy in SVG rotations\n* `#1436 `_:\n Fix marker-start being drawn on mid vertices\n\nContributors:\n\n* Guillaume Ayoub\n* Rian McGuire\n* Lucie Anglade\n\nBackers and sponsors:\n\n* Grip Angebotssoftware\n* SimonSoft\n* Menutech\n* Manuel Barkhau\n* Simon Sapin\n* KontextWork\n* René Fritz\n* Maykin Media\n* NCC Group\n* Des images et des mots\n* Andreas Zettl\n* Nathalie Gutton\n* Tom Pohl\n* Moritz Mahringer\n* Florian Demmer\n* Yanal-Yves Fargialla\n\n\nVersion 53.2\n------------\n\nReleased on 2021-08-27.\n\nNew features:\n\n* `#1428 `_:\n Re-add the ``make_bookmark_tree()`` method\n\nBug fixes:\n\n* `#1429 `_:\n Fix package deployed on PyPI\n\nContributors:\n\n* Guillaume Ayoub\n\nBackers and sponsors:\n\n* Grip Angebotssoftware\n* PDF Blocks\n* SimonSoft\n* Menutech\n* Manuel Barkhau\n* Simon Sapin\n* KontextWork\n* René Fritz\n* Maykin Media\n* NCC Group\n* Des images et des mots\n* Andreas Zettl\n* Nathalie Gutton\n* Tom Pohl\n* Moritz Mahringer\n* Florian Demmer\n* Yanal-Yves Fargialla\n\n\nVersion 53.1\n------------\n\nReleased on 2021-08-22.\n\nBug fixes:\n\n* `#1409 `_:\n Don’t crash when leaders are in floats\n* `#1414 `_:\n Embed images once\n* `#1417 `_:\n Fix crash with SVG intrinsic ratio\n\nDocumentation:\n\n* `#1422 `_:\n Include ``weasyprint.tools`` removal in documentation\n\nContributors:\n\n* Guillaume Ayoub\n\nBackers and sponsors:\n\n* Grip Angebotssoftware\n* PDF Blocks\n* SimonSoft\n* Menutech\n* Manuel Barkhau\n* Simon Sapin\n* KontextWork\n* René Fritz\n* Maykin Media\n* NCC Group\n* Des images et des mots\n* Andreas Zettl\n* Nathalie Gutton\n* Tom Pohl\n* Moritz Mahringer\n* Florian Demmer\n* Yanal-Yves Fargialla\n\n\nVersion 53.0\n------------\n\nReleased on 2021-07-31.\n\nThis version also includes the changes from unstable b1 and b2 versions listed\nbelow.\n\nDependencies:\n\n* Pango 1.44.0+ is now needed.\n* pydyf 0.0.3+ is now needed.\n* fontTools 4.0.0+ is now needed.\n* html5lib 1.0.1+ is now needed.\n\nAPI changes:\n\n* ``FontConfiguration`` is now in the ``weasyprint.text.fonts`` module.\n* ``--format`` and ``--resolution`` options have been deprecated, PDF is the\n only output format supported.\n* ``--optimize-images`` option has been deprecated and replaced by\n ``--optimize-size``, allowing ``images``, ``fonts``, ``all`` and ``none``\n values.\n* ``weasyprint.tools`` have been removed.\n* ``Document.resolve_links``, ``Document.make_bookmark_tree`` and\n ``Document.add_hyperlinks`` have been removed.\n\nPerformance:\n\n* Improve image management\n\nNew features:\n\n* `#1374 `_:\n Support basic \"clipPath\" in SVG\n\nBug fixes:\n\n* `#1369 `_:\n Render use path in SVG\n* `#1370 `_:\n Fix fill color on use path in SVG\n* `#1371 `_:\n Handle stroke-opacity and fill-opacity\n* `#1378 `_:\n Fix crash with borders whose widths are in em\n* `#1394 `_:\n Fix crash on draw_pattern\n* `#880 `_:\n Handle stacking contexts put in contexts by previous generations\n* `#1386 `_:\n Catch font subsetting errors\n* `#1403 `_:\n Fix how x and y attributes are handled in SVG\n* `#1399 `_,\n `#1401 `_:\n Don’t crash when use tags reference non-existing element\n* `#1393 `_:\n Handle font collections\n* `#1408 `_:\n Handle x and y attributes in use tags\n\nDocumentation:\n\n* `#1391 `_,\n `#1405 `_:\n Add documentation for installation\n\nContributors:\n\n* Guillaume Ayoub\n* Lucie Anglade\n* Pelle Bo Regener\n* aschmitz\n* John Jackson\n* Felix Schwarz\n* Syrus Dark\n* Christoph Päper\n\nBackers and sponsors:\n\n* OpenEdition\n* Grip Angebotssoftware\n* Simonsoft\n* PDF Blocks\n* Menutech\n* Manuel Barkhau\n* print-css.rocks\n* Simon Sapin\n* KontextWork\n* René Fritz\n* Maykin Media\n* Nathalie Gutton\n* Andreas Zettl\n* Tom Pohl\n* NCC Group\n* Moritz Mahringer\n* Florian Demmer\n* Des images et des mots\n* Mohammed Y. Alnajdi\n* Yanal-Yves Fargialla\n* Yevhenii Hyzyla\n\n\nVersion 53.0b2\n--------------\n\nReleased on 2021-05-30.\n\n**This version is experimental, don't use it in production. If you find bugs,\nplease report them!**\n\nNew features:\n\n* `#359 `_:\n Embed full sets of fonts in PDF\n\nBug fixes:\n\n* `#1345 `_:\n Fix position of SVG use tags\n* `#1346 `_:\n Handle \"stroke-dasharray: none\"\n* `#1352 `_,\n `#1358 `_:\n Sort link target identifiers\n* `#1357 `_:\n Fix font information\n* `#1362 `_:\n Handle visibility and display properties in SVG\n* `#1365 `_:\n Cascade inherited attributes for use tags\n* `#1366 `_:\n Correctly handle style attributes in SVG\n* `#1367 `_:\n Include line stroke in box bounding\n\nDocumentation:\n\n* `#1341 `_:\n Fix typos\n\nContributors:\n\n* Guillaume Ayoub\n* aschmitz\n* John Jackson\n* Lucie Anglade\n* Pelle Bo Regener\n\nBackers and sponsors:\n\n* OpenEdition\n* print-css.rocks\n* Simonsoft\n* PDF Blocks\n* Menutech\n* Manuel Barkhau\n* Simon Sapin\n* Grip Angebotssoftware\n* KontextWork\n* René Fritz\n* Nathalie Gutton\n* Andreas Zettl\n* Tom Pohl\n* Maykin Media\n* Moritz Mahringer\n* Florian Demmer\n* Mohammed Y. Alnajdi\n* NCC Group\n* Des images et des mots\n* Yanal-Yves Fargialla\n* Yevhenii Hyzyla\n\n\nVersion 53.0b1\n--------------\n\nReleased on 2021-04-22.\n\n**This version is experimental, don't use it in production. If you find bugs,\nplease report them!**\n\nDependencies:\n\n* This version uses its own PDF generator instead of Cairo. Rendering may be\n different for text, gradients, SVG images…\n* Packaging is now done with Flit.\n\nNew features:\n\n* `#1328 `_:\n Add ISO and JIS paper sizes\n* `#1309 `_:\n Leader support, with financial support from Simonsoft\n\nBug fixes:\n\n* `#504 `_:\n Fix rendering bugs with PDF gradients\n* `#606 `_:\n Fix rounding errors on PDF dimensions\n* `#1264 `_:\n Include witdh/height when calculating auto margins of absolute boxes\n* `#1191 `_:\n Don’t try to get an earlier page break between columns\n* `#1235 `_:\n Include padding, border, padding when calculating inline-block width\n* `#1199 `_:\n Fix kerning issues with small fonts\n\nDocumentation:\n\n* `#1298 `_:\n Rewrite documentation\n\nContributors:\n\n* Guillaume Ayoub\n* Lucie Anglade\n* Felix Schwarz\n* Syrus Dark\n* Christoph Päper\n\nBackers and sponsors:\n\n* Simonsoft\n* PDF Blocks\n* Menutech\n* Manuel Barkhau\n* Simon Sapin\n* Nathalie Gutton\n* Andreas Zettl\n* René Fritz\n* Tom Pohl\n* KontextWork\n* Moritz Mahringer\n* Florian Demmer\n* Maykin Media\n* Yanal-Yves Fargialla\n* Des images et des mots\n* Yevhenii Hyzyla\n\n\nVersion 52.5\n------------\n\nReleased on 2021-04-17.\n\nBug fixes:\n\n* `#1336 `_:\n Fix text breaking exception\n* `#1318 `_:\n Fix @font-face rules with Pango 1.48.3+\n\nContributors:\n\n* Guillaume Ayoub\n\nBackers and sponsors:\n\n* Simonsoft\n* PDF Blocks\n* Menutech\n* Manuel Barkhau\n* Simon Sapin\n* Nathalie Gutton\n* Andreas Zettl\n* René Fritz\n* Tom Pohl\n* KontextWork\n* Moritz Mahringer\n* Florian Demmer\n* Maykin Media\n* Yanal-Yves Fargialla\n* Des images et des mots\n* Yevhenii Hyzyla\n\n\nVersion 52.4\n------------\n\nReleased on 2021-03-11.\n\nBug fixes:\n\n* `#1304 `_:\n Don’t try to draw SVG files with no size\n* `ece5f066 `_:\n Avoid crash on last word detection\n* `4ee42e48 `_:\n Remove last word before ellipses when hyphenated\n\nContributors:\n\n* Guillaume Ayoub\n\nBackers and sponsors:\n\n* PDF Blocks\n* Simonsoft\n* Menutech\n* Simon Sapin\n* Manuel Barkhau\n* Andreas Zettl\n* Nathalie Gutton\n* Tom Pohl\n* René Fritz\n* Moritz Mahringer\n* Florian Demmer\n* KontextWork\n* Michele Mostarda\n\n\nVersion 52.3\n------------\n\nReleased on 2021-03-02.\n\nBug fixes:\n\n* `#1299 `_:\n Fix imports with url() and quotes\n\nNew features:\n\n* `#1300 `_:\n Add support of line-clamp, with financial support from\n expert Germany\n\nContributors:\n\n* Guillaume Ayoub\n* Lucie Anglade\n\nBackers and sponsors:\n\n* PDF Blocks\n* Simonsoft\n* Menutech\n* Simon Sapin\n* Manuel Barkhau\n* Andreas Zettl\n* Nathalie Gutton\n* Tom Pohl\n* Moritz Mahringer\n* Florian Demmer\n* KontextWork\n* Michele Mostarda\n\n\nVersion 52.2\n------------\n\nReleased on 2020-12-06.\n\nBug fixes:\n\n* `238e214 `_:\n Fix URL handling with tinycss2\n* `#1248 `_:\n Include missing test data\n* `#1254 `_:\n Top margins removed from children when tables are displayed on multiple pages\n* `#1250 `_:\n Correctly draw borders on the last line of split tables\n* `a6f9c80 `_:\n Add a nice gif to please gdk-pixbuf 2.42.0\n\nContributors:\n\n* Guillaume Ayoub\n* Lucie Anglade\n* Felix Schwarz\n\nBackers and sponsors:\n\n* PDF Blocks\n* Simonsoft\n* Menutech\n* Simon Sapin\n* Nathalie Gutton\n* Andreas Zetti\n* Tom Pohl\n* Florian Demmer\n* Moritz Mahringer\n\n\nVersion 52.1\n------------\n\nReleased on 2020-11-02.\n\nBug fixes:\n\n* `238e214 `_:\n Fix URL handling with tinycss2\n\nContributors:\n\n* Guillaume Ayoub\n\nBackers and sponsors:\n\n* Simonsoft\n* Simon Sapin\n* Nathalie Gutton\n* Andreas Zettl\n* Florian Demmer\n* Moritz Mahringer\n\n\nVersion 52\n----------\n\nReleased on 2020-10-29.\n\nDependencies:\n\n* Python 3.6+ is now needed, Python 3.5 is not supported anymore\n* WeasyPrint now depends on Pillow\n\nNew features:\n\n* `#1019 `_:\n Implement ``counter-set``\n* `#1080 `_:\n Don’t display ``template`` tags\n* `#1210 `_:\n Use ``download`` attribute in ``a`` tags for attachment's filename\n* `#1206 `_:\n Handle strings in ``list-style-type``\n* `#1165 `_:\n Add support for concatenating ``var()`` functions in ``content`` declarations\n* `c56b96b `_:\n Add an option to optimize embedded images size, with financial support from\n Hashbang\n* `#969 `_:\n Add an image cache that can be shared between documents, with financial\n support from Hashbang\n\nBug fixes:\n\n* `#1141 `_:\n Don’t clip page margins on account of ``body`` overflow\n* `#1000 `_:\n Don’t apply ``text-indent`` twice on inline blocks\n* `#1051 `_:\n Avoid random line breaks\n* `#1120 `_:\n Gather target counters in page margins\n* `#1110 `_:\n Handle most cases for boxes avoiding floats in rtl containers, with financial\n support from Innovative Software\n* `#1111 `_:\n Fix horizontal position of last rtl line, with financial support from\n Innovative Software\n* `#1114 `_:\n Fix bug with transparent borders in tables\n* `#1146 `_:\n Don’t gather bookmarks twice for blocks that are displayed on two pages\n* `#1237 `_:\n Use fallback fonts on unsupported WOFF2 and WOFF fonts\n* `#1025 `_:\n Don’t insert the same layout attributes multiple times\n* `#1027 `_:\n Don’t try to break tables after the header or before the footer\n* `#1050 `_:\n Don’t crash on absolute SVG files with no intrinsic size\n* `#1204 `_:\n Fix a crash with a flexbox corner case\n* `#1030 `_:\n Fix frozen builds\n* `#1089 `_:\n Fix Pyinstaller builds\n* `#1216 `_:\n Fix embedded files\n* `#1225 `_:\n Initial support of RTL direction in flexbox layout\n\nDocumentation:\n\n* `#1149 `_:\n Add the ``--quiet`` CLI option in the documentation\n* `#1061 `_:\n Update install instructions on Windows\n\nTests:\n\n* `#1209 `_:\n Use GitHub Actions instead of Travis\n\nContributors:\n\n* Guillaume Ayoub\n* Lucie Anglade\n* Tontyna\n* Mohammed Y. Alnajdi\n* Mike Voets\n* Bjarni Þórisson\n* Balázs Dukai\n* Bart Broere\n* Endalkachew\n* Felix Schwarz\n* Julien Sanchez\n* Konstantin Alekseev\n* Nicolas Hart\n* Nikolaus Schlemm\n* Thomas J. Lampoltshammer\n* mPyth\n* nempoBu4\n* saddy001\n\nBackers and sponsors:\n\n* Hashbang\n* Innovative Software\n* Screenbreak\n* Simon Sapin\n* Lisa Warshaw\n* Nathalie Gutton\n* Andreas Zettl\n* Florian Demmer\n* Moritz Mahringer\n\n\nVersion 51\n----------\n\nReleased on 2019-12-23.\n\nDependencies:\n\n* Pyphen 0.9.1+ is now needed\n\nNew features:\n\n* `#882 `_:\n Add support of ``element()`` and ``running()``\n* `#972 `_:\n Add HTML element to Box class\n* `7a4d6f8 `_:\n Support ``larger`` and ``smaller`` values for ``font-size``\n\nBug fixes:\n\n* `#960 `_:\n Fix how fonts used for macOS tests are installed\n* `#956 `_:\n Fix various crashes due to line breaking bugs\n* `#983 `_:\n Fix typo in variable name\n* `#975 `_:\n Don’t crash when ``string-set`` is set to ``none``\n* `#998 `_:\n Keep font attributes when text lines are modified\n* `#1005 `_:\n Don’t let presentational hints add decorations on tables with no borders\n* `#974 `_:\n Don’t crash on improper ``var()`` values\n* `#1012 `_:\n Fix rendering of header and footer for empty tables\n* `#1013 `_:\n Avoid quadratic time relative to tree depth when setting page names\n\nContributors:\n\n- Lucie Anglade\n- Guillaume Ayoub\n- Guillermo Bonvehí\n- Holger Brunn\n- Felix Schwarz\n- Tontyna\n\n\nVersion 50\n----------\n\nReleased on 2019-09-19.\n\nNew features:\n\n* `#209 `_:\n Make ``break-*`` properties work inside tables\n* `#661 `_:\n Make blocks with ``overflow: auto`` grow to include floating children\n\nBug fixes:\n\n* `#945 `_:\n Don't break pages between a list item and its marker\n* `#727 `_:\n Avoid tables lost between pages\n* `#831 `_:\n Ignore auto margins on flex containers\n* `#923 `_:\n Fix a couple of crashes when splitting a line twice\n* `#896 `_:\n Fix skip stack order when using a reverse flex direction\n\nContributors:\n\n- Lucie Anglade\n- Guillaume Ayoub\n\n\nVersion 49\n----------\n\nReleased on 2019-09-11.\n\nPerformance:\n\n* Speed and memory use have been largely improved.\n\nNew features:\n\n* `#700 `_:\n Handle ``::marker`` pseudo-selector\n* `135dc06c `_:\n Handle ``recto`` and ``verso`` parameters for page breaks\n* `#907 `_:\n Provide a clean way to build layout contexts\n\nBug fixes:\n\n* `#937 `_:\n Fix rendering of tables with empty lines and rowspans\n* `#897 `_:\n Don't crash when small columns are wrapped in absolute blocks\n* `#913 `_:\n Fix a test about gradient colors\n* `#924 `_:\n Fix title for document with attachments\n* `#917 `_:\n Fix tests with Pango 1.44\n* `#919 `_:\n Fix padding and margin management for column flex boxes\n* `#901 `_:\n Fix width of replaced boxes with no intrinsic width\n* `#906 `_:\n Don't respect table cell width when content doesn't fit\n* `#927 `_:\n Don't use deprecated ``logger.warn`` anymore\n* `a8662794 `_:\n Fix margin collapsing between caption and table wrapper\n* `87d9e84f `_:\n Avoid infinite loops when rendering columns\n* `789b80e6 `_:\n Only use in flow children to set columns height\n* `615e298a `_:\n Don't include floating elements each time we try to render a column\n* `48d8632e `_:\n Avoid not in flow children to compute column height\n* `e7c452ce `_:\n Fix collapsing margins for columns\n* `fb0887cf `_:\n Fix crash when using currentColor in gradients\n* `f66df067 `_:\n Don't crash when using ex units in word-spacing in letter-spacing\n* `c790ff20 `_:\n Don't crash when properties needing base URL use var functions\n* `d63eac31 `_:\n Don't crash with object-fit: non images with no intrinsic size\n\nDocumentation:\n\n* `#900 `_:\n Add documentation about semantic versioning\n* `#692 `_:\n Add a snippet about PDF magnification\n* `#899 `_:\n Add .NET wrapper link\n* `#893 `_:\n Fixed wrong nested list comprehension example\n* `#902 `_:\n Add ``state`` to the ``make_bookmark_tree`` documentation\n* `#921 `_:\n Fix typos in the documentation\n* `#328 `_:\n Add CSS sample for forms\n\nContributors:\n\n- Lucie Anglade\n- Guillaume Ayoub\n- Raphael Gaschignard\n- Stani\n- Szmen\n- Thomas Dexter\n- Tontyna\n\n\nVersion 48\n----------\n\nReleased on 2019-07-08.\n\nDependencies:\n\n* CairoSVG 2.4.0+ is now needed\n\nNew features:\n\n* `#891 `_:\n Handle ``text-overflow``\n* `#878 `_:\n Handle ``column-span``\n* `#855 `_:\n Handle all the ``text-decoration`` features\n* `#238 `_:\n Don't repeat background images when it's not needed\n* `#875 `_:\n Handle ``object-fit`` and ``object-position``\n* `#870 `_:\n Handle ``bookmark-state``\n\nBug fixes:\n\n* `#686 `_:\n Fix column balance when children are not inline\n* `#885 `_:\n Actually use the content box to resolve flex items percentages\n* `#867 `_:\n Fix rendering of KaTeX output, including (1) set row baseline of tables when\n no cells are baseline-aligned, (2) set baseline for inline tables, (3) don't\n align lines larger than their parents, (4) force CairoSVG to respect image\n size defined by CSS.\n* `#873 `_:\n Set a minimum height for empty list elements with outside marker\n* `#811 `_:\n Don't use translations to align flex items\n* `#851 `_,\n `#860 `_:\n Don't cut pages when content overflows a very little bit\n* `#862 `_:\n Don't crash when using UTC dates in metadata\n\nDocumentation:\n\n* `#854 `_:\n Add a \"Tips & Tricks\" section\n\nContributors:\n\n- Gabriel Corona\n- Guillaume Ayoub\n- Manuel Barkhau\n- Nathan de Maestri\n- Lucie Anglade\n- theopeek\n\n\nVersion 47\n----------\n\nReleased on 2019-04-12.\n\nNew features:\n\n* `#843 `_:\n Handle CSS variables\n* `#846 `_:\n Handle ``:nth()`` page selector\n* `#847 `_:\n Allow users to use a custom SSL context for HTTP requests\n\nBug fixes:\n\n* `#797 `_:\n Fix underlined justified text\n* `#836 `_:\n Fix crash when flex items are replaced boxes\n* `#835 `_:\n Fix ``margin-break: auto``\n\n\nVersion 46\n----------\n\nReleased on 2019-03-20.\n\nNew features:\n\n* `#771 `_:\n Handle ``box-decoration-break``\n* `#115 `_:\n Handle ``margin-break``\n* `#821 `_:\n Continuous integration includes tests on Windows\n\nBug fixes:\n\n* `#765 `_,\n `#754 `_,\n `#800 `_:\n Fix many crashes related to the flex layout\n* `#783 `_:\n Fix a couple of crashes with strange texts\n* `#827 `_:\n Named strings and counters are case-sensitive\n* `#823 `_:\n Shrink min/max-height/width according to box-sizing\n* `#728 `_,\n `#171 `_:\n Don't crash when fixed boxes are nested\n* `#610 `_,\n `#828 `_:\n Don't crash when preformatted text lines end with a space\n* `#808 `_,\n `#387 `_:\n Fix position of some images\n* `#813 `_:\n Don't crash when long preformatted text lines end with ``\\n``\n\nDocumentation:\n\n* `#815 `_:\n Add documentation about custom ``url_fetcher``\n\n\nVersion 45\n----------\n\nReleased on 2019-02-20.\n\nWeasyPrint now has a `code of conduct\n`_.\n\nA new website has been launched, with beautiful and useful graphs about speed\nand memory use across versions: check `WeasyPerf\n`_.\n\nDependencies:\n\n* Python 3.5+ is now needed, Python 3.4 is not supported anymore\n\nBug fixes:\n\n* `#798 `_:\n Prevent endless loop and index out of range in pagination\n* `#767 `_:\n Add a ``--quiet`` CLI parameter\n* `#784 `_:\n Fix library loading on Alpine\n* `#791 `_:\n Use path2url in tests for Windows\n* `#789 `_:\n Add LICENSE file to distributed sources\n* `#788 `_:\n Fix pending references\n* `#780 `_:\n Don't draw patterns for empty page backgrounds\n* `#774 `_:\n Don't crash when links include quotes\n* `#637 `_:\n Fix a problem with justified text\n* `#763 `_:\n Launch tests with Python 3.7\n* `#704 `_:\n Fix a corner case with tables\n* `#804 `_:\n Don't logger handlers defined before importing WeasyPrint\n* `#109 `_,\n `#748 `_:\n Don't include punctuation for hyphenation\n* `#770 `_:\n Don't crash when people use uppercase words from old-fashioned Microsoft\n fonts in tables, especially when there's an 5th column\n* Use a `separate logger\n `_ to\n report the rendering process\n* Add a ``--debug`` CLI parameter and set debug level for unknown prefixed CSS\n properties\n* Define minimal versions of Python and setuptools in setup.cfg\n\nDocumentation:\n\n* `#796 `_:\n Fix a small typo in the tutorial\n* `#792 `_:\n Document no alignment character support\n* `#773 `_:\n Fix phrasing in Hacking section\n* `#402 `_:\n Add a paragraph about fontconfig error\n* `#764 `_:\n Fix list of dependencies for Alpine\n* Fix API documentation of HTML and CSS classes\n\n\nVersion 44\n----------\n\nReleased on 2018-12-29.\n\nBug fixes:\n\n* `#742 `_:\n Don't crash during PDF generation when locale uses commas as decimal separator\n* `#746 `_:\n Close file when reading VERSION\n* Improve speed and memory usage for long texts.\n\nDocumentation:\n\n* `#733 `_:\n Small documentation fixes\n* `#735 `_:\n Fix broken links in NEWS.rst\n\n\nVersion 43\n----------\n\nReleased on 2018-11-09.\n\nBug fixes:\n\n* `#726 `_:\n Make empty strings clear previous values of named strings\n* `#729 `_:\n Include tools in packaging\n\nThis version also includes the changes from unstable rc1 and rc2 versions\nlisted below.\n\n\nVersion 43rc2\n-------------\n\nReleased on 2018-11-02.\n\n**This version is experimental, don't use it in production. If you find bugs,\nplease report them!**\n\nBug fixes:\n\n* `#706 `_:\n Fix text-indent at the beginning of a page\n* `#687 `_:\n Allow query strings in file:// URIs\n* `#720 `_:\n Optimize minimum size calculation of long inline elements\n* `#717 `_:\n Display
tags as blocks\n* `#691 `_:\n Don't recalculate max content widths when distributing extra space for tables\n* `#722 `_:\n Fix bookmarks and strings set on images\n* `#723 `_:\n Warn users when string() is not used in page margin\n\n\nVersion 43rc1\n-------------\n\nReleased on 2018-10-15.\n\n**This version is experimental, don't use it in production. If you find bugs,\nplease report them!**\n\nDependencies:\n\n* Python 3.4+ is now needed, Python 2.x is not supported anymore\n* Cairo 1.15.4+ is now needed, but 1.10+ should work with missing features\n (such as links, outlines and metadata)\n* Pdfrw is not needed anymore\n\nNew features:\n\n* `Beautiful website `_\n* `#579 `_:\n Initial support of flexbox\n* `#592 `_:\n Support @font-face on Windows\n* `#306 `_:\n Add a timeout parameter to the URL fetcher functions\n* `#594 `_:\n Split tests using modern pytest features\n* `#599 `_:\n Make tests pass on Windows\n* `#604 `_:\n Handle target counters and target texts\n* `#631 `_:\n Enable counter-increment and counter-reset in page context\n* `#622 `_:\n Allow pathlib.Path objects for HTML, CSS and Attachment classes\n* `#674 `_:\n Add extensive installation instructions for Windows\n\nBug fixes:\n\n* `#558 `_:\n Fix attachments\n* `#565 `_,\n `#596 `_,\n `#539 `_:\n Fix many PDF rendering, printing and compatibility problems\n* `#614 `_:\n Avoid crashes and endless loops caused by a Pango bug\n* `#662 `_:\n Fix warnings and errors when generating documentation\n* `#666 `_,\n `#685 `_:\n Fix many table layout rendering problems\n* `#680 `_:\n Don't crash when there's no font available\n* `#662 `_:\n Fix support of some align values in tables\n\n\nVersion 0.42.3\n--------------\n\nReleased on 2018-03-27.\n\nBug fixes:\n\n* `#583 `_:\n Fix floating-point number error to fix floating box layout\n* `#586 `_:\n Don't optimize resume_at when splitting lines with trailing spaces\n* `#582 `_:\n Fix table layout with no overflow\n* `#580 `_:\n Fix inline box breaking function\n* `#576 `_:\n Split replaced_min_content_width and replaced_max_content_width\n* `#574 `_:\n Respect text direction and don't translate rtl columns twice\n* `#569 `_:\n Get only first line's width of inline children to get linebox width\n\n\nVersion 0.42.2\n--------------\n\nReleased on 2018-02-04.\n\nBug fixes:\n\n* `#560 `_:\n Fix a couple of crashes and endless loops when breaking lines.\n\n\nVersion 0.42.1\n--------------\n\nReleased on 2018-02-01.\n\nBug fixes:\n\n* `#566 `_:\n Don't crash when using @font-config.\n* `#567 `_:\n Fix text-indent with text-align: justify.\n* `#465 `_:\n Fix string(\\*, start).\n* `#562 `_:\n Handle named pages with pseudo-class.\n* `#507 `_:\n Fix running headers.\n* `#557 `_:\n Avoid infinite loops in inline_line_width.\n* `#555 `_:\n Fix margins, borders and padding in column layouts.\n\n\nVersion 0.42\n------------\n\nReleased on 2017-12-26.\n\nWeasyPrint is not tested with (end-of-life) Python 3.3 anymore.\n\n**This release is probably the last version of the 0.x series.**\n\nNext version may include big changes:\n\n- end of Python 2.7 support,\n- initial support of bidirectional text,\n- initial support of flexbox,\n- improvements for speed and memory usage.\n\nNew features:\n\n* `#532 `_:\n Support relative file URIs when using CLI.\n\nBug fixes:\n\n* `#553 `_:\n Fix slow performance for pre-formatted boxes with a lot of children.\n* `#409 `_:\n Don't crash when rendering some tables.\n* `#39 `_:\n Fix rendering of floats in inlines.\n* `#301 `_:\n Split lines carefully.\n* `#530 `_:\n Fix root when frozen with Pyinstaller.\n* `#534 `_:\n Handle SVGs containing images embedded as data URIs.\n* `#360 `_:\n Fix border-radius rendering problem with some PDF readers.\n* `#525 `_:\n Fix pipenv support.\n* `#227 `_:\n Smartly handle replaced boxes with percentage width in auto-width parents.\n* `#520 `_:\n Don't ignore CSS @page rules that are imported by an @import rule.\n\n\nVersion 0.41\n------------\n\nReleased on 2017-10-05.\n\nWeasyPrint now depends on pdfrw >= 0.4.\n\nNew features:\n\n* `#471 `_:\n Support page marks and bleed.\n\nBug fixes:\n\n* `#513 `_:\n Don't crash on unsupported image-resolution values.\n* `#506 `_:\n Fix @font-face use with write_* methods.\n* `#500 `_:\n Improve readability of _select_source function.\n* `#498 `_:\n Use CSS prefixes as recommended by the CSSWG.\n* `#441 `_:\n Fix rendering problems and crashes when using @font-face.\n* `bb3a4db `_:\n Try to break pages after a block before trying to break inside it.\n* `1d1654c `_:\n Fix and test corner cases about named pages.\n\nDocumentation:\n\n* `#508 `_:\n Add missing libpangocairo dependency for Debian and Ubuntu.\n* `a7b17fb `_:\n Add documentation on logged rendering steps.\n\n\nVersion 0.40\n------------\n\nReleased on 2017-08-17.\n\nWeasyPrint now depends on cssselect2 instead of cssselect and lxml.\n\nNew features:\n\n* `#57 `_:\n Named pages.\n* Unprefix properties, see\n `#498 `_.\n* Add a \"verbose\" option logging the document generation steps.\n\nBug fixes:\n\n* `#483 `_:\n Fix slow performance with long pre-formatted texts.\n* `#70 `_:\n Improve speed and memory usage for long documents.\n* `#487 `_:\n Don't crash on local() fonts with a space and no quotes.\n\n\nVersion 0.39\n------------\n\nReleased on 2017-06-24.\n\nBug fixes:\n\n* Fix the use of WeasyPrint's URL fetcher with CairoSVG.\n\n\nVersion 0.38\n------------\n\nReleased on 2017-06-16.\n\nBug fixes:\n\n* `#477 `_:\n Don't crash on font-face's src attributes with local functions.\n\n\nVersion 0.37\n------------\n\nReleased on 2017-06-15.\n\nWeasyPrint now depends on tinycss2 instead of tinycss.\n\nNew features:\n\n* `#437 `_:\n Support local links in generated PDFs.\n\nBug fixes:\n\n* `#412 `_:\n Use a NullHandler log handler when WeasyPrint is used as a library.\n* `#417 `_,\n `#472 `_:\n Don't crash on some line breaks.\n* `#327 `_:\n Don't crash with replaced elements with height set in percentages.\n* `#467 `_:\n Remove incorrect line breaks.\n* `#446 `_:\n Let the logging module do the string interpolation.\n\n\nVersion 0.36\n------------\n\nReleased on 2017-02-25.\n\nNew features:\n\n* `#407 `_:\n Handle ::first-letter.\n* `#423 `_:\n Warn user about broken cairo versions.\n\nBug fixes:\n\n* `#411 `_:\n Typos fixed in command-line help.\n\n\nVersion 0.35\n------------\n\nReleased on 2017-02-25.\n\nBug fixes:\n\n* `#410 `_:\n Fix AssertionError in split_text_box.\n\n\nVersion 0.34\n------------\n\nReleased on 2016-12-21.\n\nBug fixes:\n\n* `#398 `_:\n Honor the presentational_hints option for PDFs.\n* `#399 `_:\n Avoid CairoSVG-2.0.0rc* on Python 2.\n* `#396 `_:\n Correctly close files open by mkstemp.\n* `#403 `_:\n Cast the number of columns into int.\n* Fix multi-page multi-columns and add related tests.\n\n\nVersion 0.33\n------------\n\nReleased on 2016-11-28.\n\nNew features:\n\n* `#393 `_:\n Add tests on MacOS.\n* `#370 `_:\n Enable @font-face on MacOS.\n\nBug fixes:\n\n* `#389 `_:\n Always update resume_at when splitting lines.\n* `#394 `_:\n Don't build universal wheels.\n* `#388 `_:\n Fix logic when finishing block formatting context.\n\n\nVersion 0.32\n------------\n\nReleased on 2016-11-17.\n\nNew features:\n\n* `#28 `_:\n Support @font-face on Linux.\n* Support CSS fonts level 3 almost entirely, including OpenType features.\n* `#253 `_:\n Support presentational hints (optional).\n* Support break-after, break-before and break-inside for pages and columns.\n* `#384 `_:\n Major performance boost.\n\nBux fixes:\n\n* `#368 `_:\n Respect white-space for shrink-to-fit.\n* `#382 `_:\n Fix the preferred width for column groups.\n* Handle relative boxes in column-layout boxes.\n\nDocumentation:\n\n* Add more and more documentation about Windows installation.\n* `#355 `_:\n Add fonts requirements for tests.\n\n\nVersion 0.31\n------------\n\nReleased on 2016-08-28.\n\nNew features:\n\n* `#124 `_:\n Add MIME sniffing for images.\n* `#60 `_:\n CSS Multi-column Layout.\n* `#197 `_:\n Add hyphens at line breaks activated by a soft hyphen.\n\nBux fixes:\n\n* `#132 `_:\n Fix Python 3 compatibility on Windows.\n\nDocumentation:\n\n* `#329 `_:\n Add documentation about installation on Windows.\n\n\nVersion 0.30\n------------\n\nReleased on 2016-07-18.\n\nWeasyPrint now depends on html5lib-0.999999999.\n\nBux fixes:\n\n* Fix Acid2\n* `#325 `_:\n Cutting lines is broken in page margin boxes.\n* `#334 `_:\n Newest html5lib 0.999999999 breaks rendering.\n\n\nVersion 0.29\n------------\n\nReleased on 2016-06-17.\n\nBug fixes:\n\n* `#263 `_:\n Don't crash with floats with percents in positions.\n* `#323 `_:\n Fix CairoSVG 2.0 pre-release dependency in Python 2.x.\n\n\nVersion 0.28\n------------\n\nReleased on 2016-05-16.\n\nBug fixes:\n\n* `#189 `_:\n ``white-space: nowrap`` still wraps on hyphens\n* `#305 `_:\n Fix crashes on some tables\n* Don't crash when transform matrix isn't invertible\n* Don't crash when rendering ratio-only SVG images\n* Fix margins and borders on some tables\n\n\nVersion 0.27\n------------\n\nReleased on 2016-04-08.\n\nNew features:\n\n* `#295 `_:\n Support the 'rem' unit.\n* `#299 `_:\n Enhance the support of SVG images.\n\nBug fixes:\n\n* `#307 `_:\n Fix the layout of cells larger than their tables.\n\nDocumentation:\n\n* The website is now on GitHub Pages, the documentation is on Read the Docs.\n* `#297 `_:\n Rewrite the CSS chapter of the documentation.\n\n\nVersion 0.26\n------------\n\nReleased on 2016-01-29.\n\nNew features:\n\n* Support the `empty-cells` attribute.\n* Respect table, column and cell widths.\n\nBug fixes:\n\n* `#172 `_:\n Unable to set table column width on tables td's.\n* `#151 `_:\n Table background colour bleeds beyond table cell boundaries.\n* `#260 `_:\n TypeError: unsupported operand type(s) for +: 'float' and 'str'.\n* `#288 `_:\n Unwanted line-breaks in bold text.\n* `#286 `_:\n AttributeError: 'Namespace' object has no attribute 'attachments'.\n\n\nVersion 0.25\n------------\n\nReleased on 2015-12-17.\n\nNew features:\n\n* Support the 'q' unit.\n\nBug fixes:\n\n* `#285 `_:\n Fix a crash happening when splitting lines.\n* `#284 `_:\n Escape parenthesis in PDF links.\n* `#280 `_:\n Replace utf8 with utf-8 for gettext/django compatibility.\n* `#269 `_:\n Add support for use when frozen.\n* `#250 `_:\n Don't crash when attachments are not available.\n\n\nVersion 0.24\n------------\n\nReleased on 2015-08-04.\n\nNew features:\n\n* `#174 `_:\n Basic support for Named strings.\n\nBug fixes:\n\n* `#207 `_:\n Draw rounded corners on replaced boxes.\n* `#224 `_:\n Rely on the font size for rounding bug workaround.\n* `#31 `_:\n Honor the vertical-align property in fixed-height cells.\n* `#202 `_:\n Remove unreachable area/border at bottom of page.\n* `#225 `_:\n Don't allow unknown units during line-height validation.\n* Fix some wrong conflict resolutions for table borders with inset\n and outset styles.\n\n\nVersion 0.23\n------------\n\nReleased on 2014-09-16.\n\nBug fixes:\n\n* `#196 `_:\n Use the default image sizing algorithm for images’s preferred size.\n* `#194 `_:\n Try more library aliases with ``dlopen()``.\n* `#201 `_:\n Consider ``page-break-after-avoid`` when pushing floats to the next page.\n* `#217 `_:\n Avoid a crash on zero-sized background images.\n\nRelease process:\n\n* Start testing on Python 3.4 on Travis-CI.\n\n\nVersion 0.22\n------------\n\nReleased on 2014-05-05.\n\nNew features:\n\n* `#86 `_:\n Support gzip and deflate encoding in HTTP responses\n* `#177 `_:\n Support for PDF attachments.\n\nBug fixes:\n\n* `#169 `_:\n Fix a crash on percentage-width columns in an auto-width table.\n* `#168 `_:\n Make ``
`` a block in the user-agent stylesheet.\n* `#175 `_:\n Fix some ``dlopen()`` library loading issues on OS X.\n* `#183 `_:\n Break to the next page before a float that would overflow the page.\n (It might still overflow if it’s bigger than the page.)\n* `#188 `_:\n Require a recent enough version of Pyphen\n\nRelease process:\n\n* Drop Python 3.1 support.\n* Set up [Travis CI](https://travis-ci.org/)\n to automatically test all pushes and pull requests.\n* Start testing on Python 3.4 locally. (Travis does not support 3.4 yet.)\n\n\nVersion 0.21\n------------\n\nReleased on 2014-01-11.\n\nNew features:\n\n* Add the `overflow-wrap `_\n property, allowing line breaks inside otherwise-unbreakable words.\n Thanks Frédérick Deslandes!\n* Add the `image-resolution\n `_ property,\n allowing images to be sized proportionally to their intrinsic size\n at a resolution other than 96 image pixels per CSS ``in``\n (ie. one image pixel per CSS ``px``)\n\nBug fixes:\n\n* `#145 `_:\n Fix parsing HTML from an HTTP URL on Python 3.x\n* `#40 `_:\n Use more general hyphenation dictionaries for specific document languages.\n (E.g. use ``hyph_fr.dic`` for ``lang=\"fr_FR\"``.)\n* `#26 `_:\n Fix ``min-width`` and ``max-width`` on floats.\n* `#100 `_:\n Fix a crash on trailing whitespace with ``font-size: 0``\n* `#82 `_:\n Borders on tables with ``border-collapse: collapse`` were sometimes\n drawn at an incorrect position.\n* `#30 `_:\n Fix positioning of images with ``position: absolute``.\n* `#118 `_:\n Fix a crash when using ``position: absolute``\n inside a ``position: relative`` element.\n* Fix ``visibility: collapse`` to behave like ``visibility: hidden``\n on elements other than table rows and table columns.\n* `#147 `_ and\n `#153 `_:\n Fix dependencies to require lxml 3.0 or a more recent version.\n Thanks gizmonerd and Thomas Grainger!\n* `#152 `_:\n Fix a crash on percentage-sized table cells in auto-sized tables.\n Thanks Johannes Duschl!\n\n\nVersion 0.20.2\n--------------\n\nReleased on 2013-12-18.\n\n* Fix `#146 `_: don't crash\n when drawing really small boxes with dotted/dashed borders\n\n\nVersion 0.20.1\n--------------\n\nReleased on 2013-12-16.\n\n* Depend on html5lib >= 0.99 instead of 1.0b3 to fix pip 1.4 support.\n* Fix `#74 `_: don't crash on\n space followed by dot at line break.\n* Fix `#78 `_: nicer colors for\n border-style: ridge/groove/inset/outset.\n\n\nVersion 0.20\n------------\n\nReleased on 2013-12-14.\n\n* Add support for ``border-radius``.\n* Feature `#77 `_: Add PDF\n metadata from HTML.\n* Feature `#12 `_: Use html5lib.\n* Tables: handle percentages for column groups, columns and cells, and values\n for row height.\n* Bug fixes:\n\n * Fix `#84 `_: don't crash when\n stylesheets are not available.\n * Fix `#101 `_: use page ids\n instead of page numbers in PDF bookmarks.\n * Use ``logger.warning`` instead of deprecated ``logger.warn``.\n * Add 'font-stretch' in the 'font' shorthand.\n\n\nVersion 0.19.2\n--------------\n\nReleased on 2013-06-18.\n\nBug fix release:\n\n* Fix `#88 `_:\n ``text-decoration: overline`` not being drawn above the text\n* Bug fix: Actually draw multiple lines when multiple values are given\n to ``text-decoration``.\n* Use the font metrics for text decoration positioning.\n* Bug fix: Don't clip the border with ``overflow: hidden``.\n* Fix `#99 `_:\n Regression: JPEG images not loading with cairo 1.8.x.\n\n\nVersion 0.19.1\n--------------\n\nReleased on 2013-04-30.\n\nBug fix release:\n\n* Fix incorrect intrinsic width calculation\n leading to unnecessary line breaks in floats, tables, etc.\n* Tweak border painting to look better\n* Fix unnecessary page break before big tables.\n* Fix table row overflowing at the bottom of the page\n when there are margins above the table.\n* Fix ``position: fixed`` to actually repeat on every page.\n* Fix `#76 `_:\n repeat ```` and ```` elements on every page,\n even with table border collapsing.\n\n\nVersion 0.19\n------------\n\nReleased on 2013-04-18.\n\n* Add support for ``linear-gradient()`` and ``radial-gradient``\n in background images.\n* Add support for the ``ex`` and ``ch`` length units.\n (``1ex`` is based on the font instead of being always ``0.5em`` as before.)\n* Add experimental support for Level 4 hyphenation properties.\n* Drop support for CFFI < 0.6 and cairocffi < 0.4.\n* Many bug fixes, including:\n\n * Fix `#54 `_:\n min/max-width/height on block-level images.\n * Fix `#71 `_:\n Crash when parsing nested functional notation.\n\n\nVersion 0.18\n------------\n\nReleased on 2013-03-30.\n\n* Add support for Level 3 backgrounds,\n including multiple background layers per element/box.\n* Forward-compatibility with (future releases of) cairocffi 0.4+ and CFFI 0.6+.\n* Bug fixes:\n\n * Avoid some unnecessary line breaks\n for elements sized based on their content (aka. “shrink-to-fit”)\n such as floats and page headers.\n * Allow page breaks between empty blocks.\n * Fix `#66 `_:\n Resolve images’ auto width from non-auto height and intrinsic ratio.\n * Fix `#21 `_:\n The ``data:`` URL scheme is case-insensitive.\n * Fix `#53 `_:\n Crash when backtracking for ``break-before/after: avoid``.\n\n\nVersion 0.17.1\n--------------\n\nReleased on 2013-03-18.\n\nBug fixes:\n\n* Fix `#41 `_:\n GObject initialization when GDK-PixBuf is not installed.\n* Fix `#42 `_:\n absolute URLs without a base URL (ie. document parsed from a string.)\n* Fix some whitespace collapsing bugs.\n* Fix absolutely-positioned elements inside inline elements.\n* Fix URL escaping of image references from CSS.\n* Fix `#49 `_:\n Division by 0 on dashed or dotted border smaller than one dot/dash.\n* Fix `#44 `_:\n bad interaction of ``page-break-before/after: avoid`` and floats.\n\n\nVersion 0.17\n------------\n\nReleased on 2013-02-27.\n\n* Added `text hyphenation`_ with the ``-weasy-hyphens`` property.\n* When a document includes JPEG images, embed them as JPEG in the PDF output.\n This often results in smaller PDF file size\n compared to the default *deflate* compression.\n* Switched to using CFFI instead of PyGTK or PyGObject-introspection.\n* Layout bug fixes:\n\n - Correctly trim whitespace at the end of lines.\n - Fix some cases with floats within inline content.\n\n.. _text hyphenation: https://weasyprint.readthedocs.io/en/latest/features.html#css-text-module-level-3-4\n\n\nVersion 0.16\n------------\n\nReleased on 2012-12-13.\n\n* Add the ``zoom`` parameter to ``HTML.write_pdf`` and\n ``Document.write_pdf() ``\n* Fix compatibility with old (and buggy) pycairo versions.\n WeasyPrint is now tested on 1.8.8 in addition to the latest.\n* Fix layout bugs related to line trailing spaces.\n\n\nVersion 0.15\n------------\n\nReleased on 2012-10-09.\n\n* Add a low-level API that enables painting pages individually on any\n cairo surface.\n* **Backward-incompatible change**: remove the ``HTML.get_png_pages``\n method. The new low-level API covers this functionality and more.\n* Add support for the ``font-stretch`` property.\n* Add support for ``@page:blank`` to select blank pages.\n* New Sphinx-based and improved docs\n* Bug fixes:\n\n - Importing Pango in some PyGTK installations.\n - Layout of inline-blocks with `vertical-align: top` or `bottom`.\n - Do not repeat a block’s margin-top or padding-top after a page break.\n - Performance problem with large tables split across many pages.\n - Anchors and hyperlinks areas now follow CSS transforms.\n Since PDF links have to be axis-aligned rectangles, the bounding box\n is used. This may be larger than expected with rotations that are\n not a multiple of 90 degrees.\n\n\nVersion 0.14\n------------\n\nReleased on 2012-08-03.\n\n* Add a public API to choose media type used for @media.\n (It still defaults to ``print``). Thanks Chung Lu!\n* Add ``--base-url`` and ``--resolution`` to the command-line API, making it\n as complete as the Python one.\n* Add support for the ```` element in HTML.\n* Add support for CSS outlines\n* Switch to gdk-pixbuf instead of Pystacia for loading raster images.\n* Bug fixes:\n\n - Handling of filenames and URLs on Windows\n - Unicode filenames with older version of py2cairo\n - ``base_url`` now behaves as expected when set to a directory name.\n - Make some tests more robust\n\n\nVersion 0.13\n------------\n\nReleased on 2012-07-23.\n\n* Add support for PyGTK, as an alternative to PyGObject + introspection.\n This should make WeasyPrint easier to run on platforms that not not have\n packages for PyGObject 3.x yet.\n* Bug fix: crash in PDF outlines for some malformed HTML documents\n\n\nVersion 0.12\n------------\n\nReleased on 2012-07-19.\n\n* Add support for collapsed borders on tables. This is currently incompatible\n with repeating header and footer row groups on each page: headers and footers\n are treated as normal row groups on table with ``border-collapse: collapse``.\n* Add ``url_fetcher`` to the public API. This enables users to hook into\n WeasyPrint for fetching linked stylesheets or images, eg. to generate them\n on the fly without going through the network.\n This enables the creation of `Flask-WeasyPrint\n `_.\n\n\nVersion 0.11\n------------\n\nReleased on 2012-07-04.\n\n* Add support for floats and clear.\n Together with various bug fixes, this enables WeasyPrint to pass the Acid2\n test! Acid2 is now part of our automated test suite.\n* Add support for the width, min-width, max-width, height, min-height and\n max-height properties in @page. The size property is now the size of the\n page’s containing block.\n* Switch the Variable Dimension rules to `the new proposal\n `_.\n The previous implementation was broken in many cases.\n* The ``image-rendering``, ``transform``, ``transform-origin`` and ``size``\n properties are now unprefixed. The prefixed form (eg. -weasy-size) is ignored\n but gives a specific warning.\n\n\nVersion 0.10\n------------\n\nReleased on 2012-06-25.\n\n* Add ``get_png_pages()`` to the public API. It returns each page as\n a separate PNG image.\n* Add a ``resolution`` parameter for PNG.\n* Add *WeasyPrint Navigator*, a web application that shows WeasyPrint’s\n output with clickable links. Yes, that’s a browser in your browser.\n Start it with ``python -m weasyprint.navigator``\n* Add support for `vertical-align: top` and `vertical-align: bottom`\n* Add support for `page-break-before: avoid` and `page-break-after: avoid`\n* Bug fixes\n\n\nVersion 0.9\n-----------\n\nReleased on 2012-06-04.\n\n* Relative, absolute and fixed positioning\n* Proper painting order (z-index)\n* In PDF: support for internal and external hyperlinks as well as bookmarks.\n* Added the ``tree`` parameter to the ``HTML`` class: accepts a parsed lxml\n object.\n* Bug fixes, including many crashes.\n\nBookmarks can be controlled by the ``-weasy-bookmark-level`` and\n``-weasy-bookmark-label`` properties, as described in `CSS Generated Content\nfor Paged Media Module `_.\n\nThe default UA stylesheet sets a matching bookmark level on all ``

``\nto ``

`` elements.\n\n\nVersion 0.8\n-----------\n\nReleased on 2012-05-07.\n\n* Switch from cssutils to tinycss_ as the CSS parser.\n* Switch to the new cssselect_, almost all level 3 selectors are supported now.\n* Support for inline blocks and inline tables\n* Automatic table layout (column widths)\n* Support for the ``min-width``, ``max-width``, ``min-height`` and\n ``max-height`` properties, except on table-related and page-related boxes.\n* Speed improvements on big stylesheets / small documents thanks to tinycss.\n* Many bug fixes\n\n.. _tinycss: https://packages.python.org/tinycss/\n.. _cssselect: https://packages.python.org/cssselect/\n\n\nVersion 0.7.1\n-------------\n\nReleased on 2012-03-21.\n\nChange the license from AGPL to BSD.\n\n\nVersion 0.7\n-----------\n\nReleased on 2012-03-21.\n\n* Support page breaks between table rows\n* Support for the ``orphans`` and ``widows`` properties.\n* Support for ``page-break-inside: avoid``\n* Bug fixes\n\nOnly avoiding page breaks before/after an element is still missing.\n\n\nVersion 0.6.1\n-------------\n\nReleased on 2012-03-01.\n\nFix a packaging bug. (Remove use_2to3 in setup.py. We use the same\ncodebase for Python 2 and 3.)\n\n\nVersion 0.6\n-----------\n\nReleased on 2012-02-29.\n\n* *Backward incompatible*: completely change the Python API. See the\n documentation:\n https://weasyprint.readthedocs.io/en/latest/tutorial.html#as-a-python-library\n* *Backward incompatible*: Proper margin collapsing.\n This changes how blocks are rendered: adjoining margins \"collapse\"\n (their maximum is used) instead of accumulating.\n* Support images in ``embed`` or ``object`` elements.\n* Switch to pystacia instead of PIL for raster images\n* Add compatibility with CPython 2.6 and 3.2. (Previously only 2.7\n was supported)\n* Many bug fixes\n\n\nVersion 0.5\n-----------\n\nReleased on 2012-02-08.\n\n* Support for the ``overflow`` and ``clip`` properties.\n* Support for the ``opacity`` property from CSS3 Colors.\n* Support for CSS 2D Transforms. These are prefixed, so you need to use\n ``-weasy-transform`` and ``-weasy-transform-origin``.\n\n\nVersion 0.4\n-----------\n\nReleased on 2012-02-07.\n\n* Support ``text-align: justify``, ``word-spacing`` and ``letter-spacing``.\n* Partial support for CSS3 Paged Media: page size and margin boxes with\n page-based counters.\n* All CSS 2.1 border styles\n* Fix SVG images with non-pixel units. Requires CairoSVG 0.3\n* Support for ``page-break-before`` and ``page-break-after``, except for\n the value ``avoid``.\n* Support for the ``background-clip``, ``background-origin`` and\n ``background-size`` from CSS3 (but still with a single background\n per element)\n* Support for the ``image-rendering`` from SVG. This one is prefixed,\n use ``-weasy-image-rendering``. It only has an effect on PNG output.\n\n\nVersion 0.3.1\n-------------\n\nReleased on 2011-12-14.\n\nCompatibility with CairoSVG 0.1.2\n\n\nVersion 0.3\n-----------\n\nReleased on 2011-12-13.\n\n* **Backward-incompatible change:** the 'size' property is now prefixed (since\n it is in an experimental specification). Use '-weasy-size' instead.\n* cssutils 0.9.8 or higher is now required.\n* Support SVG images with CairoSVG\n* Support generated content: the ``:before`` and ``:after`` pseudo-elements,\n the ``content``, ``quotes`` and ``counter-*`` properties.\n* Support ordered lists: all CSS 2.1 values of the ``list-style-type`` property.\n* New user-agent stylesheet with HTML 5 elements and automatic quotes for many\n languages. Thanks Peter Moulder!\n* Disable cssutils validation warnings, they are redundant with WeasyPrint’s.\n* Add ``--version`` to the command-line script.\n* Various bug fixes\n\n\nVersion 0.2\n-----------\n\nReleased on 2011-11-25.\n\n* Support for tables.\n* Support the `box-sizing` property from CSS 3 Basic User Interface\n* Support all values of vertical-align except top and bottom. They are\n interpreted as text-top and text-bottom.\n* Minor bug fixes\n\nTables have some limitations:\nOnly the fixed layout and separate border model are supported.\nThere are also no page break inside tables so a table higher\nthan a page will overflow.\n\n\nVersion 0.1\n-----------\n\nReleased on 2011-10-28.\n\nFirst packaged release. Supports \"simple\" CSS 2.1 pages: there is no\nsupport for floats, tables, or absolute positioning. Other than that\nmost of CSS 2.1 is supported, as well as CSS 3 Colors and Selectors.\n" }, { "path": "docs/common_use_cases.rst", "content": "Common Use Cases\n================\n\n\nInclude in Web Applications\n---------------------------\n\nUsing WeasyPrint in web applications sometimes requires attention on some\ndetails.\n\nSecurity Problems\n.................\n\nFirst of all, rendering untrusted HTML and CSS files can lead to :ref:`security\nproblems `. Please be sure to carefully follow the different proposed\nsolutions if you allow your users to modify the source of the rendered\ndocuments in any way.\n\nRights Management\n.................\n\nAnother problem is rights management: you often need to render templates that\ncan only be accessed by authenticated users, and WeasyPrint installed on the\nserver doesn’t send the same cookies as the ones sent by the users. Extensions\nsuch as Flask-WeasyPrint_ (for Flask_) or Django-WeasyPrint_ (for Django_)\nsolve this issue with a small amount of code. If you use another framework, you\ncan read these extensions and probably find an equivalent workaround.\n\n.. _Flask-Weasyprint: https://github.com/Kozea/Flask-WeasyPrint\n.. _Flask: https://flask.palletsprojects.com/\n.. _Django-WeasyPrint: https://github.com/fdemmer/django-weasyprint\n.. _Django: https://www.djangoproject.com/\n\nServer Side Requests & Self-Signed SSL Certificates\n...................................................\n\nIf your server is requesting data from itself, you may encounter a self-signed\ncertificate error, even if you have a valid certificate.\n\nYou need to add yourself as a Certificate Authority, so that your self-signed\nSSL certificates can be requested.\n\n.. code-block:: bash\n\n # If you have not yet created a certificate.\n sudo openssl req -x509 \\\n -sha256 \\\n -nodes \\\n -newkey rsa:4096 \\\n -days 365 \\\n -keyout localhost.key \\\n -out localhost.crt\n\n # Follow the prompts about your certificate and the domain name.\n openssl x509 -text -noout -in localhost.crt\n\nAdd your new self-signed SSL certificate to your nginx.conf, below the line\n``server_name 123.123.123.123;``:\n\n.. code-block:: bash\n\n ssl_certificate /etc/ssl/certs/localhost.crt;\n ssl_certificate_key /etc/ssl/private/localhost.key;\n\nThe SSL certificate will be valid when accessing your website from the\ninternet. However, images will not render when requesting files from the same\nserver.\n\nYou will need to add your new self-signed certificates as trusted:\n\n.. code-block:: bash\n\n sudo cp /etc/ssl/certs/localhost.crt /usr/local/share/ca-certificates/localhost.crt\n sudo cp /etc/ssl/private/localhost.key /usr/local/share/ca-certificates/localhost.key\n\n # Update the certificate authority trusted certificates.\n sudo update-ca-certificates\n\n # Export your newly updated Certificate Authority Bundle file.\n # If using Django, it will use the newly signed certificate authority as\n # valid and images will load properly.\n sudo tee -a /etc/environment <<< 'export REQUESTS_CA_BUNDLE=/etc/ssl/certs/ca-certificates.crt'\n\n\nAdjust Document Dimensions\n--------------------------\n\nWeasyPrint does not provide support for adjusting page size or document margins\nvia command-line flags. This is best accomplished with the CSS ``@page``\nat-rule. Consider the following example:\n\n.. code-block:: css\n\n @page {\n size: Letter; /* Change from the default size of A4 */\n margin: 3cm; /* Set margin on each page */\n }\n\nThere is much more which can be achieved with the ``@page`` at-rule,\nsuch as page numbers, headers, etc. Read more about the page_ at-rule.\n\n.. _page: https://developer.mozilla.org/en-US/docs/Web/CSS/@page\n\n\nGenerate Specialized PDFs\n-------------------------\n\nWeasyPrint can generate different PDF variants, including PDF/UA and PDF/A. The\nfeature is available by using the ``--pdf-variant`` CLI option, or the\n``pdf_variant`` Python parameter of :func:`HTML.write_pdf\n`.\n\n.. code-block:: python\n\n from weasyprint import HTML\n HTML(string=\"

document

\").write_pdf(\"document.pdf\", pdf_variant=\"pdf/a-3u\")\n\n.. code-block:: sh\n\n $ weasyprint document.html --pdf-variant=\"pdf/ua-1\" document.pdf\n\nThe different supported variants can be listed using ``weasyprint --help``.\n\nEven if WeasyPrint tries to generate valid documents, the result is not\nguaranteed: the HTML, CSS and PDF features chosen by the user must follow the\nlimitations defined by the different specifications.\n\nPDF/A (Archiving)\n.................\n\nPDF/A documents are specialized for archiving purposes. They are a simple\nsubset of PDF, with a lot of limitations: no audio, video or JavaScript,\ndefined color spaces, embedded fonts, etc.\n\nIf possible, PDF/A-3u should be preferred: it allows transparency layers that\nare forbidden in A-1, and arbitrary formats for attached files that are\nforbidden in A-2. The \"u\" part of the variant indicates that the PDF text is\navailable as Unicode.\n\nPDF/A documents include a PDF identifier, that is mainly useful to indicate\nthat a PDF is a new version of another PDF. By default, WeasyPrint generates a\nvalid PDF identifier, but you can provide your own with the\n``--pdf-identifier`` CLI option or ``pdf_identifier`` Python parameter.\n\nIf your document includes images, you must set the ``image-rendering:\ncrisp-edges`` property to avoid anti-aliasing, that is forbidden by PDF/A.\n\nPDF/UA (Universal Accessibility)\n................................\n\nPDF/UA documents are specialized for accessibility purposes. They include extra\nmetadata that define document information and content structure.\n\nThe main constraint to get valid PDF/UA documents is to use a correct HTML\nstructure, to avoid inconsistencies in the PDF structure. The HTML order is\nalso used to define the order of the PDF content.\n\nSome information is required in your HTML file, including a ```` tag,\nand a ``lang`` attribute set on the ``<html>`` tag.\n\nPDF/X (Graphics Exchange)\n.........................\n\nPDF/X documents facilitate graphics exchange and adds printing-related requirements such\nas color profiles.\n\nThe easiest way to fulfill these requirements is to use device-dependent CMYK colors and\nimages everywhere in your document. For colors, you can use the ``device-cmyk()``\nfunction:\n\n.. code-block:: css\n\n body { color: device-cmyk(0% 10% 0% 80%) }\n\nYou also have to define the output profile color to use.\n\n.. code-block:: css\n\n @color-profile device-cmyk {\n components: cyan, magenta, yellow, black;\n src: url(path/to/cmyk-profile.icc);\n }\n\nIf possible, PDF/X-4 should be preferred: it allows transparency layers that are\nforbidden by previous variants.\n\nFactur-X / ZUGFeRD (Electronic Invoices)\n........................................\n\nFactur-X / ZUGFeRD is a Franco-German standard for hybrid e-invoice, the first\nimplementation of the European Semantic Standard EN 16931. It enables users to\ninclude normalized metadata in PDF invoices, such as companies information or\ninvoice amounts, so that compatible software can automatically read this\ninformation. This standard is based on PDF/A-3b.\n\nWeasyPrint can generate Factur-X / ZUGFeRD documents. Invoice metadata must be\ngenerated by the user and included in the PDF document when rendered. Two\ndifferent metadata files are required:\n\n- the first one is RDF metadata, containing document metadata and PDF/A\n extension information;\n- the second one is Factur-X / ZUGFeRD metadata, containing invoice amounts,\n plus seller and buyer information.\n\nHere is an example of Factur-X document generation.\n\n``rdf.xml``:\n\n.. code-block:: xml\n\n <rdf:RDF\n xmlns:rdf=\"http://www.w3.org/1999/02/22-rdf-syntax-ns#\"\n xmlns:fx=\"urn:factur-x:pdfa:CrossIndustryDocument:invoice:1p0#\"\n xmlns:pdfaExtension=\"http://www.aiim.org/pdfa/ns/extension/\"\n xmlns:pdfaSchema=\"http://www.aiim.org/pdfa/ns/schema#\"\n xmlns:pdfaProperty=\"http://www.aiim.org/pdfa/ns/property#\">\n <rdf:Description rdf:about=\"\">\n <fx:ConformanceLevel>MINIMUM</fx:ConformanceLevel>\n <fx:DocumentFileName>factur-x.xml</fx:DocumentFileName>\n <fx:DocumentType>INVOICE</fx:DocumentType>\n <fx:Version>1.0</fx:Version>\n </rdf:Description>\n <rdf:Description rdf:about=\"\">\n <pdfaExtension:schemas>\n <rdf:Bag>\n <rdf:li rdf:parseType=\"Resource\">\n <pdfaSchema:schema>Factur-X PDFA Extension Schema</pdfaSchema:schema>\n <pdfaSchema:namespaceURI>urn:factur-x:pdfa:CrossIndustryDocument:invoice:1p0#</pdfaSchema:namespaceURI>\n <pdfaSchema:prefix>fx</pdfaSchema:prefix>\n <pdfaSchema:property>\n <rdf:Seq>\n <rdf:li rdf:parseType=\"Resource\">\n <pdfaProperty:name>DocumentFileName</pdfaProperty:name>\n <pdfaProperty:valueType>Text</pdfaProperty:valueType>\n <pdfaProperty:category>external</pdfaProperty:category>\n <pdfaProperty:description>name of the embedded XML invoice file</pdfaProperty:description>\n </rdf:li>\n <rdf:li rdf:parseType=\"Resource\">\n <pdfaProperty:name>DocumentType</pdfaProperty:name>\n <pdfaProperty:valueType>Text</pdfaProperty:valueType>\n <pdfaProperty:category>external</pdfaProperty:category>\n <pdfaProperty:description>INVOICE</pdfaProperty:description>\n </rdf:li>\n <rdf:li rdf:parseType=\"Resource\">\n <pdfaProperty:name>Version</pdfaProperty:name>\n <pdfaProperty:valueType>Text</pdfaProperty:valueType>\n <pdfaProperty:category>external</pdfaProperty:category>\n <pdfaProperty:description>The actual version of the Factur-X XML schema</pdfaProperty:description>\n </rdf:li>\n <rdf:li rdf:parseType=\"Resource\">\n <pdfaProperty:name>ConformanceLevel</pdfaProperty:name>\n <pdfaProperty:valueType>Text</pdfaProperty:valueType>\n <pdfaProperty:category>external</pdfaProperty:category>\n <pdfaProperty:description>The conformance level of the embedded Factur-X data</pdfaProperty:description>\n </rdf:li>\n </rdf:Seq>\n </pdfaSchema:property>\n </rdf:li>\n </rdf:Bag>\n </pdfaExtension:schemas>\n </rdf:Description>\n </rdf:RDF>\n\n``factur-x.xml``:\n\n.. code-block:: xml\n\n <rsm:CrossIndustryInvoice\n xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n xmlns:qdt=\"urn:un:unece:uncefact:data:standard:QualifiedDataType:100\"\n xmlns:udt=\"urn:un:unece:uncefact:data:standard:UnqualifiedDataType:100\"\n xmlns:rsm=\"urn:un:unece:uncefact:data:standard:CrossIndustryInvoice:100\"\n xmlns:ram=\"urn:un:unece:uncefact:data:standard:ReusableAggregateBusinessInformationEntity:100\">\n <rsm:ExchangedDocumentContext>\n <ram:BusinessProcessSpecifiedDocumentContextParameter>\n <ram:ID>A1</ram:ID>\n </ram:BusinessProcessSpecifiedDocumentContextParameter>\n <ram:GuidelineSpecifiedDocumentContextParameter>\n <ram:ID>urn:factur-x.eu:1p0:minimum</ram:ID>\n </ram:GuidelineSpecifiedDocumentContextParameter>\n </rsm:ExchangedDocumentContext>\n <rsm:ExchangedDocument>\n <ram:ID>123</ram:ID>\n <ram:TypeCode>380</ram:TypeCode>\n <ram:IssueDateTime>\n <udt:DateTimeString format=\"102\">20200131</udt:DateTimeString>\n </ram:IssueDateTime>\n </rsm:ExchangedDocument>\n <rsm:SupplyChainTradeTransaction>\n <ram:ApplicableHeaderTradeAgreement>\n <ram:BuyerReference>Buyer</ram:BuyerReference>\n <ram:SellerTradeParty>\n <ram:Name>Supplyer Corp</ram:Name>\n <ram:SpecifiedLegalOrganization>\n <ram:ID schemeID=\"0002\">123456782</ram:ID>\n </ram:SpecifiedLegalOrganization>\n <ram:PostalTradeAddress>\n <ram:CountryID>FR</ram:CountryID>\n </ram:PostalTradeAddress>\n <ram:SpecifiedTaxRegistration>\n <ram:ID schemeID=\"VA\">FR11123456782</ram:ID>\n </ram:SpecifiedTaxRegistration>\n </ram:SellerTradeParty>\n <ram:BuyerTradeParty>\n <ram:Name>Buyer Corp</ram:Name>\n <ram:SpecifiedLegalOrganization>\n <ram:ID schemeID=\"0002\">987654324</ram:ID>\n </ram:SpecifiedLegalOrganization>\n </ram:BuyerTradeParty>\n <ram:BuyerOrderReferencedDocument >\n <ram:IssuerAssignedID>456</ram:IssuerAssignedID>\n </ram:BuyerOrderReferencedDocument>\n </ram:ApplicableHeaderTradeAgreement>\n <ram:ApplicableHeaderTradeDelivery/>\n <ram:ApplicableHeaderTradeSettlement>\n <ram:InvoiceCurrencyCode>EUR</ram:InvoiceCurrencyCode>\n <ram:SpecifiedTradeSettlementHeaderMonetarySummation>\n <ram:TaxBasisTotalAmount>100.00</ram:TaxBasisTotalAmount>\n <ram:TaxTotalAmount currencyID=\"EUR\">20.00</ram:TaxTotalAmount>\n <ram:GrandTotalAmount>120.00</ram:GrandTotalAmount>\n <ram:DuePayableAmount>120.00</ram:DuePayableAmount>\n </ram:SpecifiedTradeSettlementHeaderMonetarySummation>\n </ram:ApplicableHeaderTradeSettlement>\n </rsm:SupplyChainTradeTransaction>\n </rsm:CrossIndustryInvoice>\n\n``invoice.html``:\n\n.. code-block:: html\n\n <h1>Invoice</h1>\n\nCommand-line::\n\n weasyprint invoice.html invoice.pdf --attachment=factur-x.xml --attachment-relationship=Data --xmp-metadata=rdf.xml --pdf-variant=pdf/a-3a\n\nOr Python API:\n\n.. code-block:: python\n\n from weasyprint import Attachment, HTML\n\n document = HTML(\"invoice.html\").render()\n\n factur_x_xml = Path(\"factur-x.xml\").read_text()\n attachment = Attachment(string=factur_x_xml, name=\"factur-x.xml\", relationship=\"Data\")\n document.metadata.attachments = [attachment]\n\n xmp_metadata = Path(\"rdf.xml\").read_text().encode()\n document.metadata.xmp_metadata = [xmp_metadata]\n\n document.write_pdf(\"invoice.pdf\", pdf_variant=\"pdf/a-3b\")\n\nOf course, the content of these files has to be adapted to the content of real\ninvoices.\n\n\nInclude PDF Forms\n-----------------\n\nBy default, form fields are transformed into pure text and graphical shapes\nwhen exported to PDF. But WeasyPrint gives the possibility to generate real PDF\nforms that can be filled with a PDF reader. These forms can even send requests\nwith the data filled in the PDF, just as the same form would do in a web\nbrowser.\n\nTo transform all HTML forms into PDF forms, you can use the ``--pdf-forms`` CLI\noption or ``pdf_forms`` Python parameter.\n\n.. code-block:: python\n\n from weasyprint import HTML\n HTML(string=\"<input value='test'>\").write_pdf(\"test.pdf\", pdf_forms=True)\n\n.. code-block:: sh\n\n $ weasyprint document.html --pdf-forms document.pdf\n\nYou can also define which specific fields (``input``, ``select``, ``textarea``,\n``button``) have to be transformed into PDF forms by setting the ``appearance``\nCSS property to ``auto`` on them. In this case, as for browsers, you’ll have to\nmanually override the default style set by the user agent stylesheet. Reading\n`the stylesheet set by the --pdf-forms option\n<https://github.com/Kozea/WeasyPrint/blob/main/weasyprint/css/html5_ua_form.css>`_\ncan help to override this style.\n\n.. code-block:: html\n\n <style>\n label { display: block }\n .pdf-form { appearance: auto }\n .pdf-form::before { visibility: hidden }\n </style>\n <label>\n Can't be modified in PDF\n <input value=\"static\">\n </label>\n <label>\n Can be modified in PDF\n <input class=\"pdf-form\" value=\"dynamic\">\n </label>\n\nPDF forms support can be quite poor depending on the PDF reader you use. If a\nfeature doesn’t work for you, please check that this feature is actually\nsupported by your PDF reader before reporting a bug.\n\n\nDefine PDF Metadata\n-------------------\n\nPDF documents can include various metadata, such as title, authors or creation\ndate. The easiest way to define them is to include them in your HTML file:\nthese fields are normalized and can be automatically picked up by WeasyPrint.\n\n.. code-block:: html\n\n <html lang=\"en\">\n <head>\n <title>PDF Sample with Metadata\n \n \n \n \n \n \n \n \n \n\nHTML metadata values listed here, including language and title, are stored in\nthe corresponding, normalized fields in PDF.\n\nIf you use custom metadata fields, they are not stored in PDF by default. You\ncan include them in the PDF info dictionary using the ``--custom-metadata`` CLI\noption or the ``custsom_metadata`` Python parameter.\n\n.. code-block:: python\n\n from weasyprint import HTML\n HTML(string=\"\").write_pdf(\"recipe.pdf\", custom_metadata=True)\n\n.. code-block:: sh\n\n $ weasyprint document.html --custom-metadata document.pdf\n\n\nAttach Files\n------------\n\nYou can attach files to your generated PDF. These files can be opened when a\nlink is clicked in the PDF, or just available in the list of attached files in\nyour PDF reader.\n\nTo attach a file with a regular link, you can use a regular anchor with the\n``rel`` attribute set to ``attachment``.\n\n.. code-block:: html\n\n view attached note\n\nTo attach a file globally to the document, you can add a ``link`` tag in your\n``head``:\n\n.. code-block:: html\n\n \n\nIf you don’t want to attach your files using HTML tags, you can also use the\n``--attachment`` CLI option, multiple times if needed.\n\n.. code-block:: sh\n\n $ weasyprint document.html --attachment note.txt --attachment photo.jpg document.pdf\n\nIn a Python script, you can also attach files using the\n:class:`weasyprint.Attachment` class.\n\n.. code-block:: python\n\n from weasyprint import Attachment, HTML\n attachments = [Attachment(\"note.txt\"), Attachment(\"photo.jpg\")]\n HTML(string=\"

PDF with attachments

\").write_pdf(\"recipe.pdf\", attachments=attachments)\n\n\nCache and Optimize Images\n-------------------------\n\nWeasyPrint provides many options to deal with images: ``optimize_images``,\n``jpeg_quality``, ``dpi`` and ``cache``.\n\n``optimize_images`` can enable size optimization for images. When enabled, the\ngenerated PDF will include smaller images with no quality penalty, but the\nrendering time may be slightly increased.\n\nThe ``jpeg_quality`` option can be set to decrease the quality of JPEG images\nincluded in the PDF. You can set a value between 95 (best quality) to 0\n(smaller image size), depending on your needs.\n\nThe ``dpi`` option offers the possibility to reduce the size (in pixels, and\nthus in bytes) of all included raster images. The resolution, set in dots per\ninch, indicates the maximum number of pixels included in one inch on the\ngenerated PDF.\n\n.. code-block:: python\n\n # Original high-quality images, faster, but generated PDF is larger\n HTML('https://weasyprint.org/').write_pdf('weasyprint.pdf')\n\n # Optimized lower-quality images, a bit slower, but generated PDF is smaller\n HTML('https://weasyprint.org/').write_pdf(\n 'weasyprint.pdf', optimize_images=True, jpeg_quality=60, dpi=150)\n\n``cache`` gives the possibility to use a cache for images, avoiding to\ndownload, parse and optimize them each time they are used.\n\nBy default, the cache is used document by document, but you can share it\nbetween documents if needed. This feature can save a lot of network and CPU\ntime when you render a lot of documents that use the same images.\n\n.. code-block:: python\n\n cache = {}\n for i in range(10):\n HTML(f'https://weasyprint.org/').write_pdf(\n f'example-{i}.pdf', cache=cache)\n\nIt’s also possible to cache images on disk instead of keeping them in memory.\nThe ``--cache-folder`` CLI option can be used to define the folder used to\nstore temporary images. You can also provide this folder path as a string for\n``cache``.\n\n\nImprove Rendering Speed and Memory Use\n--------------------------------------\n\nWeasyPrint is often slower than other web engines. Python is the usual suspect,\nbut it’s not the main culprit here. :ref:`Optimization is not the main goal of\nWeasyPrint ` and it may lead to unbearable long rendering times.\n\nFirst of all: WeasyPrint’s performance gets generally better with time. You can\ncheck WeasyPerf_ to compare time and memory needed across versions.\n\nSome tips may help you to get better results.\n\n- A high number of CSS properties with a high number of HTML tags can lead to a\n huge amount of time spent for the cascade. Avoiding large CSS frameworks can\n drastically reduce the rendering time.\n- Tables are known to be slow, especially when they are rendered on multiple\n pages. When possible, using a common block layout instead gives much faster\n renderings.\n- Optimizing images and fonts can reduce the PDF size, but increase the\n rendering time. Moreover, caching images gives the possibility to read and\n optimize images only once, and thus to save time when the same image is used\n multiple times. See :ref:`Cache and Optimize Images`.\n\n.. _WeasyPerf: https://kozea.github.io/WeasyPerf/\n\n\nShow Log Messages\n-----------------\n\nMost errors (unsupported CSS property, missing image…) are not fatal and will\nnot prevent a document from being rendered. WeasyPrint uses the :mod:`logging`\nmodule from the Python standard library to log these errors and let you know\nabout them.\n\nWhen WeasyPrint is launched in a terminal, logged messages will go to the\nstandard error stream (``stderr``) by default. When used as a library, logs are\nnot displayed at all. You can change that by configuring the ``weasyprint``\nlogger object:\n\n.. code-block:: python\n\n import logging\n logger = logging.getLogger('weasyprint')\n\n # Display warnings, errors and critical messages.\n logger.setLevel(logging.WARNING)\n\n # Save logs to the weasyprint.log file.\n logger.addHandler(logging.FileHandler('weasyprint.log'))\n # Print logs on console.\n logger.addHandler(logging.StreamHandler())\n\nThe ``weasyprint.progress`` logger is used to report the rendering progress. It\nis useful to get feedback when WeasyPrint is launched in a terminal (using the\n``--verbose`` or ``--debug`` option), or to give this feedback to end users\nwhen used as a library.\n\nSee the documentation of the :mod:`logging` module for details.\n" }, { "path": "docs/conf.py", "content": "# WeasyPrint documentation build configuration file.\n\nimport weasyprint\n\n# Add any Sphinx extension module names here, as strings. They can be\n# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom ones.\nextensions = [\n 'sphinx.ext.autodoc', 'sphinx.ext.intersphinx',\n 'sphinx.ext.autosectionlabel']\n\n# Add any paths that contain templates here, relative to this directory.\ntemplates_path = ['_templates']\n\n# The suffix of source filenames.\nsource_suffix = '.rst'\n\n# The master toctree document.\nmaster_doc = 'index'\n\n# General information about the project.\nproject = 'WeasyPrint'\ncopyright = 'Simon Sapin and contributors'\n\n# The version info for the project you're documenting, acts as replacement for\n# |version| and |release|, also used in various other places throughout the\n# built documents.\n#\n# The full version, including alpha/beta/rc tags.\nrelease = weasyprint.__version__\n\n# The short X.Y version.\nversion = release\n\n# List of patterns, relative to source directory, that match files and\n# directories to ignore when looking for source files.\nexclude_patterns = ['_build']\n\n# The name of the Pygments (syntax highlighting) style to use.\npygments_style = 'monokai'\n\n# The theme to use for HTML and HTML Help pages. See the documentation for\n# a list of builtin themes.\nhtml_theme = 'furo'\n\nhtml_theme_options = {\n 'top_of_page_buttons': ['edit'],\n 'source_edit_link':\n 'https://github.com/Kozea/WeasyPrint/edit/main/docs/{filename}',\n}\n\n# Favicon URL\nhtml_favicon = 'https://www.courtbouillon.org/static/images/favicon.png'\n\n# Add any paths that contain custom static files (such as style sheets) here,\n# relative to this directory. They are copied after the builtin static files,\n# so a file named \"default.css\" will overwrite the builtin \"default.css\".\nhtml_static_path = []\n\n# These paths are either relative to html_static_path\n# or fully qualified paths (eg. https://...)\nhtml_css_files = [\n 'https://www.courtbouillon.org/static/docs-furo.css',\n]\n\n# Output file base name for HTML help builder.\nhtmlhelp_basename = 'weasyprintdoc'\n\n# One entry per manual page. List of tuples\n# (source start file, name, description, authors, manual section).\nman_pages = [\n ('manpage', 'weasyprint', 'The Awesome Document Factory',\n ['Simon Sapin and contributors'], 1)\n]\n\n# Don’t autolabel man page titles.\nautosectionlabel_maxdepth = 4\n\n# Grouping the document tree into Texinfo files. List of tuples\n# (source start file, target name, title, author, dir menu entry, description, category)\ntexinfo_documents = [(\n 'index', 'WeasyPrint', 'WeasyPrint Documentation',\n 'Simon Sapin and contributors', 'WeasyPrint',\n 'The Awesome Document Factory', 'Miscellaneous'),\n]\n\n# Example configuration for intersphinx: refer to the Python standard library.\nintersphinx_mapping = {\n 'python': ('https://docs.python.org/3/', None),\n 'pydyf': ('https://doc.courtbouillon.org/pydyf/stable/', None),\n}\n" }, { "path": "docs/contribute.rst", "content": "Contribute\n==========\n\nYou want to add some code to WeasyPrint, launch its tests or improve its\ndocumentation? Thank you very much! Here are some tips to help you play with\nWeasyPrint in good conditions.\n\nThe first step is to clone the repository, create a virtual environment and\ninstall WeasyPrint dependencies:\n\n.. code-block:: shell\n\n git clone https://github.com/Kozea/WeasyPrint.git\n cd WeasyPrint\n python -m venv venv\n venv/bin/pip install -e '.[doc,test]'\n\nYou can then launch Python to test your changes:\n\n.. code-block:: shell\n\n venv/bin/python\n\nRunning WeasyPrint might look something like this:\n\n.. code-block:: shell\n\n venv/bin/python -m weasyprint example.html example.pdf\n\n\nCode & Issues\n-------------\n\nIf you’ve found a bug in WeasyPrint, it’s time to report it, and to fix it if you\ncan!\n\nYou can report bugs and feature requests on `GitHub`_. If you want to add or\nfix some code, please fork the repository and create a pull request, we’ll be\nhappy to review your work.\n\nYou can find more information about the code architecture in the :ref:`Dive\ninto the Source` section.\n\n.. _GitHub: https://github.com/Kozea/WeasyPrint\n\n\nTests\n-----\n\nTests are stored in the ``tests`` folder at the top of the repository. They use\nthe pytest_ library.\n\nTests require Ghostscript_ to be installed and available on the local path. You\nshould also install all the `DejaVu fonts`_ if you’re on Linux.\n\nYou can launch tests using the following command::\n\n venv/bin/python -m pytest\n\nWeasyPrint also uses ruff_ to check the coding style::\n\n venv/bin/python -m ruff check\n\n.. _pytest: https://docs.pytest.org/\n.. _Ghostscript: https://www.ghostscript.com/\n.. _DejaVu fonts: https://dejavu-fonts.github.io/\n.. _ruff: https://docs.astral.sh/ruff/\n\n\nDocumentation\n-------------\n\nDocumentation is stored in the ``docs`` folder at the top of the repository. It\nrelies on the `Sphinx`_ library.\n\nYou can build the documentation using the following command::\n\n venv/bin/sphinx-build docs docs/_build\n\nThe documentation home page can now be found in the\n``/path/to/weasyprint/docs/_build/index.html`` file. You can open this file in a\nbrowser to see the final rendering.\n\n.. _Sphinx: https://www.sphinx-doc.org/\n" }, { "path": "docs/first_steps.rst", "content": "First Steps\n===========\n\n.. currentmodule:: weasyprint\n\n\nInstallation\n------------\n\nWeasyPrint |version| depends on:\n\n* Python_ ≥ 3.10.0\n* Pango_ ≥ 1.44.0\n* pydyf_ ≥ 0.11.0\n* CFFI_ ≥ 0.6\n* tinyhtml5_ ≥ 2.0.0b1\n* tinycss2_ ≥ 1.5.0\n* cssselect2_ ≥ 0.8.0\n* Pyphen_ ≥ 0.9.1\n* Pillow_ ≥ 9.1.0\n* fontTools_ ≥ 4.59.2\n\n.. _Python: https://www.python.org/\n.. _Pango: https://pango.gnome.org/\n.. _CFFI: https://cffi.readthedocs.io/\n.. _pydyf: https://doc.courtbouillon.org/pydyf/\n.. _tinyhtml5: https://doc.courtbouillon.org/tinyhtml5/\n.. _tinycss2: https://doc.courtbouillon.org/tinycss2/\n.. _cssselect2: https://doc.courtbouillon.org/cssselect2/\n.. _Pyphen: https://pyphen.org/\n.. _Pillow: https://python-pillow.org/\n.. _fontTools: https://github.com/fonttools/fonttools\n\nThere are many ways to install WeasyPrint, depending on the system you use.\n\n\nLinux\n~~~~~\n\nThe easiest way to install WeasyPrint on Linux is to use the package manager of\nyour distribution. WeasyPrint is packaged for recent versions of Debian_,\nUbuntu_, Fedora_, Archlinux_, Gentoo_…\n\n.. _Debian: https://packages.debian.org/search?keywords=weasyprint&searchon=names&suite=all§ion=all\n.. _Ubuntu: https://packages.ubuntu.com/search?keywords=weasyprint&searchon=names&suite=all§ion=all\n.. _Fedora: https://src.fedoraproject.org/rpms/weasyprint\n.. _Archlinux: https://aur.archlinux.org/packages/python-weasyprint\n.. _Gentoo: https://packages.gentoo.org/packages/dev-python/weasyprint\n\nIf WeasyPrint is not available on your distribution, or if you want to use a\nmore recent version of WeasyPrint, you have to be sure that Python_ and Pango_\nare installed on your system, and that they are recent enough. You can verify\nthis by launching::\n\n python3 --version\n pango-view --version\n\nIf the version of Pango provided by your distribution is too old, you can use\nversion 52.5 of WeasyPrint which does not need recent Pango features.\n\nWhen everything is OK, you can install WeasyPrint directly on your system or\nin a `virtual environment`_ using `pip`_::\n\n python3 -m venv venv\n source venv/bin/activate\n pip install weasyprint\n weasyprint --info\n\n.. _virtual environment: https://packaging.python.org/guides/installing-using-pip-and-virtual-environments/\n.. _pip: https://pip.pypa.io/\n\n\nAlpine ≥ 3.17\n+++++++++++++\n\nTo install WeasyPrint using your distribution’s package::\n\n apk add weasyprint\n\nTo install WeasyPrint inside a virtualenv using wheels (if possible), you need\nthe following packages::\n\n apk add py3-pip so:libgobject-2.0.so.0 so:libpango-1.0.so.0 so:libharfbuzz.so.0 so:libharfbuzz-subset.so.0 so:libfontconfig.so.1 so:libpangoft2-1.0.so.0\n\nTo install WeasyPrint inside a virtualenv without using wheels, you need the\nfollowing packages::\n\n apk add py3-pip so:libgobject-2.0.so.0 so:libpango-1.0.so.0 so:libharfbuzz.so.0 so:libharfbuzz-subset.so.0 so:libfontconfig.so.1 so:libpangoft2-1.0.so.0\n apk add gcc musl-dev python3-dev zlib-dev jpeg-dev openjpeg-dev libwebp-dev g++ libffi-dev\n\n\nArchlinux\n+++++++++\n\nTo install WeasyPrint using your distribution’s package::\n\n pacman -S python-weasyprint\n\nTo install WeasyPrint inside a virtualenv using wheels (if possible), you need\nthe following packages::\n\n pacman -S python-pip pango\n\nTo install WeasyPrint inside a virtualenv without using wheels, you need the\nfollowing packages::\n\n pacman -S python-pip pango gcc libjpeg-turbo openjpeg2\n\n\nDebian ≥ 11\n+++++++++++\n\nTo install WeasyPrint using your distribution’s package::\n\n apt install weasyprint\n\nTo install WeasyPrint inside a virtualenv using wheels (if possible), you need\nthe following packages::\n\n apt install python3-pip libpango-1.0-0 libpangoft2-1.0-0 libharfbuzz-subset0\n\nTo install WeasyPrint inside a virtualenv without using wheels, you need the\nfollowing packages::\n\n apt install python3-pip libpango-1.0-0 libpangoft2-1.0-0 libharfbuzz-subset0 libjpeg-dev libopenjp2-7-dev libffi-dev\n\n\nFedora ≥ 39\n+++++++++++\n\nTo install WeasyPrint using your distribution’s package::\n\n dnf install weasyprint\n\nTo install WeasyPrint inside a virtualenv using wheels (if possible), you need\nthe following packages::\n\n dnf install python-pip pango\n\nTo install WeasyPrint inside a virtualenv without using wheels, you need the\nfollowing packages::\n\n dnf install python3-pip pango gcc python3-devel gcc-c++ zlib-devel libjpeg-devel openjpeg2-devel libffi-devel\n\n\nUbuntu ≥ 20.04\n++++++++++++++\n\nTo install WeasyPrint using your distribution’s package::\n\n apt install weasyprint\n\nTo install WeasyPrint inside a virtualenv using wheels (if possible), you need\nthe following packages::\n\n apt install python3-pip libpango-1.0-0 libharfbuzz0b libpangoft2-1.0-0 libharfbuzz-subset0\n\nTo install WeasyPrint inside a virtualenv without using wheels, you need the\nfollowing packages::\n\n apt install python3-pip libpango-1.0-0 libharfbuzz0b libpangoft2-1.0-0 libharfbuzz-subset0 libffi-dev libjpeg-dev libopenjp2-7-dev\n\n\nmacOS\n~~~~~\n\nThe easiest way to install WeasyPrint on macOS is to use Homebrew_::\n\n brew install weasyprint\n\n.. _Homebrew: https://brew.sh/\n\n\nWindows\n~~~~~~~\n\nTo use WeasyPrint on Windows, the easiest way is to use the `executable`_ of\nthe latest release.\n\n.. warning::\n\n WeasyPrint is regularly marked as malware by different antivirus companies.\n See `#2081`_ or `#2092`_ to get more information on this topic. Don’t\n hesitate to report the false positive detection to your antivirus company in\n order to improve malware detection for future versions.\n\nIf you want to use WeasyPrint as a Python library, you’ll have to follow a few\nextra steps. Please read this chapter carefully.\n\nThe first step is to install the `Python Install Manager`_ from the Microsoft\nStore.\n\nWhen Python is installed, you have to install Pango and its dependencies. The\neasiest way to install these libraries is to use MSYS2. Here are the steps you\nhave to follow:\n\n- Install `MSYS2`_ keeping the default options.\n- After installation, in MSYS2’s shell, execute ``pacman -S mingw-w64-x86_64-pango``.\n- Close MSYS2’s shell.\n\nYou can then launch a Windows command prompt by clicking on the Start menu,\ntyping ``cmd`` and clicking the \"Command Prompt\" icon. Install WeasyPrint in a\n`virtual environment`_ using `pip`_::\n\n python -m venv venv\n venv\\Scripts\\activate.bat\n python -m pip install weasyprint\n python -m weasyprint --info\n\n.. _executable: https://github.com/Kozea/WeasyPrint/releases\n.. _#2081: https://github.com/Kozea/WeasyPrint/issues/2081\n.. _#2092: https://github.com/Kozea/WeasyPrint/issues/2092\n.. _Python Install Manager: https://apps.microsoft.com/detail/9nq7512cxl7t\n.. _MSYS2: https://www.msys2.org/#installation\n\n\nOther Solutions\n~~~~~~~~~~~~~~~\n\nOther solutions are available to install WeasyPrint. These solutions are not\ntested but they are known to work for some use cases on specific platforms.\n\nMacports\n++++++++\n\nOn macOS, you can install WeasyPrint’s dependencies with Macports_::\n\n sudo port install py-pip pango libffi\n\nYou can then install WeasyPrint in a `virtual environment`_ using `pip`_::\n\n python3 -m venv venv\n source venv/bin/activate\n pip install weasyprint\n weasyprint --info\n\n.. _Macports: https://www.macports.org/\n\nConda\n+++++\n\nOn Linux and macOS, WeasyPrint is available on Conda_, with `a WeasyPrint\npackage on Conda Forge`_.\n\n.. _Conda: https://docs.conda.io/projects/conda/en/latest/\n.. _a WeasyPrint package on Conda Forge: https://anaconda.org/conda-forge/weasyprint\n\nWSL\n+++\n\nOn Windows, you can also use WSL_ and install WeasyPrint the same way it has to\nbe installed on Linux.\n\n.. _WSL: https://docs.microsoft.com/en-us/windows/wsl/\n\n.NET Wrapper\n++++++++++++\n\nOn Windows, Bader Albarrak maintains `a .NET wrapper`_.\n\n.. _a .NET wrapper: https://github.com/balbarak/WeasyPrint-netcore\n\nAWS\n+++\n\nKotify maintains `an AWS Lambda layer`_, see issue `#1003`_ for more\ninformation.\n\n.. _an AWS Lambda layer: https://github.com/kotify/cloud-print-utils\n.. _#1003: https://github.com/Kozea/WeasyPrint/issues/1003\n\nDocker\n++++++\n\nLuca Vercelli maintains `Docker images`_.\n\n.. _an AWS Lambda layer: https://github.com/kotify/cloud-print-utils\n.. _Docker images: https://github.com/luca-vercelli/WeasyPrint-docker-images/\n\n\nTroubleshooting\n~~~~~~~~~~~~~~~\n\nMost of the installation problems have already been met, and some `issues on\nGitHub`_ could help you to solve them. If the solutions here don’t solve your\nproblem, please open a new issue (and don’t add comments to closed issues).\n\n.. _issues on GitHub: https://github.com/Kozea/WeasyPrint/issues\n\nMissing Library\n+++++++++++++++\n\nOn Windows or macOS, most of the problems come from unreachable libraries. If\nyou get an error like ``cannot load library 'xxx': error xxx``, it means that\nWeasyPrint can’t find this library.\n\nOn Windows, you can set the ``WEASYPRINT_DLL_DIRECTORIES`` environment variable\nto list the folders where the DLL files can be found. For example, in\n``cmd.exe``::\n\n set WEASYPRINT_DLL_DIRECTORIES=C:\\msys64\\mingw64\\bin\n\nOn macOS, you can set the ``DYLD_FALLBACK_LIBRARY_PATH`` environment variable::\n\n export DYLD_FALLBACK_LIBRARY_PATH=/opt/homebrew/lib:$DYLD_FALLBACK_LIBRARY_PATH\n\nOf course, check that the folders you set actually contain the ``.dll`` (on\nWindows) or ``.dylib`` (on macOS) files WeasyPrint requires.\n\nMissing Fonts\n+++++++++++++\n\nIf no character is drawn in the generated PDF, or if you get squares instead of\nletters, you have to install fonts and make them available to WeasyPrint.\nFollowing the standard way to install fonts on your system should be enough.\nYou can also use ``@font-face`` rules to explicitly reference fonts using URLs.\n\n\nCommand-Line\n------------\n\nUsing the WeasyPrint command line interface can be as simple as this:\n\n.. code-block:: sh\n\n weasyprint https://weasyprint.org /tmp/weasyprint-website.pdf\n\nYou may see warnings on the standard error output about unsupported CSS\nproperties. See :ref:`Command-Line API` for the details of all available\noptions.\n\nIn particular, the ``-s`` option can add a filename for a\n:ref:`user stylesheet `. For quick experimentation\nhowever, you may not want to create a file. In bash or zsh, you can\nuse the shell’s redirection instead:\n\n.. code-block:: sh\n\n weasyprint https://weasyprint.org /tmp/weasyprint-website.pdf \\\n -s <(echo 'body { font-family: serif !important }')\n\nIf you have many documents to convert you may prefer using the Python API\nin long-lived processes to avoid paying the start-up costs every time.\n\n\nPython Library\n--------------\n\n.. attention::\n\n Using WeasyPrint with untrusted HTML or untrusted CSS may lead to various\n :ref:`security problems `.\n\nQuickstart\n~~~~~~~~~~\n\nThe Python version of the above example goes like this:\n\n.. code-block:: python\n\n from weasyprint import HTML\n HTML('https://weasyprint.org/').write_pdf('/tmp/weasyprint-website.pdf')\n\n… or with the inline stylesheet:\n\n.. code-block:: python\n\n from weasyprint import HTML, CSS\n HTML('https://weasyprint.org/').write_pdf('/tmp/weasyprint-website.pdf',\n stylesheets=[CSS(string='body { font-family: serif !important }')])\n\nInstantiating HTML and CSS Objects\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nIf you have a file name, an absolute URL or a readable :term:`file object`,\nyou can just pass it to :class:`HTML` or :class:`CSS` to create an instance.\nAlternatively, use a named argument so that no guessing is involved:\n\n.. code-block:: python\n\n from weasyprint import HTML\n\n HTML('../foo.html') # Same as …\n HTML(filename='../foo.html')\n\n HTML('https://weasyprint.org') # Same as …\n HTML(url='https://weasyprint.org')\n\n HTML(sys.stdin) # Same as …\n HTML(file_obj=sys.stdin)\n\nIf you have a byte string or Unicode string already in memory you can also pass\nthat, although the argument must be named:\n\n.. code-block:: python\n\n from weasyprint import HTML, CSS\n\n # HTML('

foo') would be filename\n HTML(string='''\n

The title

\n

Content goes here\n ''')\n CSS(string='@page { size: A3; margin: 1cm }')\n\nIf you have ``@font-face`` rules in your CSS, you have to create a\n``FontConfiguration`` object:\n\n.. code-block:: python\n\n from weasyprint import HTML, CSS\n from weasyprint.text.fonts import FontConfiguration\n\n font_config = FontConfiguration()\n html = HTML(string='

The title

')\n css = CSS(string='''\n @font-face {\n font-family: Gentium;\n src: url(https://example.com/fonts/Gentium.otf);\n }\n h1 { font-family: Gentium }''', font_config=font_config)\n html.write_pdf(\n '/tmp/example.pdf', stylesheets=[css],\n font_config=font_config)\n\nRendering to a Single File\n~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nOnce you have a :class:`HTML` object, call its :meth:`HTML.write_pdf` method to\nget the rendered document in a single PDF file.\n\nWithout arguments, this method returns a byte string in memory. If you pass a\nfile name or a writable :term:`file object`, they will write there directly\ninstead. (**Warning**: with a filename, these methods will overwrite existing\nfiles silently.)\n\nRendering Individual Pages\n~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nIf you want more than a single PDF, the :meth:`HTML.render` method gives you a\n:class:`document.Document` object with access to individual\n:class:`document.Page` objects. Thus you can get the number of pages, their\nsize\\ [#]_, the details of hyperlinks and bookmarks, etc. Documents also have a\n:meth:`document.Document.write_pdf` method, and you can get a subset of the\npages with :meth:`document.Document.copy()`.\n\n.. [#] Pages in the same document do not always have the same size.\n\nSee the :ref:`Python API` for details. A few random examples:\n\n.. code-block:: python\n\n # Write odd and even pages separately:\n # Lists count from 0 but page numbers usually from 1\n # [::2] is a slice of even list indexes but odd-numbered pages.\n document.copy(document.pages[::2]).write_pdf('odd_pages.pdf')\n document.copy(document.pages[1::2]).write_pdf('even_pages.pdf')\n\n.. code-block:: python\n\n # Print the outline of the document.\n # Output on https://www.w3.org/TR/CSS21/intro.html\n # 1. Introduction to CSS 2.1 (page 2)\n # 1. A brief CSS 2.1 tutorial for HTML (page 2)\n # 2. A brief CSS 2.1 tutorial for XML (page 5)\n # 3. The CSS 2.1 processing model (page 6)\n # 1. The canvas (page 7)\n # 2. CSS 2.1 addressing model (page 7)\n # 4. CSS design principles (page 8)\n def print_outline(bookmarks, indent=0):\n for i, bookmark in enumerate(bookmarks, 1):\n page = bookmark.destination[0]\n print('%s%d. %s (page %d)' % (\n ' ' * indent, i, bookmark.label.lstrip('0123456789. '), page))\n print_outline(bookmark.children, indent + 2)\n print_outline(document.make_bookmark_tree())\n\nURL Fetchers\n~~~~~~~~~~~~\n\nWeasyPrint goes through a *URL fetcher* to fetch external resources such as\nimages or CSS stylesheets. The default fetcher can natively open file and\nHTTP URLs, but the HTTP client does not support advanced features like cookies\nor authentication. This can be worked-around by passing a custom\n:class:`URLFetcher ` to the :class:`HTML` or :class:`CSS`\nclasses.\n\nSome features, such as the timeout delay, can be configured as parameters:\n\n.. code-block:: python\n\n from weasyprint import HTML\n from weasyprint.urls import URLFetcher\n\n HTML(string='', url_fetcher=URLFetcher(timeout=20)).write_pdf('out.pdf')\n\nCustom fetchers can also choose to handle some URLs and defer others to the default\nfetcher:\n\n.. code-block:: python\n\n from weasyprint import HTML\n from weasyprint.urls import URLFetcher, URLFetcherResponse\n\n class MyFetcher(URLFetcher):\n def fetch(self, url, headers=None):\n if url.startswith('graph:'):\n graph_data = [float(value) for value in url[6:].split(',')]\n string = generate_graph(graph_data)\n return URLFetcherResponse(url, string, {'Content-Type': 'image/png'})\n return super().fetch(url, headers)\n\n source = ''\n HTML(string=source, url_fetcher=MyFetcher()).write_pdf('out.pdf')\n\nBy default, all errors raised by the fetcher are caught by WeasyPrint and emit a\nwarning. If you want some errors to be fatal and stop the rendering, you can raise a\n:class:`urls.FatalURLFetchingError`.\n\n.. code-block:: python\n\n from weasyprint import HTML\n from weasyprint.urls import URLFetcher, FatalURLFetchingError\n\n class MyFetcher(URLFetcher):\n def fetch(self, url, headers=None):\n try:\n return super().fetch(url, headers)\n except Exception as exception:\n if url.endswith('.css'):\n # Stop the rendering if a problem happens with a stylesheet.\n message = f'Problem with stylesheet at {url}'\n raise FatalURLFetchingError(message) from exception\n else:\n # Raise original error that will be caught by WeasyPrint.\n raise exception\n\n HTML(string='', url_fetcher=MyFetcher()).write_pdf('out.pdf')\n\nFlask-WeasyPrint_ for Flask_ and Django-Weasyprint_ for Django_ both make\nuse of a custom URL fetcher to integrate WeasyPrint and use the filesystem\ninstead of a network call for static and media files.\n\nA custom fetcher should be returning a :class:`urls.URLFetcherResponse`.\n\nIf a ``file_obj`` is given, the resource will be closed automatically by\nthe function internally used by WeasyPrint to retrieve data.\n\n.. _Flask-Weasyprint: https://github.com/Kozea/Flask-WeasyPrint\n.. _Flask: https://flask.pocoo.org/\n.. _Django-WeasyPrint: https://github.com/fdemmer/django-weasyprint\n.. _Django: https://www.djangoproject.com/\n\n\nSecurity\n--------\n\n*This section has been added thanks to the very useful reports and advice from\nRaz Becker.*\n\nWhen used with untrusted HTML or untrusted CSS, WeasyPrint can meet security\nproblems. You will need extra configuration in your Python application to avoid\nhigh memory use, endless renderings or local files leaks.\n\nAs for any service dealing with untrusted data, you should at least follow\nbasic security rules with WeasyPrint: don’t launch the service as root, launch\nit as a user with limited access to filesystem, network and memory. Using a\ncontainer can also be a simple way to limit the possibilities given to an\nattacker in case of security breach.\n\nLong Renderings\n~~~~~~~~~~~~~~~\n\nWeasyPrint is pretty slow and can take a long time to render long documents or\nspecially crafted HTML pages.\n\nWhen WeasyPrint used on a server with HTML or CSS files from untrusted sources,\nthis problem can lead to very long time renderings, with processes with high\nCPU and memory use. Even small documents may lead to really long rendering\ntimes, restricting HTML document size is not enough.\n\nIf you use WeasyPrint on a server with HTML or CSS samples coming from\nuntrusted users, you should:\n\n- limit rendering time and memory use of your process, for example using\n ``evil-reload-on-as`` and ``harakiri`` options if you use uWSGI,\n- limit memory use at the OS level, for example with ``ulimit`` on Linux,\n- automatically kill the process when it uses too much memory or when the\n rendering time is too high, by regularly launching a script to do so if no\n better option is available,\n- truncate and sanitize HTML and CSS input to avoid very long documents and\n access to external URLs.\n\nInfinite Requests\n~~~~~~~~~~~~~~~~~\n\nWeasyPrint can reach files on the network, for example using ``https://``\nURIs. For various reasons, HTTP requests may take a long time and lead to\nproblems similar to :ref:`Long Renderings`.\n\nWeasyPrint has a default timeout of 10 seconds for HTTP, HTTPS and FTP\nresources. This timeout has no effect with other protocols, including access to\n``file://`` URIs.\n\nIf you use WeasyPrint on a server with HTML or CSS samples coming from\nuntrusted users, or need to reach network resources, you should:\n\n- use a custom :ref:`URL fetcher `,\n- follow solutions listed in :ref:`Long Renderings`.\n\nInfinite Loops\n~~~~~~~~~~~~~~\n\nWeasyPrint has been hit by a large number of bugs, including infinite\nloops. Specially crafted HTML and CSS files can quite easily lead to infinite\nloops and infinite rendering times.\n\nIf you use WeasyPrint on a server with HTML or CSS samples coming from\nuntrusted users, you should:\n\n- follow solutions listed in :ref:`Long Renderings`.\n\nHuge Values\n~~~~~~~~~~~\n\nWeasyPrint doesn't restrict integer and float values used in CSS. Using huge\nvalues for some properties (page sizes, font sizes, block sizes) can lead to\nvarious problems, including infinite rendering times, huge PDF files, high\nmemory use and crashes.\n\nThis problem is really hard to avoid. Even parsing CSS stylesheets and\nsearching for huge values is not enough, as it is quite easy to trick CSS\npre-processors using relative units (``em`` and ``%`` for example).\n\nIf you use WeasyPrint on a server with HTML or CSS samples coming from\nuntrusted users, you should:\n\n- follow solutions listed in :ref:`Long Renderings`.\n\nAccess to Local Files\n~~~~~~~~~~~~~~~~~~~~~\n\nAs any web renderer, WeasyPrint can reach files on the local filesystem using\n``file://`` URIs. These files can be shown in ``img`` or ``embed`` tags for\nexample.\n\nWhen WeasyPrint used on a server with HTML or CSS files from untrusted sources,\nthis feature may be used to know if files are present on the server filesystem,\nand to embed them in generated documents.\n\nUnix-like systems also have special local files with infinite size, like\n``/dev/urandom``. Referencing these files in HTML or CSS files obviously lead\nto infinite time renderings.\n\nIf you use WeasyPrint on a server with HTML or CSS samples coming from\nuntrusted users, you should:\n\n- restrict your process access to trusted files using sandboxing solutions,\n- use a custom :ref:`URL fetcher ` that doesn't allow ``file://``\n URLs or filters access depending on given paths.\n- follow solutions listed in :ref:`Long Renderings`.\n\nSystem Information Leaks\n~~~~~~~~~~~~~~~~~~~~~~~~\n\nWeasyPrint relies on many libraries that can leak hardware and software\ninformation. Even when this information looks useless, it can be used by\nattackers to exploit other security breaches.\n\nLeaks can include (but are not restricted to):\n\n- locally installed fonts (using ``font-family`` and ``@font-face``),\n- network configuration (IPv4 and IPv6 support, IP addressing, firewall\n configuration, using ``https://`` URIs and tracking time used to render\n documents),\n- Python, Pango and other libraries versions (implementation details\n lead to different renderings).\n\nSVG Images\n~~~~~~~~~~\n\nRendering SVG images more or less suffers from the same problems as the ones\nlisted here for WeasyPrint.\n\nSecurity advices apply for untrusted SVG files as they apply for untrusted HTML\nand CSS documents.\n\nNote that WeasyPrint’s URL fetcher is used to render SVG files.\n" }, { "path": "docs/going_further.rst", "content": "Going Further\n=============\n\n.. currentmodule:: weasyprint\n\n\nWhy WeasyPrint?\n---------------\n\nAutomatic document generation is a common need of many applications, even if a\nlot of operations do not require printed paper anymore.\n\nInvoices, tickets, leaflets, diplomas, documentation, books… All these\ndocuments are read and used on paper, but also on electronical readers, on\nsmartphones, on computers. PDF is a great format to store and display them in\na reliable way, with pagination.\n\nUsing HTML and CSS to generate static and paged content can be strange at first\nglance: browsers display only one page, with variable dimensions, often in a\nvery dynamic way. But paged media layout is actually included in CSS2_, which\nwas already a W3C recommendation in 1998.\n\nOther well-known tools can be used to automatically generate PDF documents,\nlike LaTeX and LibreOffice, but they miss many advantages that HTML and CSS\noffer. HTML and CSS are very widely known, by developers but also by\nwebdesigners. They are specified in a backwards-compatible way, and regularly\nadapted to please the use of billions of people. They are really easy to write\nand generate, with a ridiculous amount of tools that are finely adapted to the\nneeds and taste of their users.\n\nHowever, the web engines that are used for browsers were very limited for\npagination when WeasyPrint was created in 2011. Even now, they lack a lot of\nbasic features. That’s why projects such as wkhtmltopdf_ and PagedJS_ have been\ncreated: they add some of these features to existing browsers.\n\nOther solutions have beed developed, including web engine dedicated to paged\nmedia. Prince_, Antennahouse_ or `Typeset.sh`_ created original renderers\nsupporting many features related to pagination. These tools are very powerful,\nbut they are not open source.\n\nBuilding a free and open source web renderer generating high-quality documents\nis the main goal of WeasyPrint. Do you think that it was a little bit crazy to\ncreate such a big project from scratch? Here is what `Simon Sapin`_ wrote\nin WeasyPrint’s documentation one month after the beginning:\n\n Are we crazy? Yes. But not that much. Each modern web browser did take many\n developers’ many years of work to get where they are now, but WeasyPrint’s\n scope is much smaller: there is no user-interaction, no JavaScript, no live\n rendering (the document doesn’t changed after it was first parsed) and no\n quirks mode (we don’t need to support every broken page of the web.)\n\n We still need however to implement the whole CSS box model and visual\n rendering. This is a lot of work, but we feel we can get something useful\n much quicker than “Let’s build a rendering engine!” may seem.\n\nSimon is often right.\n\n.. _CSS2: https://www.w3.org/TR/1998/REC-CSS2-19980512/\n.. _wkhtmltopdf: https://wkhtmltopdf.org/\n.. _PagedJS: https://www.pagedjs.org/\n.. _Prince: https://www.princexml.com/\n.. _Antennahouse: https://www.antennahouse.com/\n.. _Typeset.sh: https://typeset.sh/\n.. _Simon Sapin: https://exyr.org/\n\n\nWhy Python?\n-----------\n\nPython is a really good language to design a small, OS-agnostic parser. As it\nis object-oriented, it gives the possibility to follow the specification with\nhigh-level classes and a small amount of very simple code.\n\nSpeed is not WeasyPrint’s main goal. Web rendering is a very complex task, and\nfollowing :pep:`the Zen of Python <20>` helped a lot to keep our sanity (both in our\ncode and in our heads): code simplicity, maintainability and flexibility are\nthe most important goals for this library, as they give the ability to stay\nreally close to the specification and to fix bugs easily.\n\n\nDive into the Source\n--------------------\n\nThis chapter is a high-level overview of WeasyPrint’s source code. For more\ndetails, see the various docstrings or even the code itself. When in doubt,\nfeel free to :ref:`ask `!\n\nMuch `like in web browsers`_, the rendering of a document in WeasyPrint goes\nlike this:\n\n1. The HTML document is fetched and parsed into a tree of elements (like DOM).\n2. CSS stylesheets (either found in the HTML or supplied by the user) are\n fetched and parsed.\n3. The stylesheets are applied to the DOM-like tree.\n4. The DOM-like tree with styles is transformed into a *formatting structure*\n made of rectangular boxes.\n5. These boxes are *laid-out* with fixed dimensions and position onto pages.\n6. For each page, the boxes are re-ordered to observe stacking rules, and are\n drawn on a PDF page.\n7. Metadata −such as document information, attachments, embedded files,\n hyperlinks, and PDF trim and bleed boxes− are added to the PDF.\n\n.. _like in web browsers: https://www.html5rocks.com/en/tutorials/internals/howbrowserswork/#The_main_flow\n\n\nParsing HTML\n............\n\nNot much to see here. The :class:`HTML` class handles step 1 and\ngives a tree of HTML *elements*. Although the actual API is different, this\ntree is conceptually the same as what web browsers call *the DOM*.\n\n\nParsing CSS\n...........\n\nAs with HTML, CSS stylesheets are parsed in the :class:`CSS` class\nwith an external library, tinycss2_.\n\nIn addition to the actual parsing, the ``css`` and ``css.validation``\nmodules do some pre-processing:\n\n* Unknown and unsupported declarations are ignored with warnings.\n Remaining property values are parsed in a property-specific way\n from raw tinycss2 tokens into a higher-level form.\n* Shorthand properties are expanded. For example, ``margin`` becomes\n ``margin-top``, ``margin-right``, ``margin-bottom`` and ``margin-left``.\n* Hyphens in property names are replaced by underscores (``margin-top`` becomes\n ``margin_top``). This transformation is safe since none of the known (not\n ignored) properties have an underscore character.\n* Selectors are pre-compiled with cssselect2_.\n\n.. _tinycss2: https://pypi.python.org/pypi/tinycss2\n.. _cssselect2: https://pypi.python.org/pypi/cssselect2\n\n\nThe Cascade\n...........\n\nAfter that and still in the ``css`` package, the cascade_\n(that’s the C in CSS!) applies the stylesheets to the element tree.\nSelectors associate property declarations to elements. In case of conflicting\ndeclarations (different values for the same property on the same element),\nthe one with the highest *weight* wins. Weights are based on the stylesheet’s\n:ref:`origin `, ``!important`` markers, selector\nspecificity and source order. Missing values are filled in through\n*inheritance* (from the parent element) or the property’s *initial value*,\nso that every element has a *specified value* for every property.\n\n.. _cascade: https://www.w3.org/TR/CSS21/cascade.html\n\nThese *specified values* are turned into *computed values* in the\n``css.computed_values`` module. Keywords and lengths in various units are\nconverted to pixels, etc. At this point the value for some properties can be\nrepresented by a single number or string, but some require more complex\nobjects. For example, a ``Dimension`` object can be either an absolute length\nor a percentage.\n\nThe final result of the ``css.get_all_computed_styles`` function is a big dict\nwhere keys are ``(element, pseudo_element_type)`` tuples, and keys are style\ndict objects. Elements are ElementTree elements, while the type of\npseudo-element is a string for eg. ``::first-line`` selectors, or :obj:`None`\nfor “normal” elements. Style dict objects are dicts mapping property names to\nthe computed values. (The return value is not the dict itself, but a\nconvenience ``style_for`` function for accessing it.)\n\n\nFormatting Structure\n....................\n\nThe `visual formatting model`_ explains how *elements* (from the ElementTree\ntree) generate *boxes* (in the formatting structure). This is step 4 above.\nBoxes may have children and thus form a tree, much like elements. This tree is\ngenerally close but not identical to the ElementTree tree: some elements\ngenerate more than one box or none.\n\n.. _visual formatting model: https://www.w3.org/TR/CSS21/visuren.html\n\nBoxes are of a lot of different kinds. For example you should not confuse\n*block-level boxes* and *block containers*, though *block boxes* are both. The\n``formatting_structure.boxes`` module has a whole hierarchy of classes to\nrepresent all these boxes. We won’t go into the details here, see the module\nand class docstrings.\n\nThe ``formatting_structure.build`` module takes an ElementTree tree with\nassociated computed styles, and builds a formatting structure. It generates the\nright boxes for each element and ensures they conform to the models rules\n(eg. an inline box can not contain a block). Each box has a ``style``\nattribute containing the style dict of computed values.\n\nThe main logic is based on the ``display`` property, but it can be overridden\nfor some elements by adding a handler in the ``html`` module.\nThis is how ```` and ```` are currently implemented,\nfor example.\n\nThis module is rather short as most of HTML is defined in CSS rather than\nin Python, in the `user agent stylesheet`_.\n\nThe ``formatting_structure.build.build_formatting_structure`` function returns\nthe box for the root element (and, through its ``children`` attribute, the\nwhole tree).\n\n.. _user agent stylesheet: https://github.com/Kozea/WeasyPrint/blob/main/weasyprint/css/html5_ua.css\n\n\nLayout\n......\n\nStep 5 is the layout. You could say the everything else is glue code and\nthis is where the magic happens.\n\nDuring the layout the document’s content is, well, laid out on pages.\nThis is when we decide where to do line breaks and page breaks. If a break\nhappens inside of a box, that box is split into two (or more) boxes in the\nlayout result.\n\nAccording to the `box model`_, each box has rectangular margin, border,\npadding and content areas:\n\n.. _box model: https://www.w3.org/TR/CSS21/box.html\n\n.. image:: https://www.w3.org/TR/CSS21/images/boxdim.png\n :alt: CSS Box Model\n :class: dark-invert\n\nWhile ``box.style`` contains computed values, the `used values`_ are set as\nattributes of the ``Box`` object itself during the layout. This include\nresolving percentages and especially ``auto`` values into absolute, pixel\nlengths. Once the layout done, each box has used values for margins, border\nwidth, padding of each four sides, as well as the ``width`` and ``height`` of\nthe content area. They also have ``position_x`` and ``position_y``, the\nabsolute coordinates of the top-left corner of the margin box (**not** the\ncontent box) from the top-left corner of the page.\\ [#]_\n\nBoxes also have helpers methods such as ``content_box_y`` and ``margin_width``\nthat give other metrics that can be useful in various parts of the code.\n\nThe final result of the layout is a list of ``PageBox`` objects.\n\n.. [#] These are the coordinates *if* no `CSS transform`_ applies.\n Transforms change the actual location of boxes, but they are applied\n later during drawing and do not affect layout.\n.. _used values: https://www.w3.org/TR/CSS21/cascade.html#used-value\n.. _CSS transform: https://www.w3.org/TR/css-transforms-1/\n\n\nStacking & Drawing\n..................\n\nIn step 6, the boxes are reordered by the ``stacking`` module to observe\n`stacking rules`_ such as the ``z-index`` property. The result is a tree of\n*stacking contexts*.\n\nNext, each laid-out page is *drawn* onto a PDF page. Since each box has\nabsolute coordinates on the page from the layout step, the logic here should be\nminimal. If you find yourself adding a lot of logic here, maybe it should go in\nthe layout or stacking instead.\n\nThe code lives in the ``draw`` module.\n\n.. _stacking rules: https://www.w3.org/TR/CSS21/zindex.html\n\n\nMetadata\n........\n\nFinally (step 7), the ``pdf`` adds metadata to the PDF file: document\ninformation, attachments, hyperlinks, embedded files, trim box and bleed box.\n" }, { "path": "docs/index.rst", "content": "WeasyPrint\n==========\n\n.. currentmodule:: weasyprint\n\n.. include:: ../README.rst\n\n.. toctree::\n :caption: Documentation\n :maxdepth: 2\n\n first_steps\n common_use_cases\n api_reference\n going_further\n\n.. toctree::\n :caption: Extra Information\n :maxdepth: 2\n\n changelog\n contribute\n support\n" }, { "path": "docs/manpage.rst", "content": ":orphan:\n\n.. currentmodule:: weasyprint\n\n\nDescription\n-----------\n\n.. autofunction:: weasyprint.__main__.main(argv=sys.argv)\n :noindex:\n\n\nAbout\n-----\n\n.. include:: ../README.rst\n" }, { "path": "docs/support.rst", "content": "Support\n=======\n\n\nSponsorship\n-----------\n\nWith `donations and sponsorship`, you help make the projects\nbetter. Donations allow the CourtBouillon team to have more time dedicated to\nadd new features, fix bugs, and improve documentation.\n\n.. _donations and sponsorship: https://opencollective.com/courtbouillon\n\n\nProfessional Support\n--------------------\n\nYou can improve your experience with CourtBouillon’s tools thanks to our\nprofessional support. You want bugs fixed as soon as possible? Your projects\nwould highly benefit from some new features? You or your team would like to get\nnew skills with one of the technologies we master?\n\nPlease contact us by mail, by chat, or by tweet to get in touch and find the\nbest way we can help you.\n\n.. _mail: mailto:contact@courtbouillon.org\n.. _chat: https://gitter.im/CourtBouillon/tinycss2\n.. _tweet: https://twitter.com/BouillonCourt\n" }, { "path": "pyproject.toml", "content": "[build-system]\nrequires = ['flit_core >=3.2,<4']\nbuild-backend = 'flit_core.buildapi'\n\n[project]\nname = 'weasyprint'\ndescription = 'The Awesome Document Factory'\nkeywords = ['html', 'css', 'pdf', 'converter']\nauthors = [{name = 'Simon Sapin', email = 'simon.sapin@exyr.org'}]\nmaintainers = [{name = 'CourtBouillon', email = 'contact@courtbouillon.org'}]\nrequires-python = '>=3.10'\nreadme = {file = 'README.rst', content-type = 'text/x-rst'}\nlicense = {file = 'LICENSE'}\ndependencies = [\n 'pydyf >=0.11.0',\n 'cffi >=0.6',\n 'tinyhtml5 >=2.0.0b1',\n 'tinycss2 >=1.5.0',\n 'cssselect2 >=0.8.0',\n 'Pyphen >=0.9.1',\n 'Pillow >=9.1.0',\n 'fonttools[woff] >=4.59.2',\n]\nclassifiers = [\n 'Development Status :: 5 - Production/Stable',\n 'Intended Audience :: Developers',\n 'License :: OSI Approved :: BSD License',\n 'Operating System :: OS Independent',\n 'Programming Language :: Python',\n 'Programming Language :: Python :: 3',\n 'Programming Language :: Python :: 3 :: Only',\n 'Programming Language :: Python :: 3.10',\n 'Programming Language :: Python :: 3.11',\n 'Programming Language :: Python :: 3.12',\n 'Programming Language :: Python :: 3.13',\n 'Programming Language :: Python :: 3.14',\n 'Programming Language :: Python :: Implementation :: CPython',\n 'Programming Language :: Python :: Implementation :: PyPy',\n 'Topic :: Internet :: WWW/HTTP',\n 'Topic :: Text Processing :: Markup :: HTML',\n 'Topic :: Multimedia :: Graphics :: Graphics Conversion',\n 'Topic :: Printing',\n]\ndynamic = ['version']\n\n[project.urls]\nHomepage = 'https://weasyprint.org/'\nDocumentation = 'https://doc.courtbouillon.org/weasyprint/'\nCode = 'https://github.com/Kozea/WeasyPrint'\nIssues = 'https://github.com/Kozea/WeasyPrint/issues'\nChangelog = 'https://github.com/Kozea/WeasyPrint/releases'\nDonation = 'https://opencollective.com/courtbouillon'\n\n[project.optional-dependencies]\ndoc = ['sphinx', 'furo']\ntest = ['pytest', 'ruff', 'Pillow >=12.1.0']\n\n[project.scripts]\nweasyprint = 'weasyprint.__main__:main'\n\n[tool.flit.sdist]\nexclude = ['.*']\n\n[tool.coverage.run]\nbranch = true\ninclude = ['tests/*', 'weasyprint/*']\n\n[tool.coverage.report]\nexclude_lines = ['pragma: no cover', 'def __repr__', 'raise NotImplementedError']\n\n[tool.ruff.lint]\nselect = ['E', 'W', 'F', 'I', 'N', 'RUF', 'T20', 'PIE', 'PT', 'RSE', 'UP', 'Q']\nignore = ['E226', 'RUF001', 'RUF002', 'RUF003', 'RUF039', 'RUF059', 'UP031']\n\n[tool.ruff.lint.flake8-quotes]\ninline-quotes = 'single'\nmultiline-quotes = 'single'" }, { "path": "tests/__init__.py", "content": "\"\"\"The Weasyprint test suite.\"\"\"\n" }, { "path": "tests/conftest.py", "content": "\"\"\"Configuration for WeasyPrint tests.\n\nThis module adds a PNG export based on Ghostscript.\n\nNote that Ghostscript is released under AGPL.\n\n\"\"\"\n\nimport io\nimport os\nimport shutil\nfrom subprocess import PIPE, run\nfrom tempfile import NamedTemporaryFile\n\nimport pytest\nfrom PIL import Image\n\nfrom weasyprint import HTML\nfrom weasyprint.document import Document\n\nfrom . import draw\n\nMAGIC_NUMBER = b'\\x89\\x50\\x4e\\x47\\x0d\\x0a\\x1a\\x0a'\n\n\ndef document_write_png(document, target=None, resolution=96, antialiasing=1,\n zoom=4/30, split_images=False):\n # Use temporary files because gs on Windows doesn’t accept binary on stdin\n with NamedTemporaryFile(delete=False) as pdf:\n document.write_pdf(pdf, zoom=zoom)\n command = (\n 'gs', '-q', '-sDEVICE=png16m', f'-dTextAlphaBits={antialiasing}',\n f'-dGraphicsAlphaBits={antialiasing}', '-dBATCH', '-dNOPAUSE',\n '-dPDFSTOPONERROR', f'-r{resolution / zoom}', '-dUsePDFX3Profile',\n '-sOutputFile=-', pdf.name)\n pngs = run(command, stdout=PIPE).stdout\n os.remove(pdf.name)\n\n error = pngs.split(MAGIC_NUMBER)[0].decode().strip() or 'no output'\n assert pngs.startswith(MAGIC_NUMBER), f'Ghostscript error: {error}'\n\n if split_images:\n assert target is None\n\n # TODO: use a different way to find PNG files in stream\n magic_numbers = pngs.count(MAGIC_NUMBER)\n if magic_numbers == 1:\n if target is None:\n return [pngs] if split_images else pngs\n png = io.BytesIO(pngs)\n else:\n images = [MAGIC_NUMBER + png for png in pngs[8:].split(MAGIC_NUMBER)]\n if split_images:\n return images\n images = [Image.open(io.BytesIO(image)) for image in images]\n width = max(image.width for image in images)\n height = sum(image.height for image in images)\n output_image = Image.new('RGBA', (width, height))\n top = 0\n for image in images:\n output_image.paste(image, (int((width - image.width) / 2), top))\n top += image.height\n png = io.BytesIO()\n output_image.save(png, format='png')\n\n png.seek(0)\n\n if target is None:\n return png.read()\n\n if hasattr(target, 'write'):\n shutil.copyfileobj(png, target)\n else:\n with open(target, 'wb') as fd:\n shutil.copyfileobj(png, fd)\n\n\ndef html_write_png(document, target=None, font_config=None, counter_style=None,\n resolution=96, **options):\n document = document.render(font_config, counter_style, **options)\n return document.write_png(target, resolution)\n\n\nDocument.write_png = document_write_png\nHTML.write_png = html_write_png\n\n\ndef test_filename(filename):\n return ''.join(\n character if character.isalnum() else '_'\n for character in filename[5:50]).rstrip('_')\n\n\n@pytest.fixture\ndef assert_pixels(request, *args, **kwargs):\n return lambda *args, **kwargs: draw.assert_pixels(\n test_filename(request.node.name), *args, **kwargs)\n\n\n@pytest.fixture\ndef assert_same_renderings(request, *args, **kwargs):\n return lambda *args, **kwargs: draw.assert_same_renderings(\n test_filename(request.node.name), *args, **kwargs)\n\n\n@pytest.fixture\ndef assert_different_renderings(request, *args, **kwargs):\n return lambda *args, **kwargs: draw.assert_different_renderings(\n test_filename(request.node.name), *args, **kwargs)\n\n\n@pytest.fixture\ndef assert_pixels_equal(request, *args, **kwargs):\n return lambda *args, **kwargs: draw.assert_pixels_equal(\n test_filename(request.node.name), *args, **kwargs)\n" }, { "path": "tests/css/__init__.py", "content": "\"\"\"Test CSS features.\"\"\"\n" }, { "path": "tests/css/test_common.py", "content": "\"\"\"Test the CSS parsing, cascade, inherited and computed values.\"\"\"\n\nfrom math import isclose\n\nimport pytest\n\nfrom weasyprint import CSS\nfrom weasyprint.css import find_stylesheets, get_all_computed_styles\nfrom weasyprint.urls import URLFetcher, path2url\n\nfrom ..testing_utils import ( # isort:skip\n BASE_URL, FakeHTML, assert_no_logs, capture_logs, resource_path)\n\n\n@assert_no_logs\ndef test_find_stylesheets():\n html = FakeHTML(resource_path('doc1.html'))\n\n sheets = list(find_stylesheets(\n html.wrapper_element, 'print', URLFetcher(), html.base_url, font_config=None,\n counter_style=None, color_profiles=None, page_rules=None, layers=None))\n assert len(sheets) == 2\n # Also test that stylesheets are in tree order.\n sheet_names = [\n sheet.base_url.rsplit('/', 1)[-1].rsplit(',', 1)[-1]\n for sheet in sheets]\n assert sheet_names == ['a%7Bcolor%3AcurrentColor%7D', 'doc1.html']\n\n rules = []\n for sheet in sheets:\n for sheet_rules in sheet.matcher.lower_local_name_selectors.values():\n for rule in sheet_rules:\n rules.append(rule)\n for rule in sheet.page_rules:\n rules.append(rule)\n assert len(rules) == 10\n\n # TODO: Test that the values are correct too.\n\n\n@assert_no_logs\ndef test_annotate_document():\n document = FakeHTML(resource_path('doc1.html'))\n document._ua_stylesheets = (\n lambda *_, **__: [CSS(resource_path('mini_ua.css'))])\n style_for = get_all_computed_styles(\n document, user_stylesheets=[CSS(resource_path('user.css'))])\n\n # Element objects behave as lists of their children.\n _head, body = document.etree_element\n h1, p, ul, div = body\n li_0, _li_1 = ul\n a, = li_0\n span1, = div\n span2, = span1\n\n h1 = style_for(h1)\n p = style_for(p)\n ul = style_for(ul)\n li_0 = style_for(li_0)\n div = style_for(div)\n after = style_for(a, 'after')\n a = style_for(a)\n span1 = style_for(span1)\n span2 = style_for(span2)\n\n assert h1['background_image'] == (\n ('url', path2url(resource_path('logo_small.png'))),)\n\n assert h1['font_weight'] == 700\n assert h1['font_size'] == 40 # 2em\n\n # x-large * initial = 3/2 * 16 = 24\n assert p['margin_top'] == (24, 'px')\n assert p['margin_right'] == (0, 'px')\n assert p['margin_bottom'] == (24, 'px')\n assert p['margin_left'] == (0, 'px')\n assert p['background_color'] == 'currentcolor'\n\n # 2em * 1.25ex = 2 * 20 * 1.25 * 0.8 = 40\n # 2.5ex * 1.25ex = 2.5 * 0.8 * 20 * 1.25 * 0.8 = 40\n # TODO: ex unit doesn't work with @font-face fonts, see computed_values.py\n # assert ul['margin_top'] == (40, 'px')\n # assert ul['margin_right'] == (40, 'px')\n # assert ul['margin_bottom'] == (40, 'px')\n # assert ul['margin_left'] == (40, 'px')\n\n assert ul['font_weight'] == 400\n # thick = 5px, 0.25 inches = 96*.25 = 24px\n assert ul['border_top_width'] == 0\n assert ul['border_right_width'] == 5\n assert ul['border_bottom_width'] == 0\n assert ul['border_left_width'] == 24\n\n assert li_0['font_weight'] == 700\n assert li_0['font_size'] == 8 # 6pt\n assert li_0['margin_top'] == (16, 'px') # 2em\n assert li_0['margin_right'] == (0, 'px')\n assert li_0['margin_bottom'] == (16, 'px')\n assert li_0['margin_left'] == (32, 'px') # 4em\n\n assert a['text_decoration_line'] == {'underline'}\n assert a['font_weight'] == 900\n assert a['font_size'] == 24 # 300% of 8px\n assert a['padding_top'] == (1, 'px')\n assert a['padding_right'] == (2, 'px')\n assert a['padding_bottom'] == (3, 'px')\n assert a['padding_left'] == (4, 'px')\n assert a['border_top_width'] == 42\n assert a['border_bottom_width'] == 42\n\n assert a['color'] == (1, 0, 0, 1)\n assert a['border_top_color'] == 'currentcolor'\n\n assert div['font_size'] == 40 # 2 * 20px\n assert span1['width'] == (160, 'px') # 10 * 16px (root default is 16px)\n assert span1['height'] == (400, 'px') # 10 * (2 * 20px)\n assert span2['font_size'] == 32\n\n # The href attr should be as in the source, not made absolute.\n assert after['content'] == (\n ('string', ' ['), ('string', 'home.html'), ('string', ']'))\n assert after['background_color'] == (1, 0, 0, 1)\n assert after['border_top_width'] == 42\n assert after['border_bottom_width'] == 3\n\n # TODO: much more tests here: test that origin and selector precedence\n # and inheritance are correct…\n\n\n@assert_no_logs\ndef test_important():\n document = FakeHTML(string='''\n \n

\n

\n

\n

\n

\n

\n ''')\n page, = document.render(stylesheets=[CSS(string='''\n body p:nth-child(1) { color: red }\n p:nth-child(2) { color: lime !important }\n\n p:nth-child(4) { color: lime !important }\n body p:nth-child(4) { color: red }\n ''')]).pages\n html, = page._page_box.children\n body, = html.children\n for paragraph in body.children:\n assert paragraph.style['color'] == (0, 1, 0, 1) # lime (light green)\n\n\n@assert_no_logs\n@pytest.mark.parametrize(('value', 'width'), [\n # Absolute units.\n ('96px', 96),\n ('1in', 96),\n ('72pt', 96),\n ('6pc', 96),\n ('2.54cm', 96),\n ('25.4mm', 96),\n ('101.6q', 96),\n # Font-relative units.\n ('1.1em', 11),\n ('1.1rem', 17.6),\n ('1.1ch', 11),\n ('1.1rch', 17.6),\n ('1.1cap', 11),\n ('1.1rcap', 17.6),\n ('1.5ex', 12),\n ('2rex', 25.6),\n ('1ic', 20),\n ('1ric', 32),\n ('1.1lh', 13.2),\n ('1.1rlh', 26.4),\n # Viewport-relative units.\n ('50vh', 50),\n ('50vw', 100),\n ('25vb', 25),\n ('1.25vi', 2.5),\n ('10vmin', 10),\n ('20vmax', 40),\n ('50lvh', 50),\n ('50lvw', 100),\n ('25lvb', 25),\n ('1.25lvi', 2.5),\n ('10lvmin', 10),\n ('20lvmax', 40),\n ('50svh', 50),\n ('50svw', 100),\n ('25svb', 25),\n ('1.25svi', 2.5),\n ('10svmin', 10),\n ('20svmax', 40),\n ('50dvh', 50),\n ('50dvw', 100),\n ('25dvb', 25),\n ('1.25dvi', 2.5),\n ('10dvmin', 10),\n ('20dvmax', 40),\n ('50pvh', 100),\n ('50pvw', 150),\n ('25pvb', 50),\n ('1.5pvi', 4.5),\n ('10pvmin', 20),\n ('20pvmax', 60),\n])\ndef test_units(value, width):\n document = FakeHTML(base_url=BASE_URL, string='''\n \n \n \n

\n

\n ''' % (value, value.upper()))\n page, = document.render().pages\n html, = page._page_box.children\n body, = html.children\n p1, p2 = body.children\n assert p1.margin_left == p2.margin_left\n assert isclose(p1.margin_left, width, rel_tol=0.01)\n\n\n@assert_no_logs\n@pytest.mark.parametrize('property', ['line-height', 'font-size'])\ndef test_recursive_lh(property):\n document = FakeHTML(base_url=BASE_URL, string='''\n \n a''' % (property, property))\n document.render().pages\n document = FakeHTML(base_url=BASE_URL, string='''\n \n a''' % (property, property))\n document.render().pages\n\n\n@pytest.mark.parametrize(('media', 'width', 'warning'), [\n ('@media screen { @page { size: 10px } }', 20, False),\n ('@media print { @page { size: 10px } }', 10, False),\n ('@media (\"unknown content\") { @page { size: 10px } }', 20, True),\n])\ndef test_media_queries(media, width, warning):\n document = FakeHTML(string='

ab')\n with capture_logs() as logs:\n page, = document.render(\n stylesheets=[CSS(string='@page{size:20px}%s' % media)]).pages\n html, = page._page_box.children\n assert html.width == width\n assert (logs if warning else not logs)\n" }, { "path": "tests/css/test_counters.py", "content": "\"\"\"Test CSS counters.\"\"\"\n\nimport pytest\n\nfrom ..testing_utils import ( # isort:skip\n FakeHTML, assert_no_logs, assert_tree, parse_all, render_pages)\n\nRENDER = FakeHTML(string='')._ua_counter_style()[0].render_value\n\n\n@assert_no_logs\ndef test_counters_1():\n assert_tree(parse_all('''\n \n

\n

\n

\n

\n

\n

\n

\n

\n

\n

\n

\n

'''), [\n ('p', 'Block', [\n ('p', 'Line', [\n ('p::before', 'Inline', [\n ('p::before', 'Text', counter)])])])\n for counter in '0 1 3 2 4 6 -11 -9 -7 44 46 48'.split()])\n\n\n@assert_no_logs\ndef test_counters_2():\n assert_tree(parse_all('''\n
    \n
  1. \n
  2. \n
  3. \n
    4. \n
    1. \n
    2. \n
    3. \n
    5. \n
  5. \n
'''), [\n ('ol', 'Block', [\n ('li', 'Block', [\n ('li', 'Line', [\n ('li::marker', 'Inline', [\n ('li::marker', 'Text', '1. ')])])]),\n ('li', 'Block', [\n ('li', 'Line', [\n ('li::marker', 'Inline', [\n ('li::marker', 'Text', '2. ')])])]),\n ('li', 'Block', [\n ('li', 'Line', [\n ('li::marker', 'Inline', [\n ('li::marker', 'Text', '3. ')])])]),\n ('li', 'Block', [\n ('li', 'Block', [\n ('li', 'Line', [\n ('li::marker', 'Inline', [\n ('li::marker', 'Text', '4. ')])])]),\n ('ol', 'Block', [\n ('li', 'Block', [\n ('li', 'Line', [\n ('li::marker', 'Inline', [\n ('li::marker', 'Text', '1. ')])])]),\n ('li', 'Block', [\n ('li', 'Line', [\n ('li::marker', 'Inline', [\n ('li::marker', 'Text', '1. ')])])]),\n ('li', 'Block', [\n ('li', 'Line', [\n ('li::marker', 'Inline', [\n ('li::marker', 'Text', '2. ')])])])])]),\n ('li', 'Block', [\n ('li', 'Line', [\n ('li::marker', 'Inline', [\n ('li::marker', 'Text', '5. ')])])])])])\n\n\n@assert_no_logs\ndef test_counters_3():\n assert_tree(parse_all('''\n \n
\n

\n

\n

\n
\n

'''), [\n ('div', 'Block', [\n ('p', 'Block', [\n ('p', 'Line', [\n ('p::marker', 'Inline', [\n ('p::marker', 'Text', '1. ')])])]),\n ('p', 'Block', [\n ('p', 'Line', [\n ('p::marker', 'Inline', [\n ('p::marker', 'Text', '2. ')])])]),\n ('p', 'Block', [\n ('p', 'Line', [\n ('p::marker', 'Inline', [\n ('p::marker', 'Text', '-55. ')])])])]),\n ('p', 'Block', [\n ('p', 'Line', [\n ('p::marker', 'Inline', [\n ('p::marker', 'Text', '1. ')])])])])\n\n\n@assert_no_logs\ndef test_counters_4():\n assert_tree(parse_all('''\n \n \n

\n

\n

\n

\n
\n

\n
\n '''), [\n ('section', 'Block', [\n ('section', 'Block', [\n ('section', 'Line', [\n ('section::before', 'Inline', [])])]),\n ('h1', 'Block', [\n ('h1', 'Line', [\n ('h1::before', 'Inline', [\n ('h1::before', 'Text', '1')])])]),\n ('h1', 'Block', [\n ('h1', 'Line', [\n ('h1::before', 'Inline', [\n ('h1::before', 'Text', '2')])])]),\n ('section', 'Block', [\n ('section', 'Block', [\n ('section', 'Line', [\n ('section::before', 'Inline', [])])]),\n ('h1', 'Block', [\n ('h1', 'Line', [\n ('h1::before', 'Inline', [\n ('h1::before', 'Text', '2.1')])])]),\n ('h1', 'Block', [\n ('h1', 'Line', [\n ('h1::before', 'Inline', [\n ('h1::before', 'Text', '2.2')])])])]),\n ('h1', 'Block', [\n ('h1', 'Line', [\n ('h1::before', 'Inline', [\n ('h1::before', 'Text', '3')])])])])])\n\n\n@assert_no_logs\ndef test_counters_5():\n assert_tree(parse_all('''\n \n
\n \n Scope created now, deleted after the div\n \n
\n

'''), [\n ('div', 'Block', [\n ('div', 'Line', [\n ('span', 'Inline', [\n ('span', 'Text',\n 'Scope created now, deleted after the div ')])])]),\n ('p', 'Block', [\n ('p', 'Line', [\n ('p::before', 'Inline', [\n ('p::before', 'Text', '0')])])])])\n\n\n@assert_no_logs\ndef test_counters_6():\n # counter-increment may interfere with display: list-item\n assert_tree(parse_all('''\n

'''), [\n ('p', 'Block', [\n ('p', 'Line', [\n ('p::marker', 'Inline', [\n ('p::marker', 'Text', '0. ')])])])])\n\n\n@assert_no_logs\ndef test_counters_7():\n # Regression test for #827.\n # Test that counters are case-sensitive.\n assert_tree(parse_all('''\n \n

\n

\n

'''), [\n ('p', 'Block', [\n ('p', 'Line', [\n ('p::before', 'Inline', [\n ('p::before', 'Text', counter)])])])\n for counter in '2.0 2.3 4.3'.split()])\n\n\n@assert_no_logs\ndef test_counters_8():\n assert_tree(parse_all('''\n \n

\n

'''), 2 * [\n ('p', 'Block', [\n ('p::before', 'Block', [\n ('p::marker', 'Block', [\n ('p::marker', 'Line', [\n ('p::marker', 'Text', '• ')])]),\n ('p::before', 'Block', [\n ('p::before', 'Line', [\n ('p::before', 'Text', 'a')])])])])])\n\n\n@pytest.mark.xfail\n@assert_no_logs\ndef test_counters_9():\n page, = render_pages('''\n
    \n
  1. \n
  2. \n
      \n
    1. \n
    2. \n
    \n
    3. \n
  3. \n
\n ''')\n html, = page._page_box.children\n body, = html.children\n ol1, = body.children\n oli1, oli2, oli3 = ol1.children\n marker, ol2 = oli2.children\n oli21, oli22 = ol2.children\n assert oli1.children[0].children[0].children[0].text == '1. '\n assert oli2.children[0].children[0].children[0].text == '2. '\n assert oli21.children[0].children[0].children[0].text == '1. '\n assert oli22.children[0].children[0].children[0].text == '2. '\n assert oli3.children[0].children[0].children[0].text == '3. '\n\n\n@assert_no_logs\ndef test_counter_styles_1():\n assert_tree(parse_all('''\n \n

\n

\n

\n

\n

\n

\n

\n '''), [\n ('p', 'Block', [\n ('p', 'Line', [\n ('p::before', 'Inline', [\n ('p::before', 'Text', counter)])])])\n for counter in '-- • ◦ ▪ -7 Counter:-6 -5:Counter'.split()])\n\n\n@assert_no_logs\ndef test_counter_styles_2():\n assert_tree(parse_all('''\n \n

\n

\n

\n

\n

\n

\n

\n

\n

\n

\n

\n

\n

\n

\n

\n

\n

\n

\n '''), [\n ('p', 'Block', [\n ('p', 'Line', [\n ('p::before', 'Inline', [\n ('p::before', 'Text', counter)])])])\n for counter in '''-1986 -1985 -11 -10 -9 -8 -1 00 01 02 09 10 11\n 99 100 101 4135 4136'''.split()])\n\n\n@assert_no_logs\ndef test_counter_styles_3():\n assert [RENDER(value, 'decimal-leading-zero') for value in [\n -1986, -1985,\n -11, -10, -9, -8,\n -1, 0, 1, 2,\n 9, 10, 11,\n 99, 100, 101,\n 4135, 4136\n ]] == '''\n -1986 -1985 -11 -10 -9 -8 -1 00 01 02 09 10 11\n 99 100 101 4135 4136\n '''.split()\n\n\n@assert_no_logs\ndef test_counter_styles_4():\n assert [RENDER(value, 'lower-roman') for value in [\n -1986, -1985,\n -1, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12,\n 49, 50,\n 389, 390,\n 3489, 3490, 3491,\n 4999, 5000, 5001\n ]] == '''\n -1986 -1985 -1 0 i ii iii iv v vi vii viii ix x xi xii\n xlix l ccclxxxix cccxc mmmcdlxxxix mmmcdxc mmmcdxci\n 4999 5000 5001\n '''.split()\n\n\n@assert_no_logs\ndef test_counter_styles_5():\n assert [RENDER(value, 'upper-roman') for value in [\n -1986, -1985,\n -1, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12,\n 49, 50,\n 389, 390,\n 3489, 3490, 3491,\n 4999, 5000, 5001\n ]] == '''\n -1986 -1985 -1 0 I II III IV V VI VII VIII IX X XI XII\n XLIX L CCCLXXXIX CCCXC MMMCDLXXXIX MMMCDXC MMMCDXCI\n 4999 5000 5001\n '''.split()\n\n\n@assert_no_logs\ndef test_counter_styles_6():\n assert [RENDER(value, 'lower-alpha') for value in [\n -1986, -1985,\n -1, 0, 1, 2, 3, 4,\n 25, 26, 27, 28, 29,\n 2002, 2003\n ]] == '''\n -1986 -1985 -1 0 a b c d y z aa ab ac bxz bya\n '''.split()\n\n\n@assert_no_logs\ndef test_counter_styles_7():\n assert [RENDER(value, 'upper-alpha') for value in [\n -1986, -1985,\n -1, 0, 1, 2, 3, 4,\n 25, 26, 27, 28, 29,\n 2002, 2003\n ]] == '''\n -1986 -1985 -1 0 A B C D Y Z AA AB AC BXZ BYA\n '''.split()\n\n\n@assert_no_logs\ndef test_counter_styles_8():\n assert [RENDER(value, 'lower-latin') for value in [\n -1986, -1985,\n -1, 0, 1, 2, 3, 4,\n 25, 26, 27, 28, 29,\n 2002, 2003\n ]] == '''\n -1986 -1985 -1 0 a b c d y z aa ab ac bxz bya\n '''.split()\n\n\n@assert_no_logs\ndef test_counter_styles_9():\n assert [RENDER(value, 'upper-latin') for value in [\n -1986, -1985,\n -1, 0, 1, 2, 3, 4,\n 25, 26, 27, 28, 29,\n 2002, 2003\n ]] == '''\n -1986 -1985 -1 0 A B C D Y Z AA AB AC BXZ BYA\n '''.split()\n\n\n@assert_no_logs\ndef test_counter_styles_10():\n assert [RENDER(value, 'georgian') for value in [\n -1986, -1985,\n -1, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12,\n 20, 30, 40, 50, 60, 70, 80, 90, 100,\n 200, 300, 400, 500, 600, 700, 800, 900, 1000,\n 2000, 3000, 4000, 5000, 6000, 7000, 8000, 9000, 10000,\n 19999, 20000, 20001\n ]] == '''\n -1986 -1985 -1 0 ა\n ბ გ დ ე ვ ზ ჱ თ ი ია იბ\n კ ლ მ ნ ჲ ო პ ჟ რ\n ს ტ ჳ ფ ქ ღ ყ შ ჩ\n ც ძ წ ჭ ხ ჴ ჯ ჰ ჵ\n ჵჰშჟთ 20000 20001\n '''.split()\n\n\n@assert_no_logs\ndef test_counter_styles_11():\n assert [RENDER(value, 'armenian') for value in [\n -1986, -1985,\n -1, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12,\n 20, 30, 40, 50, 60, 70, 80, 90, 100,\n 200, 300, 400, 500, 600, 700, 800, 900, 1000,\n 2000, 3000, 4000, 5000, 6000, 7000, 8000, 9000,\n 9999, 10000, 10001\n ]] == '''\n -1986 -1985 -1 0 Ա\n Բ Գ Դ Ե Զ Է Ը Թ Ժ ԺԱ ԺԲ\n Ի Լ Խ Ծ Կ Հ Ձ Ղ Ճ\n Մ Յ Ն Շ Ո Չ Պ Ջ Ռ\n Ս Վ Տ Ր Ց Ւ Փ Ք\n ՔՋՂԹ 10000 10001\n '''.split()\n\n\n@assert_no_logs\n@pytest.mark.parametrize(('arguments', 'values'), [\n ('cyclic \"a\" \"b\" \"c\"', ('a ', 'b ', 'c ', 'a ')),\n ('symbolic \"a\" \"b\"', ('a ', 'b ', 'aa ', 'bb ')),\n ('\"a\" \"b\"', ('a ', 'b ', 'aa ', 'bb ')),\n ('alphabetic \"a\" \"b\"', ('a ', 'b ', 'aa ', 'ab ')),\n ('fixed \"a\" \"b\"', ('a ', 'b ', '3 ', '4 ')),\n ('numeric \"0\" \"1\" \"2\"', ('1 ', '2 ', '10 ', '11 ')),\n])\ndef test_counter_symbols(arguments, values):\n page, = render_pages('''\n \n
    \n
  1. abc
    2. \n
  2. abc
    3. \n
  3. abc
    4. \n
  4. abc
    5. \n
\n ''' % arguments)\n html, = page.children\n body, = html.children\n ol, = body.children\n li_1, li_2, li_3, li_4 = ol.children\n assert li_1.children[0].children[0].children[0].text == values[0]\n assert li_2.children[0].children[0].children[0].text == values[1]\n assert li_3.children[0].children[0].children[0].text == values[2]\n assert li_4.children[0].children[0].children[0].text == values[3]\n\n\n@assert_no_logs\n@pytest.mark.parametrize(('style_type', 'values'), [\n ('decimal', ('1. ', '2. ', '3. ', '4. ')),\n ('\"/\"', ('/', '/', '/', '/')),\n])\ndef test_list_style_types(style_type, values):\n page, = render_pages('''\n \n
    \n
  1. abc
    2. \n
  2. abc
    3. \n
  3. abc
    4. \n
  4. abc
    5. \n
\n ''' % style_type)\n html, = page.children\n body, = html.children\n ol, = body.children\n li_1, li_2, li_3, li_4 = ol.children\n assert li_1.children[0].children[0].children[0].text == values[0]\n assert li_2.children[0].children[0].children[0].text == values[1]\n assert li_3.children[0].children[0].children[0].text == values[2]\n assert li_4.children[0].children[0].children[0].text == values[3]\n\n\ndef test_list_style_type_empty_string():\n # Regression test for #1883.\n render_pages('