WeasyPrint Documentation

Api Reference

API Reference
=============

.. currentmodule:: weasyprint

This page is for WeasyPrint |version|. See :doc:changelog </changelog> for
older versions.

API Stability
-------------

Everything described here is considered “public”: this is what you can rely
on. We will try to maintain backward-compatibility, and we really often do, but
there is no hard promise.

Anything else should not be used outside of WeasyPrint itself. We reserve
the right to change it or remove it at any point. Use it at your own risk,
or have dependency to a specific WeasyPrint version.

Versioning
----------

WeasyPrint provides frequent major releases, and minor releases with only bug
fixes. Versioning is close to what many browsers do, including Firefox and
Chrome: big major numbers, small minor numbers.

Even if each version does not break the API, each version does break the way
documents are rendered, which is what really matters at the end. Providing
minor versions would give the illusion that developers can just update
WeasyPrint without checking that everything works.

Unfortunately, we have the same problem as the other browsers: when a new
version is released, most of the user's websites are rendered exactly the same,
but a small part is not. And the only ways to know that, for web developers,
are to read the changelog and to check that their pages are correctly rendered.

More about this choice can be found in
issue #900_.

.. _#900: https://github.com/Kozea/WeasyPrint/issues/900

Command-line API
----------------

.. autofunction:: weasyprint.__main__.main(argv=sys.argv)

Python API
----------

.. autoclass:: HTML(input, kwargs)
:members:
.. autoclass:: CSS(input, kwargs)
.. autoclass:: Attachment(input, kwargs)
.. autodata:: DEFAULT_OPTIONS

.. module:: weasyprint.document
.. autoclass:: Document
:members:
.. autoclass:: DocumentMetadata()
:members:
.. autoclass:: Page()
:members:
:exclude-members: paint

.. module:: weasyprint.urls
.. autoclass:: URLFetcher
:members:
:member-order: bysource
.. autoclass:: URLFetcherResponse
.. autoclass:: FatalURLFetchingError

.. module:: weasyprint.text.fonts
.. autoclass:: FontConfiguration()

.. module:: weasyprint.css.counters
.. autoclass:: CounterStyle()

Supported Features
------------------

URLs
~~~~

WeasyPrint can read normal files, HTTP, FTP and data URIs_. It will follow
HTTP redirects but more advanced features like cookies and authentication
are currently not supported, although a custom :ref:URL fetcher <URL Fetchers> can help.

.. _data URIs: https://en.wikipedia.org/wiki/Data_URI_scheme

HTML
~~~~

Supported HTML Tags
+++++++++++++++++++

Many HTML elements are implemented in CSS through the HTML5
User-Agent stylesheet_.

Some elements need special treatment:

* The `<base>element, if present, determines the base for relative URLs. * CSS stylesheets can be embedded in<style>elements or linked by<link rel=stylesheet>elements. *<img>, <embed> or <object>elements accept images either in raster formats supported by Pillow_ (including PNG, JPEG, GIF, ...) or in SVG. SVG images are not rasterized but rendered as vectors in the PDF output.

HTML presentational hints_ are not supported by default, but most of them can be supported:

* by using the --presentational-hintsCLI parameter, or * by setting thepresentational_hints parameter of the HTML.renderorHTML.write_* methods to True.

Presentational hints include a wide array of attributes that direct styling in HTML, including fontcolor and size, list attributes like typeandstart, various table alignment attributes, and others. If the document generated by WeasyPrint is missing some of the features you expect from the HTML, try to enable this option.

.. _User-Agent stylesheet: https://github.com/Kozea/WeasyPrint/blob/main/weasyprint/css/html5_ua.css .. _presentational hints: https://www.w3.org/TR/html5/rendering.html#presentational-hints .. _Pillow: https://python-pillow.org/

Stylesheet Origins ++++++++++++++++++

HTML documents are rendered with stylesheets from three origins:

* The HTML5 user agent stylesheet_ (defines the default appearance of HTML elements); * Author stylesheets embedded in the document in<style>elements or linked by<link rel=stylesheet>elements; * User stylesheets provided in the API.

Keep in mind that user stylesheets have a lower priority than author stylesheets in the cascade_, unless you use!important_ in declarations to raise their priority.

.. _user agent stylesheet: https://github.com/Kozea/WeasyPrint/blob/main/weasyprint/css/html5_ua.css .. _cascade: https://www.w3.org/TR/CSS21/cascade.html#cascading-order .. _!important: https://www.w3.org/TR/CSS21/cascade.html#important-rules

PDF ~~~

In addition to text, raster and vector graphics, WeasyPrint’s PDF files can contain hyperlinks, bookmarks, attachments and forms.

Hyperlinks will be clickable in PDF viewers that support them. They can be either internal, to another part of the same document (eg.<a href="#pdf">) or external, to an URL. External links are resolved to absolute URLs:<a href="/blog-articles/">on the CourtBouillon website would always point to https://www.courtbouillon.org/blog-articles/ in PDF files.

PDF bookmarks are also called outlines and are generally shown in a sidebar. Clicking on an entry scrolls the matching part of the document into view. By default all<h1> to <h6>titles generate bookmarks, but this can be controlled withPDF bookmarks_.)

Attachments are related files, embedded in the PDF itself. They can be specified through<link rel=attachment>elements to add resources globally or through regular links with<a rel=attachment>to attach a resource that can be saved by clicking on said link. Thetitleattribute can be used as description of the attachment.

Generated documents can also include PDF forms, using the appearance: autoCSS property or the--pdf-forms CLI option.

The generation of PDF/A and PDF/UA documents is supported. However, the generated documents are not guaranteed to be valid, and users have the responsibility to check that they follow the rules listed by the related specifications.

Fonts ~~~~~

WeasyPrint can use any font that Pango_ can find installed on the system. Fonts are automatically embedded in PDF files and are subset by default to only include the glyphs used in the PDF. Subsetting is done with hb-subset_ when available on the system, or by the slower fontTools_ library as a fallback.

Pango_ always uses Fontconfig_ to access fonts, even on Windows and macOS. You can list the available fonts thanks to thefc-listcommand, and know which font is matched by a given pattern thanks tofc-match. Copying a font file into the~/.local/share/fontsdirectory is generally enough to install a new font. WeasyPrint should support the major font formats handled by HarfBuzz_.

WeasyPrint follows the Fontconfig_ configuration of the system. This default configuration is often useful for many cases: font fallbacks for missing glyphs, aliases for standard font families like "serif" or "monospace", colored variants for emojis, etc. But some of these default rules can sometimes interfere with CSS rules, and it may be interesting to disable them if you need to tweak details about font management.

When a Unicode code point is not supported by a font and its fallbacks, the font’s .notdef glyph_ is displayed instead, and a warning is displayed in logs. Because of the way Pango handles this case, the .notdef glyph may be rendered with an incorrect width (advance), but the layout of the other glyphs is correct. Text search and selection work as if the glyph was available.

.. _hb-subset: https://harfbuzz.github.io/harfbuzz-hb-subset.html .. _fontTools: https://fonttools.readthedocs.io/en/latest/ .. _Pango: https://www.pango.org/ .. _Fontconfig: https://www.freedesktop.org/wiki/Software/fontconfig/ .. _HarfBuzz: https://harfbuzz.github.io/ .. _.notdef glyph: https://en.wikipedia.org/wiki/Notdef_glyph

CSS ~~~

WeasyPrint supports many of the CSS specifications_ written by the W3C. You will find in this chapter a comprehensive list of the specifications or drafts with at least one feature implemented in WeasyPrint.

.. _CSS specifications: https://www.w3.org/Style/CSS/current-work

CSS Level 2 Revision 1 ++++++++++++++++++++++

The CSS Level 2 Revision 1_ specification, best known as CSS 2.1, is pretty well supported by WeasyPrint. Since version 0.11, it passes the famousAcid2
Test_.

The CSS 2.1 features listed here are not supported:

* On tables: visibility: collapse_. * Minimum and maximum height_ on table-related boxes. * Minimum and maximum width_ and height_ on page-margin boxes. * Conformingfont matching algorithm_. Currently font-familyis passed as-is to Pango. * Right-to-left orbi-directional text_. *System colors_ and system fonts_. The former are deprecated in CSS Color
Module Level 3_.

.. _CSS Level 2 Revision 1: https://www.w3.org/TR/CSS21/ .. _Acid2 Test: https://www.webstandards.org/files/acid2/test.html .. _empty-cells: https://www.w3.org/TR/CSS21/tables.html#empty-cells .. _visibility\: collapse: https://www.w3.org/TR/CSS21/tables.html#dynamic-effects .. _width: https://www.w3.org/TR/CSS21/visudet.html#min-max-widths .. _height: https://www.w3.org/TR/CSS21/visudet.html#min-max-heights .. _font matching algorithm: https://www.w3.org/TR/CSS21/fonts.html#algorithm .. _Bi-directional text: https://www.w3.org/TR/CSS21/visuren.html#direction .. _System colors: https://www.w3.org/TR/CSS21/ui.html#system-colors .. _system fonts: https://www.w3.org/TR/CSS21/fonts.html#propdef-font .. _CSS Color Module Level 3: https://www.w3.org/TR/css-color-3/

To the best of our knowledge, everything else that applies to the print media is supported. Please report a bug if you find this list incomplete.

Selectors Level 3 / 4 +++++++++++++++++++++

With the exceptions noted here, all Selectors Level 3_ are supported.

PDF is generally not interactive. The :hover, :active, :focus,:target and :visitedpseudo-classes are accepted as valid but never match anything.

Everything in Selectors Level 4_ is supported, except:

- :dir, - input pseudo-classes (:valid, :invalid…), - column selector (||, :nth-col(), :nth-last-col()).

.. _Selectors Level 3: https://www.w3.org/TR/selectors-3/ .. _Selectors Level 4: https://www.w3.org/TR/selectors-4/

CSS Text Module Level 3 / 4 +++++++++++++++++++++++++++

The CSS Text Module Level 3_ and CSS Text Module Level 4_ are working drafts defining "properties for text manipulation" and covering "line breaking, justification and alignment, white space handling, and text transformation".

Among their features, some are already included in CSS 2.1, sometimes with missing or different values (text-indent, text-align,letter-spacing, word-spacing, text-transform, white-space).

New properties defined in Level 3 are supported:

- the overflow-wrap property replacing word-wrap; - thebreak-all value of the word-break property (see #1153_); - thefull-width value of the text-transformproperty; and - thestart, end and justify-all values of the text-alignproperty; - thetext-align-last and text-justifyproperties; and - thetab-size property.

Properties controlling hyphenation_ are supported by WeasyPrint:

- hyphens, -hyphenate-character, -hyphenate-limit-chars, and -hyphenate-limit-zone.

To get automatic hyphenation, you to set it to autoand have thelangHTML attribute set to one of the languagessupported by Pyphen_.

.. code-block:: html

<!doctype html> <html lang=en> <style> html { hyphens: auto } </style> …

Automatic hyphenation can be disabled again with the manual value:

.. code-block:: css

html { hyphens: auto } a[href]::after { content: ' [' attr(href) ']'; hyphens: manual }

The other features provided by CSS Text Module Level 3_ are not supported:

- the line-breakproperty; - thematch-parent value of the text-alignproperty; - thetext-indent and hanging-punctuation properties.

The other features provided by CSS Text Module Level 4_ are not supported:

- the text-space-collapse and text-space-trimproperties; - thetext-wrap, wrap-before, wrap-after and wrap-insideproperties; - thetext-alignproperty with an alignment character; - thepre-wrap-auto value of the white-spaceproperty; and - thetext-spacing property.

.. _#1153: https://github.com/Kozea/WeasyPrint/issues/1153 .. _supported by Pyphen: https://github.com/Kozea/Pyphen/tree/main/pyphen/dictionaries .. _hyphenation: https://www.w3.org/TR/css-text-3/#hyphenation .. _CSS Text Module Level 3: https://www.w3.org/TR/css-text-3/ .. _CSS Text Module Level 4: https://www.w3.org/TR/css-text-4/

CSS Fonts Module Level 3 / 4 ++++++++++++++++++++++++++++

The CSS Fonts Module Level 3_ is a candidate recommendation describing "how font properties are specified and how font resources are loaded dynamically".

WeasyPrint supports the font-size, font-stretch, font-styleandfont-weight properties, coming from CSS 2.1.

WeasyPrint also supports the following font features added in Level 3: -font-kerning, -font-variant-ligatures, -font-variant-position, -font-variant-caps, -font-variant-numeric, -font-variant-east-asian, -font-feature-settings, and -font-language-override.

font-familyis supported. The string is given to Pango that tries to find a matching font in a way different from what is defined in the recommendation, but that should not be a problem for common use.

The shorthand font and font-variant properties are supported.

WeasyPrint supports the @font-face rule.

WeasyPrint does not support the @font-feature-valuesrule and the values offont-variant-alternates other than normalandhistorical-forms.

From CSS Fonts Module Level 4_ we only support thefont-variation-settings property enabling specific font variations.

.. _CSS Fonts Module Level 3: https://www.w3.org/TR/css-fonts-3/ .. _CSS Fonts Module Level 4: https://www.w3.org/TR/css-fonts-4/

CSS Paged Media Module Level 3 ++++++++++++++++++++++++++++++

The CSS Paged Media Module Level 3_ is a working draft including features for paged media "describing how:

- page breaks are created and avoided; - the page properties such as size, orientation, margins, border, and padding are specified; - headers and footers are established within the page margins; - content such as page counters are placed in the headers and footers; and - orphans and widows can be controlled."

All the features of this draft are available, including:

- the @page rule and the :left, :right, :first and :blankselectors; - the page margin boxes; - the page-based counters (with known limitations#93_); - the pagesize, bleed and marksproperties; - the named pages.

.. _CSS Paged Media Module Level 3: https://drafts.csswg.org/css-page-3/ .. _#93: https://github.com/Kozea/WeasyPrint/issues/93

CSS Generated Content for Paged Media Module ++++++++++++++++++++++++++++++++++++++++++++

The CSS Generated Content for Paged Media Module_ (GCPM) is a working draft defining "new properties and values, so that authors may bring new techniques (running headers and footers, footnotes, page selection) to paged media".

Page selectors_ are supported by WeasyPrint. You can select pages according to their position in the document:

.. code-block:: css

@page :nth(3) { background: red } / Third page / @page :nth(2n+1) { background: green } / Odd pages / @page :nth(1 of chapter) { background: blue } / First pages of chapters /

You can also use running elements_ to put HTML boxes into the page margins (but thestart parameter of element() is not supported).

Footnotes_ are supported. You can put a box in the footnote area using thefloat: footnoteproperty. Footnote markers and footnote calls can be defined using the::footnote-marker and ::footnote-callpseudo-elements. You can also change the way footnotes are displayed using thefootnote-display property (compactis not supported), and influence over the rendering of difficult pages withfootnote-policy.

.. _CSS Generated Content for Paged Media Module: https://www.w3.org/TR/css-gcpm-3/ .. _Page selectors: https://www.w3.org/TR/css-gcpm-3/#document-page-selectors .. _running elements: https://www.w3.org/TR/css-gcpm-3/#running-elements .. _Footnotes: https://www.w3.org/TR/css-gcpm-3/#footnotes

CSS Generated Content Module Level 3 ++++++++++++++++++++++++++++++++++++

The CSS Generated Content Module Level 3_ is a working draft helping "authors [who] sometimes want user agents to render content that does not come from the document tree. One familiar example of this is numbered headings […]. Similarly, authors may want the user agent to insert the word "Figure" before the caption of a figure […], or replacing elements with images or other multimedia content."

Named strings_ are supported by WeasyPrint. You can define strings related to the first or last element of a type present on a page, and display these strings in page borders. This feature is really useful to add the title of the current chapter at the top of the pages of a book for example.

The named strings can embed static strings, counters, cross-references, tag contents and tag attributes.

.. code-block:: css

@top-center { content: string(chapter) } h2 { string-set: chapter "Current chapter: " content() }

Cross-references_ retrieve counter or content values from targets (anchors or identifiers) in the current document:

.. code-block:: css

a::after { content: ", on page " target-counter(attr(href), page) } a::after { content: ", see " target-text(attr(href)) }

In particular, target-counter() and target-text()are useful when it comes to tables of contents (seean example_).

You can also control PDF bookmarks_ with WeasyPrint. Using thebookmark-level, bookmark-label and bookmark-stateproperties, you can add bookmarks that will be available in your PDF reader.

Bookmarks have already been added in the WeasyPrint's user agent stylesheet_, so your generated documents will automatically have bookmarks on headers (from<h1> to <h6>). But for example, if you have only one top-level <h1>and do not wish to include it in the bookmarks, add this in your stylesheet:

.. code-block:: css

h1 { bookmark-level: none }

Leaders_ are also supported:

.. code-block:: css

li a::after { content: ' ' leader(dotted) ' ' target-counter(attr(href), page); }

The other features of this module are not implemented:

- quotes (content: *-quote);

.. _CSS Generated Content Module Level 3: https://www.w3.org/TR/css-content-3/ .. _Quotes: https://www.w3.org/TR/css-content-3/#quotes .. _Named strings: https://www.w3.org/TR/css-content-3/#named-strings .. _Cross-references: https://www.w3.org/TR/css-content-3/#cross-references .. _an example: https://github.com/Kozea/WeasyPrint/pull/652#issuecomment-403276559 .. _PDF bookmarks: https://www.w3.org/TR/css-content-3/#bookmark-generation .. _user agent stylesheet: https://github.com/Kozea/WeasyPrint/blob/main/weasyprint/css/html5_ua.css .. _Leaders: https://www.w3.org/TR/css-content-3/#leaders

CSS Color Module Level 4 / 5 ++++++++++++++++++++++++++++

The CSS Color Module Level 4_ is a recommendation defining "CSS properties which allow authors to specify the foreground color and opacity of the text content of an element". Its main goal is to specify how colors are defined, including color keywords and many color notations including#rgba, rgb(), hsl(), hwb(), lab(), etc. The standardcolor()function gives a common way to define colors giving their color space. Opacity and alpha compositing are also defined in this document.

This recommendation is fully implemented in WeasyPrint, except the deprecated System Colors.

The CSS Color Module Level 5_ is a working draft adding "color modification functions, custom color spaces (ICC profiles),contrast-color(), light-dark()anddevice-cmyk()" to level 4.

WeasyPrint supports the light-dark() and device-cmyk()properties, and the@color-profile at-rule.

WeasyPrint does not support the color-mix() and contrast-color() properties.

.. _CSS Color Module Level 4: https://www.w3.org/TR/css-color-4/ .. _CSS Color Module Level 5: https://www.w3.org/TR/css-color-5/

CSS Transforms Module Level 1 +++++++++++++++++++++++++++++

The CSS Transforms Module Level 1_ working draft "describes a coordinate system within each element is positioned. This coordinate space can be modified with the transform property. Using transform, elements can be translated, rotated and scaled in two or three dimensional space."

WeasyPrint supports the transform and transform-originproperties, and all the 2D transformations (matrix, rotate, translate,translateX, translateY, scale, scaleX, scaleY, skew,skewX, skewY).

WeasyPrint does not support the transform-style, perspective,perspective-origin and backface-visibilityproperties, and all the 3D transformations (matrix3d, rotate3d, rotateX, rotateY,rotateZ, translate3d, translateZ, scale3d, scaleZ).

.. _CSS Transforms Module Level 1: https://drafts.csswg.org/css-transforms-1/

CSS Backgrounds and Borders Module Level 3 ++++++++++++++++++++++++++++++++++++++++++

The CSS Backgrounds and Borders Module Level 3_ is a candidate recommendation defining properties dealing "with the decoration of the border area and with the background of the content, padding and border areas".

The border part_ of this module is supported, as it is already included in the the CSS 2.1 specification.

WeasyPrint supports the background part_ of this module (allowing multiple background layers per box), including thebackground, background-color,background-image, background-repeat, background-attachment,background-position, background-clip, background-originandbackground-size properties.

WeasyPrint supports the rounded corners part_ of this module, including theborder-radius property.

WeasyPrint supports the border images part_ of this module, including theborder-image, border-image-source, border-image-slice,border-image-width, border-image-outset and border-image-repeatproperties.

WeasyPrint supports the box shadow part_ of this module, including thebox-shadowproperty. Blur should be avoided, as it is approximated using gradients, which may be rendered poorly by PDF readers, and are limited in some extreme situations (very large or uneven border radii, very large blur regions, etc.) Real Gaussian blur requires raster images that are not adapted to WeasyPrint’s vector PDF output.

.. _CSS Backgrounds and Borders Level 3: https://www.w3.org/TR/css-backgrounds-3/ .. _border part: https://www.w3.org/TR/css-backgrounds-3/#borders .. _background part: https://www.w3.org/TR/css-backgrounds-3/#backgrounds .. _rounded corners part: https://www.w3.org/TR/css-backgrounds-3/#corners .. _border images part: https://www.w3.org/TR/css-backgrounds-3/#border-images .. _box shadow part: https://www.w3.org/TR/css-backgrounds-3/#box-shadow

CSS Image Values and Replaced Content Module Level 3 / 4 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++

The Image Values and Replaced Content Module Level 3_ is a candidate recommendation introducing "additional ways of representing 2D images, for example as a list of URIs denoting fallbacks, or as a gradient", defining "several properties for manipulating raster images and for sizing or positioning replaced elements" and "generic sizing algorithm for replaced elements".

The Image Values and Replaced Content Module Level 4_ is a working draft on the same subject.

The linear-gradient(), radial-gradient()andrepeating-radial-gradient() properties are supported as background images.

The the url() notation is supported, but the image()notation is not supported for background images.

The object-fit and object-position properties are supported.

The from-image and snap values of the image-resolutionproperty are not supported, but theresolution value is supported.

The image-rendering and image-orientation properties are supported.

.. _Image Values and Replaced Content Module Level 3: https://www.w3.org/TR/css-images-3/ .. _Image Values and Replaced Content Module Level 4: https://www.w3.org/TR/css-images-4/

CSS Box Sizing Module Level 3 +++++++++++++++++++++++++++++

The CSS Box Sizing Module Level 3_ is a candidate recommendation extending "the CSS sizing properties with keywords that represent content-based 'intrinsic' sizes and context-based 'extrinsic' sizes."

The new property defined in this document is implemented in WeasyPrint:box-sizing.

The min-content, max-content and fit-content()sizing values are not supported.

.. _CSS Box Sizing Module Level 3: https://www.w3.org/TR/css-sizing-3/

CSS Overflow Module Level 3 +++++++++++++++++++++++++++

The CSS Overflow Module Level 3_ is a working draft containing "the features of CSS relating to scrollable overflow handling in visual media."

The overflow property is supported, as defined in CSS2. overflow-x,overflow-y, overflow-clip-margin, overflow-inlineandoverflow-block are not supported.

The text-overflow, block-ellipsis, line-clamp, max-linesandcontinue properties are supported.

.. _CSS Overflow Module Level 3: https://www.w3.org/TR/2020/WD-css-overflow-3-20200603/

CSS Values and Units Module Level 3 / 4 +++++++++++++++++++++++++++++++++++++++

The CSS Values and Units Module Level 3_ defines various units and keywords used in "value definition field of each CSS property".

The CSS Values and Units Module Level 4_ adds many new units, unit types and math functions.

The initial and inheritCSS-wide keywords are supported, but theunset keyword is not supported.

Quoted strings, URLs and numeric data types are supported.

Font-relative lengths (em, ex, ch, cap, ic, lh), viewport-relative lengths (vw, vh, vi, vb, vmin, vmax), absolute lengths (cm, mm, q, in, pt, pc, px), angles (rad, grad, turn, deg), resolutions (dpi, dpcm, dppx, x) are supported.

Unspecified page-relative units (pvw, pvh…) are also supported. They are relative to the whole page size (including page margins), while all the other units are relative to the page area size (without page margins).

The attr() functional notation is allowed in the contentandstring-set properties.

All the mathematical functions (calc()…) are supported.

.. _CSS Values and Units Module Level 3: https://www.w3.org/TR/css3-values/ .. _CSS Values and Units Module Level 4: https://www.w3.org/TR/css-values-4/

CSS Multi-column Layout Module ++++++++++++++++++++++++++++++

The CSS Multi-column Layout Module_ "describes multi-column layouts in CSS, a style sheet language for the web. Using functionality described in the specification, content can be flowed into multiple columns with a gap and a rule between them."

Simple multi-column layouts are supported in WeasyPrint. Features such as constrained height, spanning columns or column breaks are not supported. Pagination and overflow are not seriously tested.

The column-width and column-count properties, and the columnsshorthand property are supported.

The column-gap, column-rule-color, column-rule-styleandcolumn-rule-width properties, and the column-ruleshorthand property are supported.

The break-before, break-after and break-insideproperties are supported.

The column-span property is supported for direct children of columns.

The column-fillproperty is supported, with a column balancing algorithm that should be efficient with simple cases.

.. _CSS Multi-column Layout Module: https://www.w3.org/TR/css-multicol-1/

CSS Fragmentation Module Level 3 / 4 ++++++++++++++++++++++++++++++++++++

The CSS Fragmentation Module Level 3_ "describes the fragmentation model that partitions a flow into pages, columns, or regions. It builds on the Page model module and introduces and defines the fragmentation model. It adds functionality for pagination, breaking variable fragment size and orientation, widows and orphans."

The CSS Fragmentation Module Level 4_ is a working draft on the same subject.

The break-before, break-after and break-insideproperties are supported for pages, but not for columns and regions.page-break-*aliases as defined in CSS2 are supported too.

The orphans and widows properties are supported.

The box-decoration-breakproperty is supported, but backgrounds are always repeated and not extended through the whole box as it should be with 'slice' value.

The margin-break property is supported.

.. _CSS Fragmentation Module Level 3: https://www.w3.org/TR/css-break-3/ .. _CSS Fragmentation Module Level 4: https://www.w3.org/TR/css-break-4/

CSS Custom Properties for Cascading Variables Module Level 1 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

The CSS Custom Properties for Cascading Variables Module Level 1_ "introduces cascading variables as a new primitive value type that is accepted by all CSS properties, and custom properties for defining them."

The custom properties and the var() notation are supported.

.. _CSS Custom Properties for Cascading Variables Module Level 1: https://www.w3.org/TR/css-variables/

CSS Text Decoration Module Level 3 / 4 ++++++++++++++++++++++++++++++++++++++

The CSS Text Decoration Module Level 3_ "contains the features of CSS relating to text decoration, such as underlines, text shadows, and emphasis marks."

The CSS Text Decoration Module Level 4_ is a working draft on the same subject.

The text-decoration-line, text-decoration-style,text-decoration-color, text-decoration-thicknessandtext-underline-offset properties are supported. The text-decorationshorthand is also supported.

The other properties (text-underline-position, text-emphasis-*,text-shadow) are not supported.

.. _CSS Text Decoration Module Level 3: https://www.w3.org/TR/css-text-decor-3/ .. _CSS Text Decoration Module Level 4: https://www.w3.org/TR/css-text-decor-4/

CSS Flexible Box Layout Module Level 1 ++++++++++++++++++++++++++++++++++++++

The CSS Flexible Box Layout Module Level 1_ "describes a CSS box model optimized for user interface design", also known as "flexbox".

This module works for simple use cases but is not deeply tested.

All the flex-, align-, justify-* and orderproperties are supported. Theflex and flex-flow shorthands are supported too.

.. _CSS Flexible Box Layout Module Level 1: https://www.w3.org/TR/css-flexbox-1/

CSS Grid Layout Module Level 2 ++++++++++++++++++++++++++++++

The CSS Grid Layout Module Level 2_ "defines a two-dimensional grid-based layout system, optimized for user interface design".

This module works for simple cases, but has some limitations. Here are non-exhaustive lists of supported/unsupported features.

Supported:

- display: grid, -grid-auto-, grid-template- and other grid-*properties, -grid and other grid-*shorthands, - flexible lengths (frunit), - line names, - grid areas, - auto rows and auto columns, -z-index, -repeat(X, *), -minmax(), -align- and justify-alignment properties, -gap and *-gapproperties for gutters, - dense auto flow, -order, - margins, borders, padding on grid containers and grid items, - fragmentation between rows.

Unsupported or untested:

- display: inline-grid, - auto content size for grid containers, -grid-auto-flow: column, - subgrids, -repeat(auto-fill, ) and repeat(auto-fit, ), - auto margins for grid items, -spanwith line names, -spanfor flexible tracks, -safe and unsafealignments, - baseline alignment, - grid items with intrinsic size (images), - distribute space beyond limits, - grid items larger than grid containers, -min-width, max-width, min-height, max-heighton grid items, - complexmin-content and max-contentcases, - absolutely positioned and floating grid items, - fragmentation in rows.

.. _CSS Grid Layout Module Level 2: https://www.w3.org/TR/css-grid-2/

CSS Logical Properties and Values Module Level 1 ++++++++++++++++++++++++++++++++++++++++++++++++

The CSS Logical Properties and Values Module Level 1_ "defines how to map between flow-relative and physical terms."

All the logical properties and shorthands based on start, end, blockandinline are supported. But, as writing-mode is not supported, the blockandinline axes always correspond to the vertical and horizontal axes.

.. _Logical Properties and Values Module Level 1: https://www.w3.org/TR/css-logical-1/

CSS Basic User Interface Module Level 4 +++++++++++++++++++++++++++++++++++++++

The CSS Basic User Interface Module Level 4_ "enables authors to style user interface related properties and values."

The outline-width, outline-style, outline-colorproperties and theoutline shorthand are supported. The outline-offsetproperty is also supported.

The resize, cursor, caret- and nav-properties are not supported.

The appearance property is supported. When set to auto, it displays form fields as PDF form fields (supported for text inputs, check boxes, text areas, and select only).

The accent-color property is not supported.

.. _CSS Basic User Interface Module Level 4: https://www.w3.org/TR/css-ui-4/

---

`Changelog`

Changelog =========

Version 69.0 ------------

Released on 2026-06-02.

This is a security update (CVE-2026-49452).

We strongly recommend to upgrade WeasyPrint to the latest version if you use the--presentational-hintsoption and render untrusted HTML with restricted CSS properties.

Security:

* Avoid CSS injection with HTML presentational hints.

Command-line API:

* The --srgb option has been replaced by --output-intent=srgb. Other values are possible:device-cmykfor CMYK documents with no ICC profile, or the CSS identifier of a@color-profile rule.

Python API:

* The output_intent string entry replaces the srgb boolean in default options.

Features:

* #2357 <https://github.com/Kozea/WeasyPrint/issues/2357>_,#2700 <https://github.com/Kozea/WeasyPrint/pull/2700>_: Support logical properties *#1194 <https://github.com/Kozea/WeasyPrint/issues/1194>_,#2702 <https://github.com/Kozea/WeasyPrint/pull/2702>_: Support viewport units *#2686 <https://github.com/Kozea/WeasyPrint/issues/2686>_: Detect redirection loops early in URL fetcher *#2735 <https://github.com/Kozea/WeasyPrint/issues/2735>_,#2737 <https://github.com/Kozea/WeasyPrint/pull/2737>_: Support SVG transform angle units *#2636 <https://github.com/Kozea/WeasyPrint/issues/2636>_,#2720 <https://github.com/Kozea/WeasyPrint/pull/2720>_,#2773 <https://github.com/Kozea/WeasyPrint/pull/2773>_: Use HTML parsers for presentational hints *#2631 <https://github.com/Kozea/WeasyPrint/issues/2631>_,#2778 <https://github.com/Kozea/WeasyPrint/pull/2778>_,#2785 <https://github.com/Kozea/WeasyPrint/issues/2785>_,#2788 <https://github.com/Kozea/WeasyPrint/pull/2788>_: Allow users to set PDF output intent

Bug fixes:

* #2697 <https://github.com/Kozea/WeasyPrint/issues/2697>_,#2691 <https://github.com/Kozea/WeasyPrint/pull/2691>_: Avoid endless loops in grids *#2709 <https://github.com/Kozea/WeasyPrint/pull/2709>_: Be less strict for gradient rasterization in tests *#2683 <https://github.com/Kozea/WeasyPrint/issues/2683>_: Fix rendering of emojis in SVG *#2688 <https://github.com/Kozea/WeasyPrint/pull/2688>_: Always describe font using absolute sizes *#2676 <https://github.com/Kozea/WeasyPrint/issues/2676>_: Fix inheritance for svg/symbol tags referenced by use tags *#2681 <https://github.com/Kozea/WeasyPrint/pull/2681>_: Add dc:description field to PDF/A metadata *#2680 <https://github.com/Kozea/WeasyPrint/issues/2680>_: Force first grid row rendering on empty pages *#2690 <https://github.com/Kozea/WeasyPrint/issues/2690>_: Compute units in gradients used in border background *#2689 <https://github.com/Kozea/WeasyPrint/issues/2689>_: Cut flex elements with fixed height and overflowing children *#2651 <https://github.com/Kozea/WeasyPrint/issues/2651>_,#2696 <https://github.com/Kozea/WeasyPrint/pull/2696>_: Fix tests on Debian *#2698 <https://github.com/Kozea/WeasyPrint/issues/2698>_,#2699 <https://github.com/Kozea/WeasyPrint/pull/2699>_: Fix alignment of right-to-left elements with auto width and set min/max-width *#2556 <https://github.com/Kozea/WeasyPrint/issues/2556>_: Apply presentational hints to svg tags *#2706 <https://github.com/Kozea/WeasyPrint/issues/2706>_: Handle infinite border radii *#2707 <https://github.com/Kozea/WeasyPrint/issues/2707>_,#2708 <https://github.com/Kozea/WeasyPrint/pull/2708>_,#2710 <https://github.com/Kozea/WeasyPrint/pull/2710>_: Get mimetypes from Python code instead of various third-party files *#2717 <https://github.com/Kozea/WeasyPrint/issues/2717>_,#2580 <https://github.com/Kozea/WeasyPrint/issues/2580>_,#2740 <https://github.com/Kozea/WeasyPrint/pull/2740>_: Fix table break retry after padding overflow *#2769 <https://github.com/Kozea/WeasyPrint/pull/2769>_: Add year in PDF/UA-2 metadata *#2768 <https://github.com/Kozea/WeasyPrint/issues/2768>_: Allow SVG lists of numbers to be split on + character *#2770 <https://github.com/Kozea/WeasyPrint/pull/2770>_: Add namespace to Document tag in PDF 2 *#2771 <https://github.com/Kozea/WeasyPrint/pull/2771>_: Never try to render SVG use tags with external sources *#2774 <https://github.com/Kozea/WeasyPrint/pull/2774>_: Fix calc in logical *#2791 <https://github.com/Kozea/WeasyPrint/pull/2791>_: Improve management of variables

Documentation:

* #2703 <https://github.com/Kozea/WeasyPrint/issues/2703>_,#2733 <https://github.com/Kozea/WeasyPrint/pull/2733>_: Document command-line option for papersize and orientation

Contributors:

* Guillaume Ayoub * Nils K * Rob * Daniel Fitzpatrick * Elango Subramani * Lucie Anglade * Markus Mohanty * Tomsgu * arjenzorgdoc

Backers and sponsors:

* Spacinov * Syslifters * Kobalt * Grip Angebotssoftware * Simonsoft * Menutech * KontextWork * TrainingSparkle * Healthchecks.io * Method B * FieldHub * Hammerbacher * Yanal-Yves Fargialla * Prothesis Dental Solutions * Morntag * Xavid * Charlie S. * PDFBolt * Kai DeLorenzo

Version 68.1 ------------

Released on 2026-02-06.

Bug fixes:

* #2662 <https://github.com/Kozea/WeasyPrint/issues/2662>_: Don’t crash when SVG clip paths are not in defs tags *#2665 <https://github.com/Kozea/WeasyPrint/issues/2665>_: Fix position of box bounding box *#2663 <https://github.com/Kozea/WeasyPrint/issues/2663>_: Fix transparency with Acrobat and Edge *#2666 <https://github.com/Kozea/WeasyPrint/issues/2666>_: Don’t rely on random default font to define test page size *#2670 <https://github.com/Kozea/WeasyPrint/issues/2670>_: Fix pattern detection of URL schemes *#2671 <https://github.com/Kozea/WeasyPrint/pull/2671>_: Improve API compatibility between URLFetcherResponse and addinfourl *#2672 <https://github.com/Kozea/WeasyPrint/issues/2672>_: Fix charset for old URL fetcher requests *#2675 <https://github.com/Kozea/WeasyPrint/pull/2675>_,#2673 <https://github.com/Kozea/WeasyPrint/issues/2673>_: Fix calc for many properties

Contributors:

* Guillaume Ayoub

Backers and sponsors:

* Spacinov * Syslifters * Kobalt * Simon Sapin * Grip Angebotssoftware * Manuel Barkhau * Simonsoft * KontextWork * Menutech * TrainingSparkle * Healthchecks.io * Method B * FieldHub * Hammerbacher * Yanal-Yves Fargialla * Morntag * Piloterr * Xavid * Charlie S. * Prothesis Dental Solutions * Kai DeLorenzo

Version 68.0 ------------

Released on 2026-01-19.

This is a security update (CVE-2025-68616).

We strongly recommend to upgrade WeasyPrint to the latest version if you use thedefault_url_fetcherfunction in your custom URL fetcher, or if you use theallowed_protocols parameter of the default_url_fetcher function.

Security:

* Always use URL fetcher for HTTP redirects

Python API:

* default_url_fetcher() is deprecated, use the new URLFetcherclass instead, see :ref:URL Fetchersfor more information about URL fetchers *DocumentMetadata.generate_rdf_metadatais now a method that can be overridden instead of a parameter, see :ref:Factur-X / ZUGFeRD (Electronic Invoices)for examples to create e-invoices

Features:

* #2609 <https://github.com/Kozea/WeasyPrint/pull/2609>_,#2603 <https://github.com/Kozea/WeasyPrint/issues/2603>_,#351 <https://github.com/Kozea/WeasyPrint/issues/351>_: Refactor URL fetcher API *#2632 <https://github.com/Kozea/WeasyPrint/pull/2632>_: Support legacy 0 value for angles *#2627 <https://github.com/Kozea/WeasyPrint/pull/2627>_: Add font-face support to SVG *#2646 <https://github.com/Kozea/WeasyPrint/pull/2646>_,#2255 <https://github.com/Kozea/WeasyPrint/issues/2255>_: Add font shorthand support for SVG text elements *#2590 <https://github.com/Kozea/WeasyPrint/pull/2590>_,#1749 <https://github.com/Kozea/WeasyPrint/issues/1749>_: Honor language-specific rules for text-transform *#2645 <https://github.com/Kozea/WeasyPrint/pull/2645>_,#2613 <https://github.com/Kozea/WeasyPrint/issues/2613>_: Improve SVG and SVG emojis rendering *#2658 <https://github.com/Kozea/WeasyPrint/pull/2658>_,#2583 <https://github.com/Kozea/WeasyPrint/issues/2583>_: Add CLI for Factur-X / ZUGFeRD e-invoices

Bug fixes:

* #2649 <https://github.com/Kozea/WeasyPrint/issues/2649>_: Refactor URL fetcher API *#2643 <https://github.com/Kozea/WeasyPrint/pull/2643>_,#2628 <https://github.com/Kozea/WeasyPrint/issues/2628>_: Handle box-sizing: border-box in grid layout *#2641 <https://github.com/Kozea/WeasyPrint/pull/2641>_,#1875 <https://github.com/Kozea/WeasyPrint/issues/1875>_: Process whitespace after checking all pending targets *#2488 <https://github.com/Kozea/WeasyPrint/pull/2488>_,#2485 <https://github.com/Kozea/WeasyPrint/issues/2485>_: Preserve page groups during layout repagination *#2642 <https://github.com/Kozea/WeasyPrint/pull/2642>_,#2631 <https://github.com/Kozea/WeasyPrint/issues/2631>_: Don’t use isolated transparency groups *#2637 <https://github.com/Kozea/WeasyPrint/issues/2637>_: Fix repeating radial gradients rendering *#2622 <https://github.com/Kozea/WeasyPrint/issues/2622>_: Fix validation of colors *#2626 <https://github.com/Kozea/WeasyPrint/issues/2626>_: Share grid items rendering advancement between a box and its copies *#2621 <https://github.com/Kozea/WeasyPrint/issues/2621>_: Correctly handle fallback values of attr() *#2619 <https://github.com/Kozea/WeasyPrint/issues/2619>_: Fix SVG fonts *#2629 <https://github.com/Kozea/WeasyPrint/issues/2629>_: Always define extra skip height that may be used after *#2648 <https://github.com/Kozea/WeasyPrint/issues/2648>_: Fix numbers validation in font-feature-settings *#2648 <https://github.com/Kozea/WeasyPrint/issues/2660>_: Fix keyword values for text-decoration-thickness *#2661 <https://github.com/Kozea/WeasyPrint/issues/2661>_: Respect inline images when defining minimum table width

Documentation:

* #2638 <https://github.com/Kozea/WeasyPrint/pull/2638>_: Update Python command for Windows installation steps

Contributors:

* Guillaume Ayoub * Jurriaan Pruis * Mohamed Hamed * Alexandra Usatenko * Andrea Corna * Aoishik Khan * Joe

Backers and sponsors:

Version 67.0 ------------

Released on 2025-12-02.

Dependencies:

* Python 3.10+ is now needed, Python 3.9 is not supported anymore * tinycss2 1.5.0+ is now needed * fontTools 4.59.2+ is now needed

Features:

* #2560 <https://github.com/Kozea/WeasyPrint/pull/2560>_,#640 <https://github.com/Kozea/WeasyPrint/issues/640>_,#844 <https://github.com/Kozea/WeasyPrint/issues/844>_,#1091 <https://github.com/Kozea/WeasyPrint/issues/1091>_,#2517 <https://github.com/Kozea/WeasyPrint/issues/2517>_: Support CMYK colors, PDF/X, color profiles and light-dark() function *#2558 <https://github.com/Kozea/WeasyPrint/pull/2558>_,#1175 <https://github.com/Kozea/WeasyPrint/issues/1175>_: Support ::first-line, with financial support from Karte Technology *#2552 <https://github.com/Kozea/WeasyPrint/pull/2552>_: Support CSS layers, with financial support from Code & Co. *#2564 <https://github.com/Kozea/WeasyPrint/pull/2564>_,#2599 <https://github.com/Kozea/WeasyPrint/pull/2599>_,#2397 <https://github.com/Kozea/WeasyPrint/issues/2397>_: Allow page breaks in grid rows, with financial support from Ocean Recap *#2568 <https://github.com/Kozea/WeasyPrint/pull/2568>_,#357 <https://github.com/Kozea/WeasyPrint/issues/357>_: Support calc() and other mathematical functions *#2575 <https://github.com/Kozea/WeasyPrint/pull/2575>_,#2574 <https://github.com/Kozea/WeasyPrint/issues/2574>_: Support PDF/A-1a, PDF/A-2a and PDF/A-3a *#2611 <https://github.com/Kozea/WeasyPrint/pull/2611>_,#2573 <https://github.com/Kozea/WeasyPrint/issues/2573>_: Support PDF/A-4e and PDF/A-4f *#2523 <https://github.com/Kozea/WeasyPrint/pull/2523>_: Display tofu for missing glyphs *#2581 <https://github.com/Kozea/WeasyPrint/pull/2581>_: Add option to disable protocols in URL resolution *#2570 <https://github.com/Kozea/WeasyPrint/pull/2570>_: Support rch, cap, rcap, rex, ic and ric font-relative units *#2547 <https://github.com/Kozea/WeasyPrint/pull/2547>_,#2140 <https://github.com/Kozea/WeasyPrint/issues/2140>_: Support "only" keyword in media queries

Bug fixes:

* #2516 <https://github.com/Kozea/WeasyPrint/pull/2516>_,#1510 <https://github.com/Kozea/WeasyPrint/issues/1510>_: Fix rendering of first line of text with nested right float *#2510 <https://github.com/Kozea/WeasyPrint/pull/2510>_,#1073 <https://github.com/Kozea/WeasyPrint/issues/1073>_,#2507 <https://github.com/Kozea/WeasyPrint/issues/2507>_: Avoid Pango crashes and font mismatches with @font-face rules referencing local fonts *#2532 <https://github.com/Kozea/WeasyPrint/pull/2532>_,#2531 <https://github.com/Kozea/WeasyPrint/issues/2531>_: Use fonttools instancer instead of deprecated mutator API *#2541 <https://github.com/Kozea/WeasyPrint/pull/2541>_: Fix syntax of functions *#2543 <https://github.com/Kozea/WeasyPrint/pull/2543>_: Allow font-related units to access @font-face fonts *#2525 <https://github.com/Kozea/WeasyPrint/pull/2525>_: Respect top margins and avoid overlapping footnotes for columns, with financial support from Code & Co. *#2536 <https://github.com/Kozea/WeasyPrint/pull/2536>_: Remove Subtype key from font descriptor *#2539 <https://github.com/Kozea/WeasyPrint/pull/2539>_: Fix min width for SVGs with intrinsic ratio but no intrinsic size *#2537 <https://github.com/Kozea/WeasyPrint/pull/2537>_,#2533 <https://github.com/Kozea/WeasyPrint/issues/2533>_: Fix order of operators when drawing SVGs *#2538 <https://github.com/Kozea/WeasyPrint/pull/2538>_: Don’t crash with nested unknown functions *#2542 <https://github.com/Kozea/WeasyPrint/pull/2542>_: Don’t crash when lh and rlh are used for line height or font size *#2540 <https://github.com/Kozea/WeasyPrint/pull/2540>_,#2528 <https://github.com/Kozea/WeasyPrint/issues/2528>_: Use locale encoding instead of filesystem encoding for font paths *#2563 <https://github.com/Kozea/WeasyPrint/pull/2563>_,#2479 <https://github.com/Kozea/WeasyPrint/issues/2479>_: Don’t avoid float collisions for atomic flex items *#2569 <https://github.com/Kozea/WeasyPrint/pull/2569>_: Don’t be case-sensitive for units *#2567 <https://github.com/Kozea/WeasyPrint/pull/2567>_,#2566 <https://github.com/Kozea/WeasyPrint/issues/2566>_: Add x-default attribute for metadata description to be compliant with PDF/A *#2586 <https://github.com/Kozea/WeasyPrint/pull/2586>_,#2571 <https://github.com/Kozea/WeasyPrint/issues/2571>_: Improve formatting contexts management *#2600 <https://github.com/Kozea/WeasyPrint/pull/2600>_: Fix SVG image aspect ratio when only width or height is specified *#2612 <https://github.com/Kozea/WeasyPrint/pull/2612>_,#2595 <https://github.com/Kozea/WeasyPrint/pull/2595>_: Clean block layout and fix corner cases *#2522 <https://github.com/Kozea/WeasyPrint/issues/2522>_: Ignore preserveAspectRatio when SVG has no viewBox *#2544 <https://github.com/Kozea/WeasyPrint/issues/2544>_: Allow to use a variable twice in a function *#2555 <https://github.com/Kozea/WeasyPrint/issues/2555>_: Fix flex gap in right-to-left context *#2591 <https://github.com/Kozea/WeasyPrint/issues/2591>_: Respect non-auto widths and fix padding of grid items *#2601 <https://github.com/Kozea/WeasyPrint/issues/2601>_: Don’t crash when tagged tables are not displayed as tables *#2607 <https://github.com/Kozea/WeasyPrint/issues/2607>_: Fix rendering of multiline textareas with PDF forms *#2106 <https://github.com/Kozea/WeasyPrint/issues/2106>_: Force variable initialization to avoid crashes during column layout *#2618 <https://github.com/Kozea/WeasyPrint/pull/2618>_,#2617 <https://github.com/Kozea/WeasyPrint/issues/2617>_: Fix rendering of relative grid and flex items

Documentation:

* #2535 <https://github.com/Kozea/WeasyPrint/pull/2535>_:#2534 <https://github.com/Kozea/WeasyPrint/issues/2534>_: Removed reference to defunct site

Contributors:

* Guillaume Ayoub * Fazle Rabbi Ferdaus * Lucie Anglade * Luca Vercelli * ChickenF622 * Ernie Chu * Mark Pullin * Malte Laukötter * Markus Mohanty * Yvonne Kothmeier * Jarom Ort * kuypan

Backers and sponsors:

Version 66.0 ------------

Released on 2025-07-24.

Features:

* #2475 <https://github.com/Kozea/WeasyPrint/pull/2475>_: Add support for 'lh' and 'rlh' units *#2432 <https://github.com/Kozea/WeasyPrint/issues/2432>_,#2437 <https://github.com/Kozea/WeasyPrint/pull/2437>_: Report footnotes when text overflows because of orphans, with financial support from Code & Co. *#2256 <https://github.com/Kozea/WeasyPrint/issues/2256>_,#2466 <https://github.com/Kozea/WeasyPrint/pull/2466>_: Handle transform-origin in SVG *#2445 <https://github.com/Kozea/WeasyPrint/pull/2445>_: Add parameter to have additional HTTP headers for url_fetcher

Bug fixes:

* #2471 <https://github.com/Kozea/WeasyPrint/pull/2471>_,#2506 <https://github.com/Kozea/WeasyPrint/pull/2506>_,#2500 <https://github.com/Kozea/WeasyPrint/issues/2500>_,#2460 <https://github.com/Kozea/WeasyPrint/issues/2460>_,#2363 <https://github.com/Kozea/WeasyPrint/issues/2363>_,#2470 <https://github.com/Kozea/WeasyPrint/issues/2470>_,#1872 <https://github.com/Kozea/WeasyPrint/issues/1872>_,#2153 <https://github.com/Kozea/WeasyPrint/issues/2153>_,#1838 <https://github.com/Kozea/WeasyPrint/issues/1838>_,#1837 <https://github.com/Kozea/WeasyPrint/issues/1837>_,#1784 <https://github.com/Kozea/WeasyPrint/issues/1784>_,#1835 <https://github.com/Kozea/WeasyPrint/issues/1835>_,#2444 <https://github.com/Kozea/WeasyPrint/issues/2444>_,#2497 <https://github.com/Kozea/WeasyPrint/issues/2497>_,#2505 <https://github.com/Kozea/WeasyPrint/issues/2505>_,#2503 <https://github.com/Kozea/WeasyPrint/issues/2503>_,#1836 <https://github.com/Kozea/WeasyPrint/issues/1836>_,#2467 <https://github.com/Kozea/WeasyPrint/issues/2467>_: Improve PDF/UA support, with financial support from NLnet *#2425 <https://github.com/Kozea/WeasyPrint/pull/2425>_,#1557 <https://github.com/Kozea/WeasyPrint/issues/1557>_: Improve position of outside markers *#2409 <https://github.com/Kozea/WeasyPrint/pull/2409>_,#2265 <https://github.com/Kozea/WeasyPrint/issues/2265>_: Draw circles instead of rectangles when drawing dotted borders *#2416 <https://github.com/Kozea/WeasyPrint/pull/2416>_,#2270 <https://github.com/Kozea/WeasyPrint/issues/2270>_: Correctly split words for automatic hyphenation *#2439 <https://github.com/Kozea/WeasyPrint/pull/2439>_,#2426 <https://github.com/Kozea/WeasyPrint/issues/2426>_: Don’t rely on URL protocols outside URL fetcher function *#2433 <https://github.com/Kozea/WeasyPrint/pull/2433>_: Disable style for deprecated outline algorithm *#2447 <https://github.com/Kozea/WeasyPrint/pull/2447>_,#2441 <https://github.com/Kozea/WeasyPrint/issues/2441>_,#2448 <https://github.com/Kozea/WeasyPrint/issues/2448>_: Improve min- and max-content calculation, with financial support from Menutech *#2454 <https://github.com/Kozea/WeasyPrint/pull/2454>_,#2442 <https://github.com/Kozea/WeasyPrint/issues/2442>_,#2449 <https://github.com/Kozea/WeasyPrint/issues/2449>_: Minor fixes for flex layout *#2473 <https://github.com/Kozea/WeasyPrint/pull/2473>_,#2459 <https://github.com/Kozea/WeasyPrint/issues/2459>_: Include out-of-flow boxes in page layout progress, with financial support from Pathfindr *#2458 <https://github.com/Kozea/WeasyPrint/pull/2458>_: Replace deprecated warn logger function *#2494 <https://github.com/Kozea/WeasyPrint/pull/2494>_,#1856 <https://github.com/Kozea/WeasyPrint/issues/1856>_: Fix bug with bottom margins in columns *#2435 <https://github.com/Kozea/WeasyPrint/issues/2435>_: Make footnote calls inherit from footnotes *#2484 <https://github.com/Kozea/WeasyPrint/issues/2484>_,#2456 <https://github.com/Kozea/WeasyPrint/issues/2456>_: Allow to avoid page breaks after table-row-group elements *#2450 <https://github.com/Kozea/WeasyPrint/issues/2450>_: Draw background and borders for relative grid containers *#2453 <https://github.com/Kozea/WeasyPrint/issues/2453>_: Don’t advance position_y for collapsed margins of discarded children *#2493 <https://github.com/Kozea/WeasyPrint/issues/2493>_: Fix endless loop with CSS variables referencing each other *#2502 <https://github.com/Kozea/WeasyPrint/issues/2502>_: Ignore bottom margin when calculating footnote overflow

Contributors:

* Guillaume Ayoub * Lucie Anglade * Alvaro Garcia Fernandez * Emmanuel Ferdman * Gabriel Corona * Markus Mohanty * Luca Vercelli * Tre Huang

Backers and sponsors:

* Spacinov * Kobalt * Grip Angebotssoftware * Syslifters * Simon Sapin * Manuel Barkhau * Simonsoft * Menutech * KontextWork * TrainingSparkle * Healthchecks.io * Hammerbacher * DocRaptor * Yanal-Yves Fargialla * Method B * FieldHub * Morntag * Xavid * Kai DeLorenzo * Charlie S. * Alan Villalobos

Version 65.1 ------------

Released on 2025-04-14.

Bug fixes:

* #2414 <https://github.com/Kozea/WeasyPrint/issues/2414>_: Correctly handle flex columns split between pages *1b24ad9 <https://github.com/Kozea/WeasyPrint/commit/1b24ad9>_: Include padding in outer size of item elements *#2419 <https://github.com/Kozea/WeasyPrint/issues/2419>_: Set main tag as block by default *#2415 <https://github.com/Kozea/WeasyPrint/issues/2415>_: Fix support of replaced block box as flex items *83da2fe0 <https://github.com/Kozea/WeasyPrint/commit/83da2fe0>_: Fix margins and padding for rtl lists *#2429 <https://github.com/Kozea/WeasyPrint/issues/2429>_,#1076 <https://github.com/Kozea/WeasyPrint/issues/1076>_,#2431 <https://github.com/Kozea/WeasyPrint/pull/2431>_: Fix page groups

Contributors:

* Guillaume Ayoub

Backers and sponsors:

Version 65.0 ------------

Released on 2025-03-20.

Dependencies:

* CSSSelect2 0.8.0 is now needed

Features:

* #1665 <https://github.com/Kozea/WeasyPrint/issues/1665>_: Support gap properties in Flex layout, with financial support from NLnet *#378 <https://github.com/Kozea/WeasyPrint/issues/378>_,#2405 <https://github.com/Kozea/WeasyPrint/pull/2405>_: Handle @font-face unicode-range *#2394 <https://github.com/Kozea/WeasyPrint/pull/2394>_: Modernize and improve default user agent stylesheets

Bug fixes:

* #2362 <https://github.com/Kozea/WeasyPrint/issues/2362>_,#2387 <https://github.com/Kozea/WeasyPrint/pull/2387>_,#601 <https://github.com/Kozea/WeasyPrint/issues/601>_,#1967 <https://github.com/Kozea/WeasyPrint/issues/1967>_,#1805 <https://github.com/Kozea/WeasyPrint/issues/1805>_,#2163 <https://github.com/Kozea/WeasyPrint/issues/2163>_,#2342 <https://github.com/Kozea/WeasyPrint/issues/2342>_,#2374 <https://github.com/Kozea/WeasyPrint/issues/2374>_,#1109 <https://github.com/Kozea/WeasyPrint/issues/1109>_,#1356 <https://github.com/Kozea/WeasyPrint/issues/1356>_,#1327 <https://github.com/Kozea/WeasyPrint/issues/1327>_,#1563 <https://github.com/Kozea/WeasyPrint/issues/1563>_,#1652 <https://github.com/Kozea/WeasyPrint/issues/1652>_,#2351 <https://github.com/Kozea/WeasyPrint/issues/2351>_,#2312 <https://github.com/Kozea/WeasyPrint/issues/2312>_,#2340 <https://github.com/Kozea/WeasyPrint/issues/2340>_,#1311 <https://github.com/Kozea/WeasyPrint/issues/1311>_,#2066 <https://github.com/Kozea/WeasyPrint/issues/2066>_,#2359 <https://github.com/Kozea/WeasyPrint/issues/2359>_,#2053 <https://github.com/Kozea/WeasyPrint/issues/2053>_: Improve Flex layout, with financial support from NLnet. *#1686 <https://github.com/Kozea/WeasyPrint/issues/1686>_,#2404 <https://github.com/Kozea/WeasyPrint/pull/2404>_: Fix duplicate text selection with right-to-left text *#2372 <https://github.com/Kozea/WeasyPrint/issues/2372>_,#2389 <https://github.com/Kozea/WeasyPrint/pull/2389>_: Fix justification of right-to-left text *#2403 <https://github.com/Kozea/WeasyPrint/issues/2403>_: Fix emoji rendering with older versions of Pango *#2392 <https://github.com/Kozea/WeasyPrint/issues/2392>_: Fix complex cases involving nested SVG text anchors *#2396 <https://github.com/Kozea/WeasyPrint/issues/2396>_,#2398 <https://github.com/Kozea/WeasyPrint/pull/2398>_: Fix and improve font names in PDF *#2269 <https://github.com/Kozea/WeasyPrint/issues/2269>_,#2390 <https://github.com/Kozea/WeasyPrint/pull/2390>_: Apply justification to non-breaking spaces *#2362 <https://github.com/Kozea/WeasyPrint/issues/2362>_,#2387 <https://github.com/Kozea/WeasyPrint/pull/2387>_: Improve Flex layout, with financial support from NLnet.

Contributors:

* Guillaume Ayoub * Luca Vercelli

Backers and sponsors:

Version 64.1 ------------

Released on 2025-02-20.

Bug fixes:

* #2368 <https://github.com/Kozea/WeasyPrint/issues/2368>_: Fix ascent and descent font values *#2370 <https://github.com/Kozea/WeasyPrint/issues/2370>_: Avoid endless recursion for variables in nested functions *#2275 <https://github.com/Kozea/WeasyPrint/issues/2275>_: Use correct containing block to render waiting children *#2375 <https://github.com/Kozea/WeasyPrint/issues/2375>_: Ensure that we handle text-anchor only on text content elements *#2090 <https://github.com/Kozea/WeasyPrint/issues/2090>_: Only create font temporary folder when adding fonts *#2383 <https://github.com/Kozea/WeasyPrint/issues/2383>_: Fix grid-template-areas validation and allow uppercase identifiers for grid lines

Contributors:

* Guillaume Ayoub

Backers and sponsors:

Version 64.0 ------------

Released on 2025-01-30.

Features:

* #2338 <https://github.com/Kozea/WeasyPrint/pull/2338>_: Allow custom RDF metadata for PDF/A and eInvoices *#123 <https://github.com/Kozea/WeasyPrint/issues/123>_,#2345 <https://github.com/Kozea/WeasyPrint/pull/2345>_: Handle small-caps synthesis *#2343 <https://github.com/Kozea/WeasyPrint/issues/2343>_: Support outline-offset *#2361 <https://github.com/Kozea/WeasyPrint/pull/2361>_: Support text-underline-offset and text-decoration-thickness *#2296 <https://github.com/Kozea/WeasyPrint/issues/2296>_: Don’t crash with tables with rounded corners split between pages

Bug fixes:

* #2360 <https://github.com/Kozea/WeasyPrint/issues/2360>_: Fix gradients with non-RGB colors *#2355 <https://github.com/Kozea/WeasyPrint/issues/2355>_,#2358 <https://github.com/Kozea/WeasyPrint/pull/2358>_: Align png emojis to the surrounding text *#2353 <https://github.com/Kozea/WeasyPrint/issues/2353>_: Fix alignment of SVG text with multiple nested text-anchor values *#2350 <https://github.com/Kozea/WeasyPrint/pull/2350>_: Fix logging restoration in capture_logs *#2341 <https://github.com/Kozea/WeasyPrint/pull/2341>_: Fix page groups *#2314 <https://github.com/Kozea/WeasyPrint/pulls/2314>_: Use CSS 'image-rendering' attribute for images in SVGs *#2332 <https://github.com/Kozea/WeasyPrint/issues/2332>_: Fix opacity for translated SVG elements *#2329 <https://github.com/Kozea/WeasyPrint/issues/2329>_: Refactor text.line_break.get_log_attrs *#2325 <https://github.com/Kozea/WeasyPrint/issues/2325>_,#2326 <https://github.com/Kozea/WeasyPrint/pull/2326>_: Fix table overflow edge cases

Performance:

* #2347 <https://github.com/Kozea/WeasyPrint/issues/2347>_,#2364 <https://github.com/Kozea/WeasyPrint/pull/2364>_: Improve rendering speed for text

Documentation:

* #2352 <https://github.com/Kozea/WeasyPrint/pull/2352>_: Add more use cases in documentation, use Furo theme

Contributors:

* Guillaume Ayoub * Kesara Rathnayake * Xavid Pretzer * David Tagatac * Ernesto Ruge * Niko Abeler * Noam Kushinsky

Backers and sponsors:

Version 63.1 ------------

Released on 2024-12-10.

Dependencies:

* #2297 <https://github.com/Kozea/WeasyPrint/issues/2297>_: Remove upper bounds for dependencies

Bug fixes:

* #2300 <https://github.com/Kozea/WeasyPrint/pull/2300>_,#2292 <https://github.com/Kozea/WeasyPrint/issues/2292>_: Don’t avoid floats for flex items *#2301 <https://github.com/Kozea/WeasyPrint/pull/2301>_,#2293 <https://github.com/Kozea/WeasyPrint/issues/2293>_: Include floats in calculation of minimum cell height *#2303 <https://github.com/Kozea/WeasyPrint/pull/2303>_,#2302 <https://github.com/Kozea/WeasyPrint/issues/2302>_: Set alpha even when current color channels didn’t change *#2306 <https://github.com/Kozea/WeasyPrint/issues/2306>_: Don’t try to increase column width when there’s no extra width *#2304 <https://github.com/Kozea/WeasyPrint/issues/2304>_: Don’t forget skip stack when drawing flex items *#2316 <https://github.com/Kozea/WeasyPrint/issues/2316>_: Don’t crash with SVG symbols *#2320 <https://github.com/Kozea/WeasyPrint/issues/2320>_: Fix currentcolor detection when parsing gradient color stops *#2322 <https://github.com/Kozea/WeasyPrint/pull/2322>_,#2289 <https://github.com/Kozea/WeasyPrint/issues/2289>_: Don’t add DLL directories when using Windows executable *#2323 <https://github.com/Kozea/WeasyPrint/pull/2323>_,#2305 <https://github.com/Kozea/WeasyPrint/issues/2305>_: Fix different rendering test

Performance:

* #2319 <https://github.com/Kozea/WeasyPrint/issues/2319>_: Fix memory leaks

Documentation:

* #2299 <https://github.com/Kozea/WeasyPrint/pull/2299>_: Update install instructions for Alpine *#2321 <https://github.com/Kozea/WeasyPrint/pull/2321>_: Add example invocation of WeasyPrint on the "Contribute" page

Contributors:

* Guillaume Ayoub * Jó Ágila Bitsch * Lucie Anglade * Alexander Gitter * Luke Cousins

Backers and sponsors:

* Spacinov * Kobalt * Grip Angebotssoftware * Syslifters * Manuel Barkhau * SimonSoft * Menutech * KontextWork * Simon Sapin * TrainingSparkle * Healthchecks.io * Hammerbacher * Advance Insight * Docraptor * Method B * FieldHub * Yanal-Yves Fargialla * Morntag * Xavid

Version 63.0 ------------

Released on 2024-10-29.

Dependencies:

* Python 3.13 is now supported * pydyf 0.11.0+ is now needed * tinycss2 1.4.0+ is now needed * tinyhtml5 2.0.0+ is now needed, instead of html5lib

Features:

* #2252 <https://github.com/Kozea/WeasyPrint/pull/2252>_,#895 <https://github.com/Kozea/WeasyPrint/issues/895>_: Handle page groups, with financial support from Code & Co. *#1630 <https://github.com/Kozea/WeasyPrint/issues/1630>_,#2286 <https://github.com/Kozea/WeasyPrint/pull/2286>_: Support CSS Color Level 4 *#2192 <https://github.com/Kozea/WeasyPrint/pull/2192>_: Add PDF variant for debugging purpose *#2208 <https://github.com/Kozea/WeasyPrint/pull/2208>_: Support submit inputs in PDF forms *#2139 <https://github.com/Kozea/WeasyPrint/pull/2139>_: Supportmask-border-*properties *#1831 <https://github.com/Kozea/WeasyPrint/issues/1831>_,#2143 <https://github.com/Kozea/WeasyPrint/pull/2143>_: Support radio inputs in PDF forms

Bug fixes:

* #2262 <https://github.com/Kozea/WeasyPrint/issues/2262>_: Avoid integer overflows when converting units from/to doubles *#2260 <https://github.com/Kozea/WeasyPrint/pull/2260>_: Avoid float collision with box establishing formatting context *#2240 <https://github.com/Kozea/WeasyPrint/issues/2240>_,#2242 <https://github.com/Kozea/WeasyPrint/pull/2242>_: Handlesvgtags with no size *#2231 <https://github.com/Kozea/WeasyPrint/pull/2231>_,#1171 <https://github.com/Kozea/WeasyPrint/issues/1171>_,#2222 <https://github.com/Kozea/WeasyPrint/issues/2222>_,#1208 <https://github.com/Kozea/WeasyPrint/issues/1208>_: Fix several problems related toflex-direction: column*#2239 <https://github.com/Kozea/WeasyPrint/issues/2239>_: Don’t fail when SVG markers are undefined references *#2230 <https://github.com/Kozea/WeasyPrint/issues/2230>_,#2238 <https://github.com/Kozea/WeasyPrint/pull/2238>_: Set explicit flags when loading DLLs on Windows *#2228 <https://github.com/Kozea/WeasyPrint/issues/2228>_,#1942 <https://github.com/Kozea/WeasyPrint/issues/1942>_: Store original and PDF stream images in different cache slots *#2234 <https://github.com/Kozea/WeasyPrint/issues/2234>_: Apply stylesheet and other basic operations to SVG root tag *#2054 <https://github.com/Kozea/WeasyPrint/issues/2054>_,#2233 <https://github.com/Kozea/WeasyPrint/pull/2233>_: Keep auto margins on flex layout boxes *#1883 <https://github.com/Kozea/WeasyPrint/issues/1883>_: Don’t crash with empty list marker strings *#2216 <https://github.com/Kozea/WeasyPrint/issues/2216>_: Fix vertical alignment of out-of-flow elements in tables *#996 <https://github.com/Kozea/WeasyPrint/issues/996>_,#2219 <https://github.com/Kozea/WeasyPrint/pull/2219>_: Don’t ignore absolutely positioned elements inside flex boxes *#2217 <https://github.com/Kozea/WeasyPrint/issues/2217>_: Don’t crash withnormalcolumn gaps *#1817 <https://github.com/Kozea/WeasyPrint/issues/1817>_: Don’t assume that lines break after spaces *#1868 <https://github.com/Kozea/WeasyPrint/issues/1868>_: Don’t break rows with atomic cells *#2166 <https://github.com/Kozea/WeasyPrint/issues/2166>_: Don’t display bottom border on cells in split rows *61852c4 <https://github.com/Kozea/WeasyPrint/commit/61852c4>_: Capture fontTools logs when subsetting fonts *#2190 <https://github.com/Kozea/WeasyPrint/pull/2190>_: Don’t use a pattern when drawing backgrounds for no-repeat background images *#2185 <https://github.com/Kozea/WeasyPrint/issues/2185>_: Check that Harfbuzz version is at least 4.1.0 to subset fonts *#2180 <https://github.com/Kozea/WeasyPrint/issues/2180>_: Store width for all glyphs when font is not subset *#2183 <https://github.com/Kozea/WeasyPrint/issues/2183>_: Respectbreak-inside: avoidfor flex items *#2055 <https://github.com/Kozea/WeasyPrint/issues/2055>_,#2058 <https://github.com/Kozea/WeasyPrint/pull/2058>_: Fix right-to-left tables with collapsed borders *#2179 <https://github.com/Kozea/WeasyPrint/pull/2179>_,#1128 <https://github.com/Kozea/WeasyPrint/issues/1128>_: Handle buggy Adobe Photoshop CMYK JPEGs *#2175 <https://github.com/Kozea/WeasyPrint/issues/2175>_: Don’t compress PDF metadata for PDF/A-1 *#2174 <https://github.com/Kozea/WeasyPrint/issues/2174>_: Fix extra width distribution for auto table layout

Performance:

* #1155 <https://github.com/Kozea/WeasyPrint/issues/1155>_: Improve rendering speed for large colspan values *#2120 <https://github.com/Kozea/WeasyPrint/issues/2120>_,#2178 <https://github.com/Kozea/WeasyPrint/pull/2178>_: Use Harfbuzz to subset fonts by default

Documentation:

* #2282 <https://github.com/Kozea/WeasyPrint/issues/2282>_,#2284 <https://github.com/Kozea/WeasyPrint/pull/2284>_: Simplify Alpine install instructions *#2254 <https://github.com/Kozea/WeasyPrint/issues/2254>_: Add warning about antivirus false detection *#2220 <https://github.com/Kozea/WeasyPrint/pull/2220>_: Add extra information to debug logs *#2211 <https://github.com/Kozea/WeasyPrint/pull/2211>_: Fix link to samples *#2195 <https://github.com/Kozea/WeasyPrint/pull/2195>_: Update cache argument documentation *#2105 <https://github.com/Kozea/WeasyPrint/issues/2105>_,#2151 <https://github.com/Kozea/WeasyPrint/pull/2151>_: Use MSYS2 instead of GTK+3 for Windows

Contributors:

* Guillaume Ayoub * David Huggins-Daines * Xavid Pretzer * Yann Trividic * Kevin Kays * Alejandro Avilés * Gianluca Teti * Gregory Goodson * Lucie Anglade * Roman Sirokov

Backers and sponsors:

Version 62.3 ------------

Released on 2024-06-21.

Bug fixes:

* #2174 <https://github.com/Kozea/WeasyPrint/issues/2174>_: Fix extra width distribution for auto table layout *#2175 <https://github.com/Kozea/WeasyPrint/issues/2175>_: Don’t compress PDF metadata for PDF/A-1 *61f8bb3 <https://github.com/Kozea/WeasyPrint/commit/61f8bb3>_: Set default PDF variant values in options before generating PDF *2c4351e <https://github.com/Kozea/WeasyPrint/commit/2c4351e>_: Avoid PDF artifacts when drawing 0-width borders *d9d7f62 <https://github.com/Kozea/WeasyPrint/commit/d9d7f62>_: Don’t duplicate column when container is split on multiple pages *4617b94 <https://github.com/Kozea/WeasyPrint/commit/4617b94>_: Don’t set default Fontconfig values for unset properties *4c81663 <https://github.com/Kozea/WeasyPrint/commit/4c81663>_: Fix layout when all footnotes are removed from the footnote area *#2184 <https://github.com/Kozea/WeasyPrint/issues/2184>_: Make items overflowing grid wrap to the next row/column *#2187 <https://github.com/Kozea/WeasyPrint/issues/2187>_: Don’t append useless tracks when grid elements are positioned

Contributors:

* Guillaume Ayoub

Backers and sponsors:

* Spacinov * Kobalt * Grip Angebotssoftware * Manuel Barkhau * SimonSoft * Menutech * KontextWork * Simon Sapin * René Fritz * TrainingSparkle * Healthchecks.io * Hammerbacher * Docraptor * Yanal-Yves Fargialla * Douwe van Loenen * Morntag * Xavid

Version 62.2 ------------

Released on 2024-06-04.

Features:

* #2142 <https://github.com/Kozea/WeasyPrint/issues/2142>_,#2162 <https://github.com/Kozea/WeasyPrint/pull/2162>_: Support grid-auto-flow: column, with financial support from Menutech

Bug fixes:

* #2167 <https://github.com/Kozea/WeasyPrint/issues/2167>_: Fix space added by CSS gap at the end *#2134 <https://github.com/Kozea/WeasyPrint/issues/2134>_: Remove absolute placeholders from discarded content *#2154 <https://github.com/Kozea/WeasyPrint/issues/2154>_: Don’t crash when grid items have auto margins *8cdd66f <https://github.com/Kozea/WeasyPrint/commit/8cdd66f>_: Fix CSS nesting for nested selectors with comma *3359db5 <https://github.com/Kozea/WeasyPrint/commit/3359db5>_: Fix and test grid shorthand *82deda4 <https://github.com/Kozea/WeasyPrint/commit/82deda4>_: Fix wrong resume_at for split floats *ff2acf1 <https://github.com/Kozea/WeasyPrint/commit/ff2acf1>_: Ensure that gradient size is positive to please some PDF readers

Contributors:

* Guillaume Ayoub

Backers and sponsors:

Version 62.1 ------------

Released on 2024-05-06.

Bug fixes:

* #2144 <https://github.com/Kozea/WeasyPrint/issues/2144>_,#2149 <https://github.com/Kozea/WeasyPrint/pull/2149>_: Avoid broken fonts when generating multiple documents *c10c6892 <https://github.com/Kozea/WeasyPrint/commit/c10c6892>_: Display at least one grid row on empty pages *#2146 <https://github.com/Kozea/WeasyPrint/issues/2146>_: Don’t crash when flex container’s parent’s height is auto

Contributors:

* Guillaume Ayoub * Claudius Ellsel

Backers and sponsors:

* Spacinov * Kobalt * Grip Angebotssoftware * Manuel Barkhau * SimonSoft * Menutech * KontextWork * Simon Sapin * René Fritz * TrainingSparkle * Healthchecks.io * Docraptor * Yanal-Yves Fargialla * Douwe van Loenen * Morntag * Xavid

Version 62.0 ------------

Released on 2024-04-30.

Dependencies:

* Python 3.9+ is now needed, Python 3.7 and 3.8 are not supported anymore * pydyf 0.10.0+ is now needed * tinycss2 1.3.0+ is now needed

Features:

* #543 <https://github.com/Kozea/WeasyPrint/issues/543>_,#2121 <https://github.com/Kozea/WeasyPrint/pull/2121>_: Support CSS Grid layout *#2124 <https://github.com/Kozea/WeasyPrint/issues/2124>_,#2125 <https://github.com/Kozea/WeasyPrint/pull/2125>_: Support border-image-* properties *#2084 <https://github.com/Kozea/WeasyPrint/issues/2084>_,#2077 <https://github.com/Kozea/WeasyPrint/pull/2077>_: Support CSS nesting *#2101 <https://github.com/Kozea/WeasyPrint/issues/2101>_: Support HTML maxlength attribute for form fields *#2095 <https://github.com/Kozea/WeasyPrint/pull/2095>_: Apply overflow to replaced boxes *245e4f5 <https://github.com/Kozea/WeasyPrint/commit/245e4f5>_: Add support of PDF/A-?u

Bug fixes:

* #2136 <https://github.com/Kozea/WeasyPrint/issues/2136>_: Don’t clip aligned text in SVG *#2135 <https://github.com/Kozea/WeasyPrint/pull/2135>_: Allow column-direction flex containers to use percentage-based heights *#2128 <https://github.com/Kozea/WeasyPrint/issues/2128>_: Don’t crash when a FontConfig object is destroyed early *#2079 <https://github.com/Kozea/WeasyPrint/issues/2079>_: Fix executable file for some Windows versions *#2131 <https://github.com/Kozea/WeasyPrint/issues/2131>_: Fix alpha for images before/after transparent text *#2111 <https://github.com/Kozea/WeasyPrint/issues/2111>_: Handle auto and none values for CSS quotes property *#2103 <https://github.com/Kozea/WeasyPrint/issues/2103>_: Don’t crash with overconstrained columns *#2100 <https://github.com/Kozea/WeasyPrint/issues/2100>_: Fix rounding error when detecting overflows *#2093 <https://github.com/Kozea/WeasyPrint/issues/2093>_,#2097 <https://github.com/Kozea/WeasyPrint/issues/2097>_,#2094 <https://github.com/Kozea/WeasyPrint/pull/2094>_: Mark use of md5() and sha1() as not for security *#1956 <https://github.com/Kozea/WeasyPrint/issues/1956>_,#2087 <https://github.com/Kozea/WeasyPrint/pull/2087>_: Use CSS table module level 3 to compute widths *#2086 <https://github.com/Kozea/WeasyPrint/pull/2086>_: Fix selects with empty values displaying None *#1112 <https://github.com/Kozea/WeasyPrint/issues/1112>_,#2082 <https://github.com/Kozea/WeasyPrint/issues/2082>_,#2085 <https://github.com/Kozea/WeasyPrint/pull/2085>_: Fix computation for outer min-content width for table cells *016bd81 <https://github.com/Kozea/WeasyPrint/commit/016bd81>_: Fix many different bugs with SVG markers

Performance:

* #2130 <https://github.com/Kozea/WeasyPrint/issues/2130>_: Cache font key instead of whole font content

Documentation:

* #2108 <https://github.com/Kozea/WeasyPrint/pull/2108>_: Update documentation about CSS leader() function

Contributors:

* Guillaume Ayoub * Lucie Anglade * Xavid Pretzer * kygoh * Germain Gueutier * Vagner José Nicolodi

Backers and sponsors:

Version 61.2 ------------

Released on 2024-03-08.

This is a security update.

We strongly recommend to upgrade WeasyPrint to the latest version if you use WeasyPrint 61.0 or 61.1. Older versions are not impacted.

Security:

- Always use URL fetcher for attachments

Contributors:

* Guillaume Ayoub * Ilia Novoselov

Backers and sponsors:

* Spacinov * Kobalt * Grip Angebotssoftware * Manuel Barkhau * SimonSoft * Menutech * KontextWork * René Fritz * Simon Sapin * Arcanite * TrainingSparkle * Healthchecks.io * Hammerbacher * Docraptor * Yanal-Yves Fargialla * Morntag * NBCO

Version 61.1 ------------

Released on 2024-02-26.

Bug fixes:

- #2075 <https://github.com/Kozea/WeasyPrint/issues/2075>_: Use default value when variable is not defined -#2070 <https://github.com/Kozea/WeasyPrint/issues/2070>_: Don’t crash when rendering SVGs with non-text a children - Don’t crash when SVG file can’t be rendered

Documentation:

- #2067 <https://github.com/Kozea/WeasyPrint/pull/2067>_: Suggest "dnf" instead of "yum" to install Fedora packages - Improve documentation for Windows - Fix required version of TinyCSS2

Contributors:

* Guillaume Ayoub * Felix Schwarz * Lucie Anglade

Backers and sponsors:

Version 61.0 ------------

Released on 2024-02-12.

Python API:

* DocumentMetadata.attachments is now a list of Attachmentobjects, not a list of(url, description) tuples.

New features:

* #1219 <https://github.com/Kozea/WeasyPrint/issues/1219>_,#2017 <https://github.com/Kozea/WeasyPrint/pull/2017>_: Support var() in shorthand and multiple-value functions *#1986 <https://github.com/Kozea/WeasyPrint/issues/1986>_: Support percentages for opacity *#2050 <https://github.com/Kozea/WeasyPrint/pull/2050>_: Build executable file for Windows *#2000 <https://github.com/Kozea/WeasyPrint/pull/2000>_: Support select fields *#1993 <https://github.com/Kozea/WeasyPrint/issues/1993>_: Handle background-attachment: fixed to cover the whole page *#2023 <https://github.com/Kozea/WeasyPrint/issues/2023>_,#2022 <https://github.com/Kozea/WeasyPrint/pull/2022>_: Allow text-based file objects for HTML and CSS classes *#2014 <https://github.com/Kozea/WeasyPrint/pull/2014>_: Remove warnings for PDF/A and PDF/UA compatibility

Bug fixes:

* #2052 <https://github.com/Kozea/WeasyPrint/issues/2052>_,#1869 <https://github.com/Kozea/WeasyPrint/pull/1869>_: Handle attachments for PDF/A documents *#2013 <https://github.com/Kozea/WeasyPrint/issues/2013>_,#2051 <https://github.com/Kozea/WeasyPrint/pull/2051>_: Apply margin to running tables *#1278 <https://github.com/Kozea/WeasyPrint/issues/1278>_,#1884 <https://github.com/Kozea/WeasyPrint/pull/1884>_: Draw collapsed borders of running tables *#2029 <https://github.com/Kozea/WeasyPrint/issues/2029>_: Fix page counter in non-root absolute boxes *#2043 <https://github.com/Kozea/WeasyPrint/pull/2043>_: Fix text-anchor on SVG tspan elements *#1968 <https://github.com/Kozea/WeasyPrint/issues/1968>_,#2039 <https://github.com/Kozea/WeasyPrint/pull/2039>_: Use cell's border-height to calculate table row height *#2030 <https://github.com/Kozea/WeasyPrint/issues/2030>_: Ensure that bounding box is set to invisible text tags *#2040 <https://github.com/Kozea/WeasyPrint/issues/2040>_,#2041 <https://github.com/Kozea/WeasyPrint/pull/2041>_: Don’t crash on malformed URLs *#2026 <https://github.com/Kozea/WeasyPrint/issues/2026>_: Don’t break pages when fixed-height elements don’t overflow page *#2038 <https://github.com/Kozea/WeasyPrint/issues/2038>_: Don’t mix original streams when drawing transparent text *#2016 <https://github.com/Kozea/WeasyPrint/issues/2016>_: Avoid duplication when breaking out-of-flow boxes *#2012 <https://github.com/Kozea/WeasyPrint/issues/2012>_: Don’t crash when CSS properties have no value *#2010 <https://github.com/Kozea/WeasyPrint/issues/2010>_,#1287 <https://github.com/Kozea/WeasyPrint/issues/1287>_: Fix many corner cases with CSS variables *#1996 <https://github.com/Kozea/WeasyPrint/issues/1996>_: Don’t crash when drawing groove/ridge collapsed borders *#1982 <https://github.com/Kozea/WeasyPrint/issues/1982>_: Fix SVG markers size, position and drawing

Documentation:

* #2021 <https://github.com/Kozea/WeasyPrint/issues/2021>_,#2048 <https://github.com/Kozea/WeasyPrint/pull/2048>_: Replace non-virtualenv installation instructions with distribution packages

Contributors:

* Guillaume Ayoub * kygoh * Lucie Anglade * Timo Ramsauer * Alexander Gitter * Michael Lisitsa * Vagner José Nicolodi * Manolis Stamatogiannakis * Pascal de Bruijn * Viktor Shevtsov * Eduardo Gonzalez * Kesara Rathnayake

Backers and sponsors:

Version 60.2 ------------

Released on 2023-12-11.

Bug fixes:

* #1982 <https://github.com/Kozea/WeasyPrint/issues/1982>_: Fix SVG markers size, position and drawing *23cfc775 <https://github.com/Kozea/WeasyPrint/commit/23cfc775>_: Draw background behind absolutely positioned replaced boxes *fe2f0c69 <https://github.com/Kozea/WeasyPrint/commit/fe2f0c69>_: Don’t crash with bitmap fonts with no "glyf" table *14605225 <https://github.com/Kozea/WeasyPrint/commit/14605225>_: Improve SVG text-anchor attribute

Contributors:

* Guillaume Ayoub

Backers and sponsors:

* Spacinov * Kobalt * Grip Angebotssoftware * Manuel Barkhau * SimonSoft * Menutech * KontextWork * NCC Group * René Fritz * Nicola Auchmuty * Syslifters * Hammerbacher * TrainingSparkle * Daniel Kucharski * Healthchecks.io * Yanal-Yves Fargialla * WakaTime * Paheko * Synapsium * DocRaptor

Version 60.1 ------------

Released on 2023-09-29.

Bug fixes:

* #1973 <https://github.com/Kozea/WeasyPrint/issues/1973>_: Fix crash caused by wrong UTF-8 indices

Contributors:

* Guillaume Ayoub

Backers and sponsors:

Version 60.0 ------------

Released on 2023-09-25.

New features:

* #1903 <https://github.com/Kozea/WeasyPrint/issues/1903>_: Print form fields *#1922 <https://github.com/Kozea/WeasyPrint/pull/1922>_: Add support for textLength and lengthAdjust in SVG text elements *#1965 <https://github.com/Kozea/WeasyPrint/issues/1965>_: Handle <wbr> tag *#1970 <https://github.com/Kozea/WeasyPrint/pull/1970>_: Handle y offset of glyphs *#1909 <https://github.com/Kozea/WeasyPrint/issues/1909>_: Add a --timeout option

Bug fixes:

* #1887 <https://github.com/Kozea/WeasyPrint/pull/1887>_: Fix footnote-call displayed incorrectly for some fonts *#1890 <https://github.com/Kozea/WeasyPrint/pull/1890>_: Fix page-margin boxes layout algorithm *#1908 <https://github.com/Kozea/WeasyPrint/pull/1908>_: Fix IndexError when rendering PDF version 1.4 *#1906 <https://github.com/Kozea/WeasyPrint/issues/1906>_: Apply text transformations to first-letter pseudo elements *#1915 <https://github.com/Kozea/WeasyPrint/pull/1915>_: Avoid footnote appearing before its call *#1934 <https://github.com/Kozea/WeasyPrint/pull/1934>_: Fix balance before "column-span: all" *#1935 <https://github.com/Kozea/WeasyPrint/issues/1935>_: Only draw required glyph with OpenType-SVG fonts *#1595 <https://github.com/Kozea/WeasyPrint/issues/1595>_: Don’t draw clipPath when defined after reference *#1895 <https://github.com/Kozea/WeasyPrint/pull/1895>_: Don’t ignore min-width when computing cell size *#1899 <https://github.com/Kozea/WeasyPrint/pull/1899>_: Fix named pages inheritance *#1936 <https://github.com/Kozea/WeasyPrint/pull/1936>_: Avoid page breaks caused by children of overflow hidden boxes *#1943 <https://github.com/Kozea/WeasyPrint/issues/1943>_: Use bleed area for page’s painting area *#1946 <https://github.com/Kozea/WeasyPrint/issues/1946>_: Use margin box of children to define available width for leaders

Contributors:

* Guillaume Ayoub * Sahil Rohilla * Azharuddin Syed * kygoh * Andy Lenards * Gaurav Samudra * Michael Wedl * Lucie Anglade * Obeida Shamoun * Evgeniy Krysanov

Backers and sponsors:

Version 59.0 ------------

Released on 2023-05-11.

This version also includes the changes from unstable b1 version listed below.

Bug fixes:

* #1864 <https://github.com/Kozea/WeasyPrint/issues/1864>_: Handle overflow for svg and symbol tags in SVG images *#1867 <https://github.com/Kozea/WeasyPrint/pull/1867>_: Remove duplicate compression of attachments *d0ad5c1 <https://github.com/Kozea/WeasyPrint/commit/d0ad5c1>_: Override use tag children instead of drawing their references *93df1a5 <https://github.com/Kozea/WeasyPrint/commit/93df1a5>_: Don’t resize the same image twice when the --dpi option is set *#1874 <https://github.com/Kozea/WeasyPrint/pull/1874>_: Drawn underline and overline behind text

Contributors:

* Guillaume Ayoub * Timo Ramsauer * Alexander Mankuta

Backers and sponsors:

* Castedo Ellerman * Kobalt * Spacinov * Grip Angebotssoftware * Crisp BV * Manuel Barkhau * SimonSoft * Menutech * KontextWork * NCC Group * René Fritz * Moritz Mahringer * Yanal-Yves Fargialla * Piotr Horzycki * Healthchecks.io * TrainingSparkle * Hammerbacher * Synapsium

Version 59.0b1 --------------

Released on 2023-04-14.

This version is experimental, don't use it in production. If you find bugs, please report them!

Command-line API:

* The --optimize-size option and its short equivalent -Ohave been deprecated. To activate or deactivate different size optimizations, you can now use:

* --uncompressed-pdf, *--optimize-images, *--full-fonts, *--hinting, *--dpi <resolution>, and *--jpeg-quality <quality>.

* A new --cache-folder <folder>option has been added to store temporary data in the given folder on the disk instead of keeping them in memory.

Python API:

Global rendering options are now given in *optionsinstead of dedicated parameters, with slightly different names. It means that the signature of theHTML.render(), HTML.write_pdf() and Document.write_pdf()has changed. Here are the steps to port your Python code to v59.0:

1. Use named parameters for these functions, not positioned parameters. 2. Rename some the parameters:

* image_cache becomes cache(see below), *identifier becomes pdf_identifier, *variant becomes pdf_variant, *version becomes pdf_version, *forms becomes pdf_forms.

* The optimize_size parameter of HTML.render(), HTML.write_pdf()andDocument()has been removed and will be ignored. You can now use theuncompressed_pdf, full_fonts, hinting, dpiandjpeg_quality parameters that are included in options.

The cache parameter can be included in *optionsto replaceimage_cache. If it is a dictionary, this dictionary will be used to store temporary data in memory, and can be even shared between multiple documents. If it’s a folder Path or string, WeasyPrint stores temporary data in the given temporary folder on disk instead of keeping them in memory.

New features:

* #1853 <https://github.com/Kozea/WeasyPrint/pull/1853>_,#1854 <https://github.com/Kozea/WeasyPrint/issues/1854>_: Reduce PDF size, with financial support from Code & Co. *#1824 <https://github.com/Kozea/WeasyPrint/issues/1824>_,#1829 <https://github.com/Kozea/WeasyPrint/pull/1829>_: Reduce memory use for images *#1858 <https://github.com/Kozea/WeasyPrint/issues/1858>_: Add an option to keep hinting information in embedded fonts

Bug fixes:

* #1855 <https://github.com/Kozea/WeasyPrint/issues/1855>_: Fix position of emojis in justified text *#1852 <https://github.com/Kozea/WeasyPrint/issues/1852>_: Don’t crash when line can be split before trailing spaces *#1843 <https://github.com/Kozea/WeasyPrint/issues/1843>_: Fix syntax of dates in metadata *#1827 <https://github.com/Kozea/WeasyPrint/issues/1827>_,#1832 <https://github.com/Kozea/WeasyPrint/pull/1832>_: Fix word-spacing problems with nested tags

Documentation:

* #1841 <https://github.com/Kozea/WeasyPrint/issues/1841>_: Add a paragraph about unsupported calc() function

Contributors:

* Guillaume Ayoub * Lucie Anglade * Alex Ch * whi_ne * Jonas Castro

Backers and sponsors:

Version 58.1 ------------

Released on 2023-03-07.

Bug fixes:

* #1815 <https://github.com/Kozea/WeasyPrint/issues/1815>_: Fix bookmarks coordinates *#1822 <https://github.com/Kozea/WeasyPrint/issues/1822>_,#1823 <https://github.com/Kozea/WeasyPrint/pull/1823>_: Fix vertical positioning for absolute replaced elements

Documentation:

* #1814 <https://github.com/Kozea/WeasyPrint/pull/1814>_: Fix broken link pointing to samples

Contributors:

* Guillaume Ayoub * Jonas Castro * Lucie Anglade * Menelaos Kotoglou

Backers and sponsors:

* Kobalt * Grip Angebotssoftware * Spacinov * Crisp BV * Castedo Ellerman * Manuel Barkhau * SimonSoft * Menutech * KontextWork * NCC Group * René Fritz * Moritz Mahringer * Yanal-Yves Fargialla * Piotr Horzycki * Healthchecks.io * Hammerbacher * TrainingSparkle * Synapsium

Version 58.0 ------------

Released on 2023-02-17.

This version also includes the changes from unstable b1 version listed below.

Bug fixes:

* #1807 <https://github.com/Kozea/WeasyPrint/issues/1807>_: Don’t crash when out-of-flow box is split in out-of-flow parent *#1806 <https://github.com/Kozea/WeasyPrint/issues/1806>_: Don’t crash when fixed elements aren’t displayed yet in aborted line *#1809 <https://github.com/Kozea/WeasyPrint/issues/1809>_: Fix background drawing for out-of-the-page transformed boxes

Contributors:

* Guillaume Ayoub

Backers and sponsors:

* Kobalt * Grip Angebotssoftware * Crisp BV * Spacinov * Castedo Ellerman * Manuel Barkhau * SimonSoft * Menutech * KontextWork * NCC Group * René Fritz * Moritz Mahringer * Yanal-Yves Fargialla * Piotr Horzycki * Healthchecks.io

Version 58.0b1 --------------

Released on 2023-02-03.

This version is experimental, don't use it in production. If you find bugs, please report them!

New features:

* #61 <https://github.com/Kozea/WeasyPrint/issues/61>_,#1796 <https://github.com/Kozea/WeasyPrint/pull/1796>_: Support PDF forms, with financial support from Personalkollen *#1173 <https://github.com/Kozea/WeasyPrint/issues/1173>_: Add style for form fields

Bug fixes:

* #1777 <https://github.com/Kozea/WeasyPrint/issues/1777>_: Detect JPEG/MPO images as normal JPEG files *#1771 <https://github.com/Kozea/WeasyPrint/pull/1771>_: Improve SVG gradients

Contributors:

* Guillaume Ayoub * Lucie Anglade

Backers and sponsors:

Version 57.2 ------------

Released on 2022-12-23.

Bug fixes:

* 0f2e377 <https://github.com/Kozea/WeasyPrint/commit/0f2e377>_: Print annotations with PDF/A *0e9426f <https://github.com/Kozea/WeasyPrint/commit/0e9426f>_: Hide annotations with PDF/UA *#1764 <https://github.com/Kozea/WeasyPrint/issues/1764>_: Use reference instead of stream for annotation appearance stream *#1783 <https://github.com/Kozea/WeasyPrint/pull/1783>_: Fix multiple font weights for @font-face declarations

Contributors:

* Guillaume Ayoub

Backers and sponsors:

* Grip Angebotssoftware * Manuel Barkhau * Crisp BV * SimonSoft * Menutech * Spacinov * KontextWork * René Fritz * NCC Group * Kobalt * Tom Pohl * Castedo Ellerman * Moritz Mahringer * Piotr Horzycki * Gábor Nyers * Sidharth Kapur

Version 57.1 ------------

Released on 2022-11-04.

Dependencies:

* #1754 <https://github.com/Kozea/WeasyPrint/pull/1754>_: Pillow 9.1.0 is now needed

Bug fixes:

* #1756 <https://github.com/Kozea/WeasyPrint/pull/1756>_: Fix rem font size for SVG images *#1755 <https://github.com/Kozea/WeasyPrint/issues/1755>_: Keep format when transposing images *#1753 <https://github.com/Kozea/WeasyPrint/issues/1753>_: Don’t use deprecatedread_text function when filesis available *#1741 <https://github.com/Kozea/WeasyPrint/issues/1741>_: Generate better manpage *#1747 <https://github.com/Kozea/WeasyPrint/issues/1747>_: Correctly set target counters in pages’ absolute elements *#1748 <https://github.com/Kozea/WeasyPrint/issues/1748>_: Always set font size when font is changed in line *2b05137 <https://github.com/Kozea/WeasyPrint/commit/2b05137>_: Fix stability of font identifiers

Documentation:

* #1750 <https://github.com/Kozea/WeasyPrint/pull/1750>_: Fix documentation spelling

Contributors:

* Guillaume Ayoub * Eli Schwartz * Mikhail Anikin * Scott Kitterman

Backers and sponsors:

* Grip Angebotssoftware * Manuel Barkhau * Crisp BV * SimonSoft * Menutech * Spacinov * KontextWork * René Fritz * NCC Group * Kobalt * Tom Pohl * John R Ellis * Castedo Ellerman * Moritz Mahringer * Gábor * Piotr Horzycki

Version 57.0 ------------

Released on 2022-10-18.

This version also includes the changes from unstable b1 version listed below.

New features:

* a4fc7a1 <https://github.com/Kozea/WeasyPrint/commit/a4fc7a1>_: Support image-orientation

Bug fixes:

* #1739 <https://github.com/Kozea/WeasyPrint/issues/1739>_: Set baseline on all flex containers *#1740 <https://github.com/Kozea/WeasyPrint/issues/1740>_: Don’t crash when currentColor is set on root svg tag *#1718 <https://github.com/Kozea/WeasyPrint/issues/1718>_: Don’t crash with empty bitmap glyphs *#1736 <https://github.com/Kozea/WeasyPrint/issues/1736>_: Always use the font’s vector variant when possible *eef8b4d <https://github.com/Kozea/WeasyPrint/commit/eef8b4d>_: Always set color and state before drawing *#1662 <https://github.com/Kozea/WeasyPrint/issues/1662>_: Use a stable key to store stream fonts *#1733 <https://github.com/Kozea/WeasyPrint/issues/1733>_: Don’t remove attachments when adding internal anchors *3c4fa50 <https://github.com/Kozea/WeasyPrint/commit/3c4fa50>_,c215697 <https://github.com/Kozea/WeasyPrint/commit/c215697>_,d275dac <https://github.com/Kozea/WeasyPrint/commit/d275dac>_,b04bfff <https://github.com/Kozea/WeasyPrint/commit/b04bfff>_: Fix many bugs related to PDF/UA structure

Performance:

* dfccf1b <https://github.com/Kozea/WeasyPrint/commit/dfccf1b>_: Use faces as fonts dictionary keys *0dc12b6 <https://github.com/Kozea/WeasyPrint/commit/0dc12b6>_: Cache add_font to avoid calling get_face too often *75e17bf <https://github.com/Kozea/WeasyPrint/commit/75e17bf>_: Don’t call process_whitespace twice on many children *498d3e1 <https://github.com/Kozea/WeasyPrint/commit/498d3e1>_: Optimize __missing__ functions

Documentation:

* 863b3d6 <https://github.com/Kozea/WeasyPrint/commit/863b3d6>_: Update documentation of installation on macOS with Homebrew

Contributors:

* Guillaume Ayoub

Backers and sponsors:

Version 57.0b1 --------------

Released on 2022-09-22.

This version is experimental, don't use it in production. If you find bugs, please report them!

New features:

* #1704 <https://github.com/Kozea/WeasyPrint/pull/1704>_: Support PDF/UA, with financial support from Novareto *#1454 <https://github.com/Kozea/WeasyPrint/issues/1454>_: Support variable fonts

Bug fixes:

* #1058 <https://github.com/Kozea/WeasyPrint/issues/1058>_: Fix bullet position after page break, with financial support from OpenZeppelin *#1707 <https://github.com/Kozea/WeasyPrint/issues/1707>_: Fix footnote positioning in multicolumn layout, with financial support from Code & Co. *#1722 <https://github.com/Kozea/WeasyPrint/issues/1722>_: Handle skew transformation with only one parameter *#1715 <https://github.com/Kozea/WeasyPrint/issues/1715>_: Don’t crash when images are truncated *#1697 <https://github.com/Kozea/WeasyPrint/issues/1697>_: Don’t crash when attr() is used in text-decoration-color *#1695 <https://github.com/Kozea/WeasyPrint/pull/1695>_: Include language information in PDF metadata *#1612 <https://github.com/Kozea/WeasyPrint/issues/1612>_: Don’t lowercase letters when capitalizing text *#1700 <https://github.com/Kozea/WeasyPrint/issues/1700>_: Fix crash when rendering footnote with repagination *#1667 <https://github.com/Kozea/WeasyPrint/issues/1667>_: Follow EXIF metadata for image rotation *#1669 <https://github.com/Kozea/WeasyPrint/issues/1669>_: Take care of floats when remvoving placeholders *#1638 <https://github.com/Kozea/WeasyPrint/issues/1638>_: Use the original box when breaking waiting children

Contributors:

* Guillaume Ayoub * Konstantin Weddige * VeteraNovis * Lucie Anglade

Backers and sponsors:

* Grip Angebotssoftware * Manuel Barkhau * Crisp BV * SimonSoft * Menutech * Spacinov * KontextWork * René Fritz * NCC Group * Kobalt * Tom Pohl * John R Ellis * Moritz Mahringer * Gábor * Piotr Horzycki * Andrew Ittner

Version 56.1 ------------

Released on 2022-07-24.

Bug fixes:

* #1674 <https://github.com/Kozea/WeasyPrint/issues/1674>_: Follow max-height on footnot area, with financial support from Code & Co. *#1678 <https://github.com/Kozea/WeasyPrint/issues/1678>_: Fix gradients with opacity set

Contributors:

* Guillaume Ayoub * Lucie Anglade

Backers and sponsors:

* Grip Angebotssoftware * Manuel Barkhau * Crisp BV * SimonSoft * Menutech * Spacinov * KontextWork * René Fritz * NCC Group * Kobalt * Tom Pohl * Moritz Mahringer * Florian Demmer * Yanal-Yves Fargialla * Gábor * Piotr Horzycki * Andrew Ittner

Version 56.0 ------------

Released on 2022-07-07.

This version also includes the changes from unstable b1 version listed below.

New features:

* 70f9b62 <https://github.com/Kozea/WeasyPrint/commit/70f9b62>_: Support format 5 for bitmap glyphs

Bug fixes:

* #1666 <https://github.com/Kozea/WeasyPrint/issues/1666>_ Fix reproducible PDF generation with embedded images *#1668 <https://github.com/Kozea/WeasyPrint/issues/1668>_: Fix @page:nth() selector *3bd9a8e <https://github.com/Kozea/WeasyPrint/commit/3bd9a8e>_: Don’t limit the opacity groups to the original box size *cb9540b <https://github.com/Kozea/WeasyPrint/commit/cb9540b>_,76d174f <https://github.com/Kozea/WeasyPrint/commit/76d174f>_,9ce6547 <https://github.com/Kozea/WeasyPrint/commit/9ce6547>_: Minor bugfixes for split table rows

Contributors:

* Guillaume Ayoub

Backers and sponsors:

* Grip Angebotssoftware * Manuel Barkhau * Crisp BV * SimonSoft * Menutech * Spacinov * KontextWork * René Fritz * NCC Group * Kobalt * Des images et des mots * Andreas Zettl * Tom Pohl * Moritz Mahringer * Florian Demmer * Yanal-Yves Fargialla * Gábor * Piotr Horzycki

Version 56.0b1 --------------

Released on 2022-06-17.

This version is experimental, don't use it in production. If you find bugs, please report them!

Dependencies:

* pydyf 0.2.0+ is now needed

New features:

* #1660 <https://github.com/Kozea/WeasyPrint/pull/1660>_: Support nested line-clamp, with financial support from Expert Germany *#1644 <https://github.com/Kozea/WeasyPrint/pull/1644>_,#1645 <https://github.com/Kozea/WeasyPrint/issues/1645>_: Support bitmap fonts, with financial support from Expert Germany *#1651 <https://github.com/Kozea/WeasyPrint/pull/1651>_,#630 <https://github.com/Kozea/WeasyPrint/issues/630>_: Support PDF/A, with financial support from Blueshoe

Bug fixes:

* #1656 <https://github.com/Kozea/WeasyPrint/issues/1656>_: Fix chained variables in the same selector block *#1028 <https://github.com/Kozea/WeasyPrint/issues/1028>_: Fix font weight management in @font-face rules *#1653 <https://github.com/Kozea/WeasyPrint/issues/1653>_: Don’t crash when @font-face’s src ends with a comma *#1650 <https://github.com/Kozea/WeasyPrint/issues/1650>_: Don’t check origin when URL only contains fragment *e38bff8 <https://github.com/Kozea/WeasyPrint/commit/e38bff8>_: Don’t crash when inherited SVG attributes are not set on the parent

Performance:

* e6021da <https://github.com/Kozea/WeasyPrint/commit/e6021da>_: Launch tests in parallel by default

Contributors:

* Guillaume Ayoub * aschmitz * Lucie Anglade

Backers and sponsors:

Version 55.0 ------------

Released on 2022-05-12.

This version also includes the changes from unstable b1 version listed below.

Bug fixes:

* #1626 <https://github.com/Kozea/WeasyPrint/issues/1626>_,3802f88 <https://github.com/Kozea/WeasyPrint/commit/3802f88>_: Fix the vertical position and available height of absolute boxes *9641098 <https://github.com/Kozea/WeasyPrint/commit/9641098>_,e5e6b88 <https://github.com/Kozea/WeasyPrint/commit/e5e6b88>_: Minor fixes for multi-column layout *0fcc7de <https://github.com/Kozea/WeasyPrint/commit/0fcc7de>_: Don’t stop rendering SVG when CSS parsing fails *#1636 <https://github.com/Kozea/WeasyPrint/pull/1636>_: Fix sequential footnotes that could disappear when overflowing *#1637 <https://github.com/Kozea/WeasyPrint/issues/1637>_: Fix position of absolute boxes with right-to-left direction *#1641 <https://github.com/Kozea/WeasyPrint/issues/1641>_: Fix relative paths for SVG files stored as data URLs

Contributors:

* Guillaume Ayoub * aschmitz

Backers and sponsors:

* Grip Angebotssoftware * Manuel Barkhau * Crisp BV * SimonSoft * Menutech * Spacinov * KontextWork * René Fritz * NCC Group * Kobalt * Nathalie Gutton * Andreas Zettl * Tom Pohl * Moritz Mahringer * Florian Demmer * Yanal-Yves Fargialla * Gábor * Piotr Horzycki

Version 55.0b1 --------------

Released on 2022-04-15.

This version is experimental, don't use it in production. If you find bugs, please report them!

Dependencies:

* Python 3.7+ is now needed, Python 3.6 is not supported anymore

New features:

* #1534 <https://github.com/Kozea/WeasyPrint/pull/1534>_: Supportword-break: break-all*#489 <https://github.com/Kozea/WeasyPrint/issues/489>_,#1619 <https://github.com/Kozea/WeasyPrint/pull/1619>_: Support column breaks *#1553 <https://github.com/Kozea/WeasyPrint/issues/1553>_: Allow reproducible PDF generation

Bug fixes:

* #1007 <https://github.com/Kozea/WeasyPrint/issues/1007>_,#1524 <https://github.com/Kozea/WeasyPrint/pull/1524>_: Handleinheritin shorthand properties *#1539 <https://github.com/Kozea/WeasyPrint/issues/1539>_,#1541 <https://github.com/Kozea/WeasyPrint/pull/1541>_: Space out no-repeat patterns *#1554 <https://github.com/Kozea/WeasyPrint/pull/1554>_: Avoid invalid PDF operators when drawing SVG text *#1564 <https://github.com/Kozea/WeasyPrint/issues/1564>_,#1566 <https://github.com/Kozea/WeasyPrint/pull/1566>_,#1570 <https://github.com/Kozea/WeasyPrint/pull/1570>_: Don’t output footnotes before their call sites *#1020 <https://github.com/Kozea/WeasyPrint/issues/1020>_,#1597 <https://github.com/Kozea/WeasyPrint/pull/1597>_: Prevent infinite loops in multi-column layout *#1512 <https://github.com/Kozea/WeasyPrint/issues/1512>_,#1613 <https://github.com/Kozea/WeasyPrint/pull/1613>_: Fix position of absolute boxes in right-to-left contexts *#1093 <https://github.com/Kozea/WeasyPrint/issues/1093>_: Draw borders around absolute replaced boxes *#984 <https://github.com/Kozea/WeasyPrint/issues/984>_,#1604 <https://github.com/Kozea/WeasyPrint/issues/1604>_: Fix skip stacks for columns *#1621 <https://github.com/Kozea/WeasyPrint/issues/1621>_: Better support of nestedtext-decorationproperties *fe1f3d9 <https://github.com/Kozea/WeasyPrint/commit/fe1f3d9>_: Fix absolute blocks in lines *4650b70 <https://github.com/Kozea/WeasyPrint/commit/4650b70>_: Clear adjoining margins when a container’s child doesn’t fit

Performance:

* #1548 <https://github.com/Kozea/WeasyPrint/pull/1548>_: Improve tests speed *3b0ae92 <https://github.com/Kozea/WeasyPrint/commit/3b0ae92>_,#1457 <https://github.com/Kozea/WeasyPrint/issues/1457>_: Improve fonts management *#1597 <https://github.com/Kozea/WeasyPrint/pull/1597>_: Improve column layout speed *#1587 <https://github.com/Kozea/WeasyPrint/pull/1587>_,#1607 <https://github.com/Kozea/WeasyPrint/pull/1607>_,#1608 <https://github.com/Kozea/WeasyPrint/pull/1608>_: Cachech and ex units calculations

Contributors:

* Guillaume Ayoub * aschmitz * Lucie Anglade * Christoph Kepper * Jack Lin * Rian McGuire

Backers and sponsors:

* Grip Angebotssoftware * Manuel Barkhau * Crisp BV * SimonSoft * Menutech * KontextWork * Maykin Media * René Fritz * NCC Group * Spacinov * Nathalie Gutton * Andreas Zettl * Tom Pohl * Kobalt * Moritz Mahringer * Florian Demmer * Yanal-Yves Fargialla * Gábor * Piotr Horzycki * DeivGuerrero

Version 54.3 ------------

Released on 2022-04-04.

Bug fixes:

* #1588 <https://github.com/Kozea/WeasyPrint/pull/1588>_: Support position: absolute in footnotes *#1586 <https://github.com/Kozea/WeasyPrint/issues/1586>_: Fix discarded text-align values

Contributors:

* aschmitz * Guillaume Ayoub

Backers and sponsors:

Version 54.2 ------------

Released on 2022-02-27.

Bug fixes:

* #1575 <https://github.com/Kozea/WeasyPrint/issues/1575>_: Always store parent blocks children as lists *#1574 <https://github.com/Kozea/WeasyPrint/issues/1574>_,#1559 <https://github.com/Kozea/WeasyPrint/pull/1559>_: Fix float rounding errors *#1571 <https://github.com/Kozea/WeasyPrint/issues/1571>_: Ignore unknown glyphs *#1561 <https://github.com/Kozea/WeasyPrint/issues/1561>_,#1562 <https://github.com/Kozea/WeasyPrint/issues/1562>_: Fix line break when breaks occur between a nbsp and an inline block *#1560 <https://github.com/Kozea/WeasyPrint/issues/1560>_: Always set the child index *#1558 <https://github.com/Kozea/WeasyPrint/issues/1558>_: Fix patterns with use tags

Contributors:

* Guillaume Ayoub * Lucie Anglade * Jack Lin * aschmitz

Backers and sponsors:

Version 54.1 ------------

Released on 2022-01-31.

New features:

* #1547 <https://github.com/Kozea/WeasyPrint/issues/1547>_: Handle break-inside: avoid on tr tags

Bug fixes:

* #1540 <https://github.com/Kozea/WeasyPrint/issues/1540>_,#1239 <https://github.com/Kozea/WeasyPrint/issues/1239>_: Handle absolute children in running elements *#1538 <https://github.com/Kozea/WeasyPrint/issues/1538>_: Handle invalid values in text-align *#1536 <https://github.com/Kozea/WeasyPrint/issues/1536>_: Handle absolute flex boxes

Contirbutors:

* Guillaume Ayoub * Lucie Anglade

Backers and sponsors:

* H-Net: Humanities and Social Sciences Online * Grip Angebotssoftware * Manuel Barkhau * SimonSoft * Menutech * KontextWork * Crisp BV * Maykin Media * René Fritz * Simon Sapin * NCC Group * Nathalie Gutton * Andreas Zettl * Tom Pohl * Spacinov * Des images et des mots * Moritz Mahringer * Florian Demmer * Yanal-Yves Fargialla * Gábor * Piotr Horzycki

Version 54.0 ------------

Released on 2022-01-08.

This version also includes the changes from unstable b1 version listed below.

Bug fixes:

* #1531 <https://github.com/Kozea/WeasyPrint/issues/1531>_: Always use absolute paths to get hrefs in SVG *#1523 <https://github.com/Kozea/WeasyPrint/issues/1523>_: Fix many rendering problems of broken tables *e1aee70 <https://github.com/Kozea/WeasyPrint/commit/e1aee70>_: Fix support of fonts with SVG emojis

Contirbutors:

* Guillaume Ayoub

Backers and sponsors:

* Grip Angebotssoftware * Manuel Barkhau * SimonSoft * Menutech * KontextWork * Crisp BV * Maykin Media * René Fritz * Simon Sapin * NCC Group * Nathalie Gutton * Andreas Zettl * Tom Pohl * Des images et des mots * Moritz Mahringer * Florian Demmer * Yanal-Yves Fargialla * Gábor * Piotr Horzycki

Version 54.0b1 --------------

Released on 2021-12-13.

This version is experimental, don't use it in production. If you find bugs, please report them!

Dependencies:

* html5lib 1.1+ is now needed.

New features:

* #1509 <https://github.com/Kozea/WeasyPrint/pull/1509>_: Support footnotes, with financial support from Code & Co. *#36 <https://github.com/Kozea/WeasyPrint/issues/36>_: Handle parallel flows for floats, absolutes, table-cells *#1389 <https://github.com/Kozea/WeasyPrint/pull/1389>_: Supporttext-align-last and text-align-allproperties *#1434 <https://github.com/Kozea/WeasyPrint/pull/1434>_: Draw SVG and PNG emojis *#1520 <https://github.com/Kozea/WeasyPrint/pull/1520>_: Supportoverflow-wrap: anywhere*#1435 <https://github.com/Kozea/WeasyPrint/issues/1435>_: Add environment variable to set DLL folder on Windows

Performance:

* #1439 <https://github.com/Kozea/WeasyPrint/issues/1439>_: Cache SVGusetags *#1481 <https://github.com/Kozea/WeasyPrint/pull/1481>_: Encode non-JPEG images as PNGs instead of JPEG2000s

Bug fixes:

* #137 <https://github.com/Kozea/WeasyPrint/issues/137>_: Don’t usetext-transformtext for content-based uses *#1443 <https://github.com/Kozea/WeasyPrint/issues/1443>_: Don’t serialize and parse again inline SVG files *#607 <https://github.com/Kozea/WeasyPrint/issues/607>_: Correctly handle whitespaces in bookmark labels *#1094 <https://github.com/Kozea/WeasyPrint/issues/1094>_: Fix column height withcolumn-spancontent *#1473 <https://github.com/Kozea/WeasyPrint/issues/1473>_: Fix absolutely positioned boxes in duplicated pages *#1491 <https://github.com/Kozea/WeasyPrint/issues/1491>_: Fixtarget-counterattribute in flex items *#1515 <https://github.com/Kozea/WeasyPrint/issues/1515>_,#1508 <https://github.com/Kozea/WeasyPrint/issues/1508>_: Don’t draw empty glyphs *#1499 <https://github.com/Kozea/WeasyPrint/issues/1499>_: Don’t crash when font size is really small

Documentation:

* #1519 <https://github.com/Kozea/WeasyPrint/issues/1519>_: Fix typo

Packaging:

* The source package does not include a setup.pyfile anymore. You can find more information about this inissue #1410 <https://github.com/Kozea/WeasyPrint/issues/1410>_.

Contirbutors:

* Guillaume Ayoub * Lucie Anglade * Colin Kinloch * aschmitz * Pablo González * Rian McGuire

Backers and sponsors:

Version 53.4 ------------

Released on 2021-11-14.

Bug fixes:

* #1446 <https://github.com/Kozea/WeasyPrint/issues/1446>_: Fix background on pages with a bleed property *#1455 <https://github.com/Kozea/WeasyPrint/issues/1455>_: Use SVG width/height as inner size when no viewBox is given *#1469 <https://github.com/Kozea/WeasyPrint/issues/1469>_: Only enable letter- and word-spacing when needed *#1471 <https://github.com/Kozea/WeasyPrint/issues/1471>_: Don’t display inputs with "hidden" type *#1485 <https://github.com/Kozea/WeasyPrint/issues/1485>_: Allow quotes in url() syntax for SVG, Use better approximations for font ascent and descent values in SVG *#1486 <https://github.com/Kozea/WeasyPrint/issues/1486>_: Fix images embedded from multiple pages *#1489 <https://github.com/Kozea/WeasyPrint/issues/1489>_: Use a better hash for fonts to avoid collisions *abd54c4 <https://github.com/Kozea/WeasyPrint/commit/abd54c4>_: Set SVG ratio when width and height are 0

Contributors:

* Guillaume Ayoub * Lucie Anglade

Backers and sponsors:

* Grip Angebotssoftware * SimonSoft * Menutech * Manuel Barkhau * Simon Sapin * KontextWork * René Fritz * Maykin Media * NCC Group * Crisp BV * Des images et des mots * Andreas Zettl * Nathalie Gutton * Tom Pohl * Moritz Mahringer * Florian Demmer * Yanal-Yves Fargialla * G. Allard * Gábor

Version 53.3 ------------

Released on 2021-09-10.

Bug fixes:

* #1431 <https://github.com/Kozea/WeasyPrint/issues/1431>_,#1440 <https://github.com/Kozea/WeasyPrint/issues/1440>_: Fix crashes and malformed PDF files *#1430 <https://github.com/Kozea/WeasyPrint/issues/1430>_: Handle cx and cy in SVG rotations *#1436 <https://github.com/Kozea/WeasyPrint/pull/1436>_: Fix marker-start being drawn on mid vertices

Contributors:

* Guillaume Ayoub * Rian McGuire * Lucie Anglade

Backers and sponsors:

* Grip Angebotssoftware * SimonSoft * Menutech * Manuel Barkhau * Simon Sapin * KontextWork * René Fritz * Maykin Media * NCC Group * Des images et des mots * Andreas Zettl * Nathalie Gutton * Tom Pohl * Moritz Mahringer * Florian Demmer * Yanal-Yves Fargialla

Version 53.2 ------------

Released on 2021-08-27.

New features:

* #1428 <https://github.com/Kozea/WeasyPrint/issues/1428>_: Re-add themake_bookmark_tree() method

Bug fixes:

* #1429 <https://github.com/Kozea/WeasyPrint/issues/1429>_: Fix package deployed on PyPI

Contributors:

* Guillaume Ayoub

Backers and sponsors:

* Grip Angebotssoftware * PDF Blocks * SimonSoft * Menutech * Manuel Barkhau * Simon Sapin * KontextWork * René Fritz * Maykin Media * NCC Group * Des images et des mots * Andreas Zettl * Nathalie Gutton * Tom Pohl * Moritz Mahringer * Florian Demmer * Yanal-Yves Fargialla

Version 53.1 ------------

Released on 2021-08-22.

Bug fixes:

* #1409 <https://github.com/Kozea/WeasyPrint/issues/1409>_: Don’t crash when leaders are in floats *#1414 <https://github.com/Kozea/WeasyPrint/issues/1414>_: Embed images once *#1417 <https://github.com/Kozea/WeasyPrint/issues/1417>_: Fix crash with SVG intrinsic ratio

Documentation:

* #1422 <https://github.com/Kozea/WeasyPrint/issues/1422>_: Includeweasyprint.tools removal in documentation

Contributors:

* Guillaume Ayoub

Backers and sponsors:

Version 53.0 ------------

Released on 2021-07-31.

This version also includes the changes from unstable b1 and b2 versions listed below.

Dependencies:

* Pango 1.44.0+ is now needed. * pydyf 0.0.3+ is now needed. * fontTools 4.0.0+ is now needed. * html5lib 1.0.1+ is now needed.

API changes:

* FontConfiguration is now in the weasyprint.text.fontsmodule. *--format and --resolutionoptions have been deprecated, PDF is the only output format supported. *--optimize-imagesoption has been deprecated and replaced by--optimize-size, allowing images, fonts, all and nonevalues. *weasyprint.toolshave been removed. *Document.resolve_links, Document.make_bookmark_treeandDocument.add_hyperlinks have been removed.

Performance:

* Improve image management

New features:

* #1374 <https://github.com/Kozea/WeasyPrint/issues/1374>_: Support basic "clipPath" in SVG

Bug fixes:

* #1369 <https://github.com/Kozea/WeasyPrint/issues/1369>_: Render use path in SVG *#1370 <https://github.com/Kozea/WeasyPrint/issues/1370>_: Fix fill color on use path in SVG *#1371 <https://github.com/Kozea/WeasyPrint/issues/1371>_: Handle stroke-opacity and fill-opacity *#1378 <https://github.com/Kozea/WeasyPrint/issues/1378>_: Fix crash with borders whose widths are in em *#1394 <https://github.com/Kozea/WeasyPrint/issues/1394>_: Fix crash on draw_pattern *#880 <https://github.com/Kozea/WeasyPrint/issues/880>_: Handle stacking contexts put in contexts by previous generations *#1386 <https://github.com/Kozea/WeasyPrint/issues/1386>_: Catch font subsetting errors *#1403 <https://github.com/Kozea/WeasyPrint/issues/1403>_: Fix how x and y attributes are handled in SVG *#1399 <https://github.com/Kozea/WeasyPrint/issues/1399>_,#1401 <https://github.com/Kozea/WeasyPrint/pull/1401>_: Don’t crash when use tags reference non-existing element *#1393 <https://github.com/Kozea/WeasyPrint/issues/1393>_: Handle font collections *#1408 <https://github.com/Kozea/WeasyPrint/issues/1408>_: Handle x and y attributes in use tags

Documentation:

* #1391 <https://github.com/Kozea/WeasyPrint/issues/1391>_,#1405 <https://github.com/Kozea/WeasyPrint/pull/1405>_: Add documentation for installation

Contributors:

* Guillaume Ayoub * Lucie Anglade * Pelle Bo Regener * aschmitz * John Jackson * Felix Schwarz * Syrus Dark * Christoph Päper

Backers and sponsors:

* OpenEdition * Grip Angebotssoftware * Simonsoft * PDF Blocks * Menutech * Manuel Barkhau * print-css.rocks * Simon Sapin * KontextWork * René Fritz * Maykin Media * Nathalie Gutton * Andreas Zettl * Tom Pohl * NCC Group * Moritz Mahringer * Florian Demmer * Des images et des mots * Mohammed Y. Alnajdi * Yanal-Yves Fargialla * Yevhenii Hyzyla

Version 53.0b2 --------------

Released on 2021-05-30.

This version is experimental, don't use it in production. If you find bugs, please report them!

New features:

* #359 <https://github.com/Kozea/WeasyPrint/issues/359>_: Embed full sets of fonts in PDF

Bug fixes:

* #1345 <https://github.com/Kozea/WeasyPrint/issues/1345>_: Fix position of SVG use tags *#1346 <https://github.com/Kozea/WeasyPrint/pull/1346>_: Handle "stroke-dasharray: none" *#1352 <https://github.com/Kozea/WeasyPrint/issues/1352>_,#1358 <https://github.com/Kozea/WeasyPrint/pull/1358>_: Sort link target identifiers *#1357 <https://github.com/Kozea/WeasyPrint/issues/1357>_: Fix font information *#1362 <https://github.com/Kozea/WeasyPrint/issues/1362>_: Handle visibility and display properties in SVG *#1365 <https://github.com/Kozea/WeasyPrint/issues/1365>_: Cascade inherited attributes for use tags *#1366 <https://github.com/Kozea/WeasyPrint/issues/1366>_: Correctly handle style attributes in SVG *#1367 <https://github.com/Kozea/WeasyPrint/issues/1367>_: Include line stroke in box bounding

Documentation:

* #1341 <https://github.com/Kozea/WeasyPrint/pull/1341>_: Fix typos

Contributors:

* Guillaume Ayoub * aschmitz * John Jackson * Lucie Anglade * Pelle Bo Regener

Backers and sponsors:

* OpenEdition * print-css.rocks * Simonsoft * PDF Blocks * Menutech * Manuel Barkhau * Simon Sapin * Grip Angebotssoftware * KontextWork * René Fritz * Nathalie Gutton * Andreas Zettl * Tom Pohl * Maykin Media * Moritz Mahringer * Florian Demmer * Mohammed Y. Alnajdi * NCC Group * Des images et des mots * Yanal-Yves Fargialla * Yevhenii Hyzyla

Version 53.0b1 --------------

Released on 2021-04-22.

This version is experimental, don't use it in production. If you find bugs, please report them!

Dependencies:

* This version uses its own PDF generator instead of Cairo. Rendering may be different for text, gradients, SVG images… * Packaging is now done with Flit.

New features:

* #1328 <https://github.com/Kozea/WeasyPrint/pull/1328>_: Add ISO and JIS paper sizes *#1309 <https://github.com/Kozea/WeasyPrint/pull/1309>_: Leader support, with financial support from Simonsoft

Bug fixes:

* #504 <https://github.com/Kozea/WeasyPrint/issues/504>_: Fix rendering bugs with PDF gradients *#606 <https://github.com/Kozea/WeasyPrint/issues/606>_: Fix rounding errors on PDF dimensions *#1264 <https://github.com/Kozea/WeasyPrint/issues/1264>_: Include witdh/height when calculating auto margins of absolute boxes *#1191 <https://github.com/Kozea/WeasyPrint/issues/1191>_: Don’t try to get an earlier page break between columns *#1235 <https://github.com/Kozea/WeasyPrint/issues/1235>_: Include padding, border, padding when calculating inline-block width *#1199 <https://github.com/Kozea/WeasyPrint/issues/1199>_: Fix kerning issues with small fonts

Documentation:

* #1298 <https://github.com/Kozea/WeasyPrint/pull/1298>_: Rewrite documentation

Contributors:

* Guillaume Ayoub * Lucie Anglade * Felix Schwarz * Syrus Dark * Christoph Päper

Backers and sponsors:

* Simonsoft * PDF Blocks * Menutech * Manuel Barkhau * Simon Sapin * Nathalie Gutton * Andreas Zettl * René Fritz * Tom Pohl * KontextWork * Moritz Mahringer * Florian Demmer * Maykin Media * Yanal-Yves Fargialla * Des images et des mots * Yevhenii Hyzyla

Version 52.5 ------------

Released on 2021-04-17.

Bug fixes:

* #1336 <https://github.com/Kozea/WeasyPrint/issues/1336>_: Fix text breaking exception *#1318 <https://github.com/Kozea/WeasyPrint/issues/1318>_: Fix @font-face rules with Pango 1.48.3+

Contributors:

* Guillaume Ayoub

Backers and sponsors:

Version 52.4 ------------

Released on 2021-03-11.

Bug fixes:

* #1304 <https://github.com/Kozea/WeasyPrint/issues/1304>_: Don’t try to draw SVG files with no size *ece5f066 <https://github.com/Kozea/WeasyPrint/commit/ece5f066>_: Avoid crash on last word detection *4ee42e48 <https://github.com/Kozea/WeasyPrint/commit/4ee42e48>_: Remove last word before ellipses when hyphenated

Contributors:

* Guillaume Ayoub

Backers and sponsors:

* PDF Blocks * Simonsoft * Menutech * Simon Sapin * Manuel Barkhau * Andreas Zettl * Nathalie Gutton * Tom Pohl * René Fritz * Moritz Mahringer * Florian Demmer * KontextWork * Michele Mostarda

Version 52.3 ------------

Released on 2021-03-02.

Bug fixes:

* #1299 <https://github.com/Kozea/WeasyPrint/issues/1299>_: Fix imports with url() and quotes

New features:

* #1300 <https://github.com/Kozea/WeasyPrint/pull/1300>_: Add support of line-clamp, with financial support from expert Germany

Contributors:

* Guillaume Ayoub * Lucie Anglade

Backers and sponsors:

* PDF Blocks * Simonsoft * Menutech * Simon Sapin * Manuel Barkhau * Andreas Zettl * Nathalie Gutton * Tom Pohl * Moritz Mahringer * Florian Demmer * KontextWork * Michele Mostarda

Version 52.2 ------------

Released on 2020-12-06.

Bug fixes:

* 238e214 <https://github.com/Kozea/WeasyPrint/commit/238e214>_: Fix URL handling with tinycss2 *#1248 <https://github.com/Kozea/WeasyPrint/issues/1248>_: Include missing test data *#1254 <https://github.com/Kozea/WeasyPrint/issues/1254>_: Top margins removed from children when tables are displayed on multiple pages *#1250 <https://github.com/Kozea/WeasyPrint/issues/1250>_: Correctly draw borders on the last line of split tables *a6f9c80 <https://github.com/Kozea/WeasyPrint/commit/a6f9c80>_: Add a nice gif to please gdk-pixbuf 2.42.0

Contributors:

* Guillaume Ayoub * Lucie Anglade * Felix Schwarz

Backers and sponsors:

* PDF Blocks * Simonsoft * Menutech * Simon Sapin * Nathalie Gutton * Andreas Zetti * Tom Pohl * Florian Demmer * Moritz Mahringer

Version 52.1 ------------

Released on 2020-11-02.

Bug fixes:

* 238e214 <https://github.com/Kozea/WeasyPrint/commit/238e214>_: Fix URL handling with tinycss2

Contributors:

* Guillaume Ayoub

Backers and sponsors:

* Simonsoft * Simon Sapin * Nathalie Gutton * Andreas Zettl * Florian Demmer * Moritz Mahringer

Version 52 ----------

Released on 2020-10-29.

Dependencies:

* Python 3.6+ is now needed, Python 3.5 is not supported anymore * WeasyPrint now depends on Pillow

New features:

* #1019 <https://github.com/Kozea/WeasyPrint/issues/1019>_: Implementcounter-set*#1080 <https://github.com/Kozea/WeasyPrint/issues/1080>_: Don’t displaytemplatetags *#1210 <https://github.com/Kozea/WeasyPrint/pull/1210>_: Usedownload attribute in atags for attachment's filename *#1206 <https://github.com/Kozea/WeasyPrint/issues/1206>_: Handle strings inlist-style-type*#1165 <https://github.com/Kozea/WeasyPrint/pull/1165>_: Add support for concatenatingvar() functions in contentdeclarations *c56b96b <https://github.com/Kozea/WeasyPrint/commit/c56b96b>_: Add an option to optimize embedded images size, with financial support from Hashbang *#969 <https://github.com/Kozea/WeasyPrint/issues/969>_: Add an image cache that can be shared between documents, with financial support from Hashbang

Bug fixes:

* #1141 <https://github.com/Kozea/WeasyPrint/pull/1141>_: Don’t clip page margins on account ofbodyoverflow *#1000 <https://github.com/Kozea/WeasyPrint/issues/1000>_: Don’t applytext-indenttwice on inline blocks *#1051 <https://github.com/Kozea/WeasyPrint/issues/1051>_: Avoid random line breaks *#1120 <https://github.com/Kozea/WeasyPrint/pull/1120>_: Gather target counters in page margins *#1110 <https://github.com/Kozea/WeasyPrint/issues/1110>_: Handle most cases for boxes avoiding floats in rtl containers, with financial support from Innovative Software *#1111 <https://github.com/Kozea/WeasyPrint/issues/1111>_: Fix horizontal position of last rtl line, with financial support from Innovative Software *#1114 <https://github.com/Kozea/WeasyPrint/issues/1114>_: Fix bug with transparent borders in tables *#1146 <https://github.com/Kozea/WeasyPrint/pull/1146>_: Don’t gather bookmarks twice for blocks that are displayed on two pages *#1237 <https://github.com/Kozea/WeasyPrint/issues/1237>_: Use fallback fonts on unsupported WOFF2 and WOFF fonts *#1025 <https://github.com/Kozea/WeasyPrint/issues/1025>_: Don’t insert the same layout attributes multiple times *#1027 <https://github.com/Kozea/WeasyPrint/issues/1027>_: Don’t try to break tables after the header or before the footer *#1050 <https://github.com/Kozea/WeasyPrint/issues/1050>_: Don’t crash on absolute SVG files with no intrinsic size *#1204 <https://github.com/Kozea/WeasyPrint/issues/1204>_: Fix a crash with a flexbox corner case *#1030 <https://github.com/Kozea/WeasyPrint/pull/1030>_: Fix frozen builds *#1089 <https://github.com/Kozea/WeasyPrint/pull/1089>_: Fix Pyinstaller builds *#1216 <https://github.com/Kozea/WeasyPrint/pull/1213>_: Fix embedded files *#1225 <https://github.com/Kozea/WeasyPrint/pull/1225>_: Initial support of RTL direction in flexbox layout

Documentation:

* #1149 <https://github.com/Kozea/WeasyPrint/issues/1149>_: Add the--quietCLI option in the documentation *#1061 <https://github.com/Kozea/WeasyPrint/pull/1061>_: Update install instructions on Windows

Tests:

* #1209 <https://github.com/Kozea/WeasyPrint/pull/1209>_: Use GitHub Actions instead of Travis

Contributors:

* Guillaume Ayoub * Lucie Anglade * Tontyna * Mohammed Y. Alnajdi * Mike Voets * Bjarni Þórisson * Balázs Dukai * Bart Broere * Endalkachew * Felix Schwarz * Julien Sanchez * Konstantin Alekseev * Nicolas Hart * Nikolaus Schlemm * Thomas J. Lampoltshammer * mPyth * nempoBu4 * saddy001

Backers and sponsors:

* Hashbang * Innovative Software * Screenbreak * Simon Sapin * Lisa Warshaw * Nathalie Gutton * Andreas Zettl * Florian Demmer * Moritz Mahringer

Version 51 ----------

Released on 2019-12-23.

Dependencies:

* Pyphen 0.9.1+ is now needed

New features:

* #882 <https://github.com/Kozea/WeasyPrint/pull/882>_: Add support ofelement() and running()*#972 <https://github.com/Kozea/WeasyPrint/pull/972>_: Add HTML element to Box class *7a4d6f8 <https://github.com/Kozea/WeasyPrint/commit/7a4d6f8>_: Supportlarger and smaller values for font-size

Bug fixes:

* #960 <https://github.com/Kozea/WeasyPrint/pull/960>_: Fix how fonts used for macOS tests are installed *#956 <https://github.com/Kozea/WeasyPrint/pull/956>_: Fix various crashes due to line breaking bugs *#983 <https://github.com/Kozea/WeasyPrint/issues/983>_: Fix typo in variable name *#975 <https://github.com/Kozea/WeasyPrint/pull/975>_: Don’t crash whenstring-set is set to none*#998 <https://github.com/Kozea/WeasyPrint/pull/998>_: Keep font attributes when text lines are modified *#1005 <https://github.com/Kozea/WeasyPrint/issues/1005>_: Don’t let presentational hints add decorations on tables with no borders *#974 <https://github.com/Kozea/WeasyPrint/pull/974>_: Don’t crash on impropervar()values *#1012 <https://github.com/Kozea/WeasyPrint/pull/1012>_: Fix rendering of header and footer for empty tables *#1013 <https://github.com/Kozea/WeasyPrint/issues/1013>_: Avoid quadratic time relative to tree depth when setting page names

Contributors:

- Lucie Anglade - Guillaume Ayoub - Guillermo Bonvehí - Holger Brunn - Felix Schwarz - Tontyna

Version 50 ----------

Released on 2019-09-19.

New features:

* #209 <https://github.com/Kozea/WeasyPrint/issues/209>_: Makebreak-*properties work inside tables *#661 <https://github.com/Kozea/WeasyPrint/issues/661>_: Make blocks withoverflow: auto grow to include floating children

Bug fixes:

* #945 <https://github.com/Kozea/WeasyPrint/issues/945>_: Don't break pages between a list item and its marker *#727 <https://github.com/Kozea/WeasyPrint/issues/727>_: Avoid tables lost between pages *#831 <https://github.com/Kozea/WeasyPrint/issues/831>_: Ignore auto margins on flex containers *#923 <https://github.com/Kozea/WeasyPrint/issues/923>_: Fix a couple of crashes when splitting a line twice *#896 <https://github.com/Kozea/WeasyPrint/issues/896>_: Fix skip stack order when using a reverse flex direction

Contributors:

- Lucie Anglade - Guillaume Ayoub

Version 49 ----------

Released on 2019-09-11.

Performance:

* Speed and memory use have been largely improved.

New features:

* #700 <https://github.com/Kozea/WeasyPrint/issues/700>_: Handle::markerpseudo-selector *135dc06c <https://github.com/Kozea/WeasyPrint/commit/135dc06c>_: Handlerecto and versoparameters for page breaks *#907 <https://github.com/Kozea/WeasyPrint/pull/907>_: Provide a clean way to build layout contexts

Bug fixes:

* #937 <https://github.com/Kozea/WeasyPrint/issues/937>_: Fix rendering of tables with empty lines and rowspans *#897 <https://github.com/Kozea/WeasyPrint/issues/897>_: Don't crash when small columns are wrapped in absolute blocks *#913 <https://github.com/Kozea/WeasyPrint/issues/913>_: Fix a test about gradient colors *#924 <https://github.com/Kozea/WeasyPrint/pull/924>_: Fix title for document with attachments *#917 <https://github.com/Kozea/WeasyPrint/issues/917>_: Fix tests with Pango 1.44 *#919 <https://github.com/Kozea/WeasyPrint/issues/919>_: Fix padding and margin management for column flex boxes *#901 <https://github.com/Kozea/WeasyPrint/issues/901>_: Fix width of replaced boxes with no intrinsic width *#906 <https://github.com/Kozea/WeasyPrint/issues/906>_: Don't respect table cell width when content doesn't fit *#927 <https://github.com/Kozea/WeasyPrint/pull/927>_: Don't use deprecatedlogger.warnanymore *a8662794 <https://github.com/Kozea/WeasyPrint/commit/a8662794>_: Fix margin collapsing between caption and table wrapper *87d9e84f <https://github.com/Kozea/WeasyPrint/commit/87d9e84f>_: Avoid infinite loops when rendering columns *789b80e6 <https://github.com/Kozea/WeasyPrint/commit/789b80e6>_: Only use in flow children to set columns height *615e298a <https://github.com/Kozea/WeasyPrint/commit/615e298a>_: Don't include floating elements each time we try to render a column *48d8632e <https://github.com/Kozea/WeasyPrint/commit/48d8632e>_: Avoid not in flow children to compute column height *e7c452ce <https://github.com/Kozea/WeasyPrint/commit/e7c452ce>_: Fix collapsing margins for columns *fb0887cf <https://github.com/Kozea/WeasyPrint/commit/fb0887cf>_: Fix crash when using currentColor in gradients *f66df067 <https://github.com/Kozea/WeasyPrint/commit/f66df067>_: Don't crash when using ex units in word-spacing in letter-spacing *c790ff20 <https://github.com/Kozea/WeasyPrint/commit/c790ff20>_: Don't crash when properties needing base URL use var functions *d63eac31 <https://github.com/Kozea/WeasyPrint/commit/d63eac31>_: Don't crash with object-fit: non images with no intrinsic size

Documentation:

* #900 <https://github.com/Kozea/WeasyPrint/issues/900>_: Add documentation about semantic versioning *#692 <https://github.com/Kozea/WeasyPrint/issues/692>_: Add a snippet about PDF magnification *#899 <https://github.com/Kozea/WeasyPrint/pull/899>_: Add .NET wrapper link *#893 <https://github.com/Kozea/WeasyPrint/pull/893>_: Fixed wrong nested list comprehension example *#902 <https://github.com/Kozea/WeasyPrint/pull/902>_: Addstate to the make_bookmark_treedocumentation *#921 <https://github.com/Kozea/WeasyPrint/pull/921>_: Fix typos in the documentation *#328 <https://github.com/Kozea/WeasyPrint/issues/328>_: Add CSS sample for forms

Contributors:

- Lucie Anglade - Guillaume Ayoub - Raphael Gaschignard - Stani - Szmen - Thomas Dexter - Tontyna

Version 48 ----------

Released on 2019-07-08.

Dependencies:

* CairoSVG 2.4.0+ is now needed

New features:

* #891 <https://github.com/Kozea/WeasyPrint/pull/891>_: Handletext-overflow*#878 <https://github.com/Kozea/WeasyPrint/pull/878>_: Handlecolumn-span*#855 <https://github.com/Kozea/WeasyPrint/pull/855>_: Handle all thetext-decorationfeatures *#238 <https://github.com/Kozea/WeasyPrint/issues/238>_: Don't repeat background images when it's not needed *#875 <https://github.com/Kozea/WeasyPrint/issues/875>_: Handleobject-fit and object-position*#870 <https://github.com/Kozea/WeasyPrint/issues/870>_: Handlebookmark-state

Bug fixes:

* #686 <https://github.com/Kozea/WeasyPrint/issues/686>_: Fix column balance when children are not inline *#885 <https://github.com/Kozea/WeasyPrint/issues/885>_: Actually use the content box to resolve flex items percentages *#867 <https://github.com/Kozea/WeasyPrint/issues/867>_: Fix rendering of KaTeX output, including (1) set row baseline of tables when no cells are baseline-aligned, (2) set baseline for inline tables, (3) don't align lines larger than their parents, (4) force CairoSVG to respect image size defined by CSS. *#873 <https://github.com/Kozea/WeasyPrint/issues/873>_: Set a minimum height for empty list elements with outside marker *#811 <https://github.com/Kozea/WeasyPrint/issues/811>_: Don't use translations to align flex items *#851 <https://github.com/Kozea/WeasyPrint/issues/851>_,#860 <https://github.com/Kozea/WeasyPrint/issues/860>_: Don't cut pages when content overflows a very little bit *#862 <https://github.com/Kozea/WeasyPrint/issues/862>_: Don't crash when using UTC dates in metadata

Documentation:

* #854 <https://github.com/Kozea/WeasyPrint/issues/854>_: Add a "Tips & Tricks" section

Contributors:

- Gabriel Corona - Guillaume Ayoub - Manuel Barkhau - Nathan de Maestri - Lucie Anglade - theopeek

Version 47 ----------

Released on 2019-04-12.

New features:

* #843 <https://github.com/Kozea/WeasyPrint/pull/843>_: Handle CSS variables *#846 <https://github.com/Kozea/WeasyPrint/pull/846>_: Handle:nth()page selector *#847 <https://github.com/Kozea/WeasyPrint/pull/847>_: Allow users to use a custom SSL context for HTTP requests

Bug fixes:

* #797 <https://github.com/Kozea/WeasyPrint/issues/797>_: Fix underlined justified text *#836 <https://github.com/Kozea/WeasyPrint/issues/836>_: Fix crash when flex items are replaced boxes *#835 <https://github.com/Kozea/WeasyPrint/issues/835>_: Fixmargin-break: auto

Version 46 ----------

Released on 2019-03-20.

New features:

* #771 <https://github.com/Kozea/WeasyPrint/issues/771>_: Handlebox-decoration-break*#115 <https://github.com/Kozea/WeasyPrint/issues/115>_: Handlemargin-break*#821 <https://github.com/Kozea/WeasyPrint/issues/821>_: Continuous integration includes tests on Windows

Bug fixes:

* #765 <https://github.com/Kozea/WeasyPrint/issues/765>_,#754 <https://github.com/Kozea/WeasyPrint/issues/754>_,#800 <https://github.com/Kozea/WeasyPrint/issues/800>_: Fix many crashes related to the flex layout *#783 <https://github.com/Kozea/WeasyPrint/issues/783>_: Fix a couple of crashes with strange texts *#827 <https://github.com/Kozea/WeasyPrint/pull/827>_: Named strings and counters are case-sensitive *#823 <https://github.com/Kozea/WeasyPrint/pull/823>_: Shrink min/max-height/width according to box-sizing *#728 <https://github.com/Kozea/WeasyPrint/issues/728>_,#171 <https://github.com/Kozea/WeasyPrint/issues/171>_: Don't crash when fixed boxes are nested *#610 <https://github.com/Kozea/WeasyPrint/issues/610>_,#828 <https://github.com/Kozea/WeasyPrint/issues/828>_: Don't crash when preformatted text lines end with a space *#808 <https://github.com/Kozea/WeasyPrint/issues/808>_,#387 <https://github.com/Kozea/WeasyPrint/issues/387>_: Fix position of some images *#813 <https://github.com/Kozea/WeasyPrint/issues/813>_: Don't crash when long preformatted text lines end with\n

Documentation:

* #815 <https://github.com/Kozea/WeasyPrint/pull/815>_: Add documentation about customurl_fetcher

Version 45 ----------

Released on 2019-02-20.

WeasyPrint now has a code of conduct
<https://github.com/Kozea/WeasyPrint/blob/master/CODE_OF_CONDUCT.rst>_.

A new website has been launched, with beautiful and useful graphs about speed and memory use across versions: checkWeasyPerf
<https://kozea.github.io/WeasyPerf/index.html>_.

Dependencies:

* Python 3.5+ is now needed, Python 3.4 is not supported anymore

Bug fixes:

* #798 <https://github.com/Kozea/WeasyPrint/pull/798>_: Prevent endless loop and index out of range in pagination *#767 <https://github.com/Kozea/WeasyPrint/issues/767>_: Add a--quietCLI parameter *#784 <https://github.com/Kozea/WeasyPrint/pull/784>_: Fix library loading on Alpine *#791 <https://github.com/Kozea/WeasyPrint/pull/791>_: Use path2url in tests for Windows *#789 <https://github.com/Kozea/WeasyPrint/pull/789>_: Add LICENSE file to distributed sources *#788 <https://github.com/Kozea/WeasyPrint/pull/788>_: Fix pending references *#780 <https://github.com/Kozea/WeasyPrint/issues/780>_: Don't draw patterns for empty page backgrounds *#774 <https://github.com/Kozea/WeasyPrint/issues/774>_: Don't crash when links include quotes *#637 <https://github.com/Kozea/WeasyPrint/issues/637>_: Fix a problem with justified text *#763 <https://github.com/Kozea/WeasyPrint/pull/763>_: Launch tests with Python 3.7 *#704 <https://github.com/Kozea/WeasyPrint/issues/704>_: Fix a corner case with tables *#804 <https://github.com/Kozea/WeasyPrint/pull/804>_: Don't logger handlers defined before importing WeasyPrint *#109 <https://github.com/Kozea/WeasyPrint/issues/109>_,#748 <https://github.com/Kozea/WeasyPrint/issues/748>_: Don't include punctuation for hyphenation *#770 <https://github.com/Kozea/WeasyPrint/issues/770>_: Don't crash when people use uppercase words from old-fashioned Microsoft fonts in tables, especially when there's an 5th column * Use aseparate logger
<https://weasyprint.readthedocs.io/en/latest/tutorial.html#logging>_ to report the rendering process * Add a--debugCLI parameter and set debug level for unknown prefixed CSS properties * Define minimal versions of Python and setuptools in setup.cfg

Documentation:

* #796 <https://github.com/Kozea/WeasyPrint/pull/796>_: Fix a small typo in the tutorial *#792 <https://github.com/Kozea/WeasyPrint/pull/792>_: Document no alignment character support *#773 <https://github.com/Kozea/WeasyPrint/pull/773>_: Fix phrasing in Hacking section *#402 <https://github.com/Kozea/WeasyPrint/issues/402>_: Add a paragraph about fontconfig error *#764 <https://github.com/Kozea/WeasyPrint/pull/764>_: Fix list of dependencies for Alpine * Fix API documentation of HTML and CSS classes

Version 44 ----------

Released on 2018-12-29.

Bug fixes:

* #742 <https://github.com/Kozea/WeasyPrint/issues/742>_: Don't crash during PDF generation when locale uses commas as decimal separator *#746 <https://github.com/Kozea/WeasyPrint/issues/746>_: Close file when reading VERSION * Improve speed and memory usage for long texts.

Documentation:

* #733 <https://github.com/Kozea/WeasyPrint/pull/733>_: Small documentation fixes *#735 <https://github.com/Kozea/WeasyPrint/pull/735>_: Fix broken links in NEWS.rst

Version 43 ----------

Released on 2018-11-09.

Bug fixes:

* #726 <https://github.com/Kozea/WeasyPrint/issues/726>_: Make empty strings clear previous values of named strings *#729 <https://github.com/Kozea/WeasyPrint/issues/729>_: Include tools in packaging

This version also includes the changes from unstable rc1 and rc2 versions listed below.

Version 43rc2 -------------

Released on 2018-11-02.

This version is experimental, don't use it in production. If you find bugs, please report them!

Bug fixes:

* #706 <https://github.com/Kozea/WeasyPrint/issues/706>_: Fix text-indent at the beginning of a page *#687 <https://github.com/Kozea/WeasyPrint/issues/687>_: Allow query strings in file:// URIs *#720 <https://github.com/Kozea/WeasyPrint/issues/720>_: Optimize minimum size calculation of long inline elements *#717 <https://github.com/Kozea/WeasyPrint/issues/717>_: Display <details> tags as blocks *#691 <https://github.com/Kozea/WeasyPrint/issues/691>_: Don't recalculate max content widths when distributing extra space for tables *#722 <https://github.com/Kozea/WeasyPrint/issues/722>_: Fix bookmarks and strings set on images *#723 <https://github.com/Kozea/WeasyPrint/issues/723>_: Warn users when string() is not used in page margin

Version 43rc1 -------------

Released on 2018-10-15.

This version is experimental, don't use it in production. If you find bugs, please report them!

Dependencies:

* Python 3.4+ is now needed, Python 2.x is not supported anymore * Cairo 1.15.4+ is now needed, but 1.10+ should work with missing features (such as links, outlines and metadata) * Pdfrw is not needed anymore

New features:

* Beautiful website <https://weasyprint.org>_ *#579 <https://github.com/Kozea/WeasyPrint/issues/579>_: Initial support of flexbox *#592 <https://github.com/Kozea/WeasyPrint/pull/592>_: Support @font-face on Windows *#306 <https://github.com/Kozea/WeasyPrint/issues/306>_: Add a timeout parameter to the URL fetcher functions *#594 <https://github.com/Kozea/WeasyPrint/pull/594>_: Split tests using modern pytest features *#599 <https://github.com/Kozea/WeasyPrint/pull/599>_: Make tests pass on Windows *#604 <https://github.com/Kozea/WeasyPrint/pull/604>_: Handle target counters and target texts *#631 <https://github.com/Kozea/WeasyPrint/pull/631>_: Enable counter-increment and counter-reset in page context *#622 <https://github.com/Kozea/WeasyPrint/issues/622>_: Allow pathlib.Path objects for HTML, CSS and Attachment classes *#674 <https://github.com/Kozea/WeasyPrint/issues/674>_: Add extensive installation instructions for Windows

Bug fixes:

* #558 <https://github.com/Kozea/WeasyPrint/issues/558>_: Fix attachments *#565 <https://github.com/Kozea/WeasyPrint/issues/565>_,#596 <https://github.com/Kozea/WeasyPrint/issues/596>_,#539 <https://github.com/Kozea/WeasyPrint/issues/539>_: Fix many PDF rendering, printing and compatibility problems *#614 <https://github.com/Kozea/WeasyPrint/issues/614>_: Avoid crashes and endless loops caused by a Pango bug *#662 <https://github.com/Kozea/WeasyPrint/pull/662>_: Fix warnings and errors when generating documentation *#666 <https://github.com/Kozea/WeasyPrint/issues/666>_,#685 <https://github.com/Kozea/WeasyPrint/issues/685>_: Fix many table layout rendering problems *#680 <https://github.com/Kozea/WeasyPrint/pull/680>_: Don't crash when there's no font available *#662 <https://github.com/Kozea/WeasyPrint/pull/662>_: Fix support of some align values in tables

Version 0.42.3 --------------

Released on 2018-03-27.

Bug fixes:

* #583 <https://github.com/Kozea/WeasyPrint/issues/583>_: Fix floating-point number error to fix floating box layout *#586 <https://github.com/Kozea/WeasyPrint/issues/586>_: Don't optimize resume_at when splitting lines with trailing spaces *#582 <https://github.com/Kozea/WeasyPrint/issues/582>_: Fix table layout with no overflow *#580 <https://github.com/Kozea/WeasyPrint/issues/580>_: Fix inline box breaking function *#576 <https://github.com/Kozea/WeasyPrint/issues/576>_: Split replaced_min_content_width and replaced_max_content_width *#574 <https://github.com/Kozea/WeasyPrint/issues/574>_: Respect text direction and don't translate rtl columns twice *#569 <https://github.com/Kozea/WeasyPrint/issues/569>_: Get only first line's width of inline children to get linebox width

Version 0.42.2 --------------

Released on 2018-02-04.

Bug fixes:

* #560 <https://github.com/Kozea/WeasyPrint/issues/560>_: Fix a couple of crashes and endless loops when breaking lines.

Version 0.42.1 --------------

Released on 2018-02-01.

Bug fixes:

* #566 <https://github.com/Kozea/WeasyPrint/issues/566>_: Don't crash when using @font-config. *#567 <https://github.com/Kozea/WeasyPrint/issues/567>_: Fix text-indent with text-align: justify. *#465 <https://github.com/Kozea/WeasyPrint/issues/465>_: Fix string(\*, start). *#562 <https://github.com/Kozea/WeasyPrint/issues/562>_: Handle named pages with pseudo-class. *#507 <https://github.com/Kozea/WeasyPrint/issues/507>_: Fix running headers. *#557 <https://github.com/Kozea/WeasyPrint/issues/557>_: Avoid infinite loops in inline_line_width. *#555 <https://github.com/Kozea/WeasyPrint/issues/555>_: Fix margins, borders and padding in column layouts.

Version 0.42 ------------

Released on 2017-12-26.

WeasyPrint is not tested with (end-of-life) Python 3.3 anymore.

This release is probably the last version of the 0.x series.

Next version may include big changes:

- end of Python 2.7 support, - initial support of bidirectional text, - initial support of flexbox, - improvements for speed and memory usage.

New features:

* #532 <https://github.com/Kozea/WeasyPrint/issues/532>_: Support relative file URIs when using CLI.

Bug fixes:

* #553 <https://github.com/Kozea/WeasyPrint/issues/553>_: Fix slow performance for pre-formatted boxes with a lot of children. *#409 <https://github.com/Kozea/WeasyPrint/issues/409>_: Don't crash when rendering some tables. *#39 <https://github.com/Kozea/WeasyPrint/issues/39>_: Fix rendering of floats in inlines. *#301 <https://github.com/Kozea/WeasyPrint/issues/301>_: Split lines carefully. *#530 <https://github.com/Kozea/WeasyPrint/issues/530>_: Fix root when frozen with Pyinstaller. *#534 <https://github.com/Kozea/WeasyPrint/issues/534>_: Handle SVGs containing images embedded as data URIs. *#360 <https://github.com/Kozea/WeasyPrint/issues/360>_: Fix border-radius rendering problem with some PDF readers. *#525 <https://github.com/Kozea/WeasyPrint/issues/525>_: Fix pipenv support. *#227 <https://github.com/Kozea/WeasyPrint/issues/227>_: Smartly handle replaced boxes with percentage width in auto-width parents. *#520 <https://github.com/Kozea/WeasyPrint/issues/520>_: Don't ignore CSS @page rules that are imported by an @import rule.

Version 0.41 ------------

Released on 2017-10-05.

WeasyPrint now depends on pdfrw >= 0.4.

New features:

* #471 <https://github.com/Kozea/WeasyPrint/issues/471>_: Support page marks and bleed.

Bug fixes:

* #513 <https://github.com/Kozea/WeasyPrint/issues/513>_: Don't crash on unsupported image-resolution values. *#506 <https://github.com/Kozea/WeasyPrint/issues/506>_: Fix @font-face use with write_* methods. *#500 <https://github.com/Kozea/WeasyPrint/pull/500>_: Improve readability of _select_source function. *#498 <https://github.com/Kozea/WeasyPrint/issues/498>_: Use CSS prefixes as recommended by the CSSWG. *#441 <https://github.com/Kozea/WeasyPrint/issues/441>_: Fix rendering problems and crashes when using @font-face. *bb3a4db <https://github.com/Kozea/WeasyPrint/commit/bb3a4db>_: Try to break pages after a block before trying to break inside it. *1d1654c <https://github.com/Kozea/WeasyPrint/commit/1d1654c>_: Fix and test corner cases about named pages.

Documentation:

* #508 <https://github.com/Kozea/WeasyPrint/pull/508>_: Add missing libpangocairo dependency for Debian and Ubuntu. *a7b17fb <https://github.com/Kozea/WeasyPrint/commit/a7b17fb>_: Add documentation on logged rendering steps.

Version 0.40 ------------

Released on 2017-08-17.

WeasyPrint now depends on cssselect2 instead of cssselect and lxml.

New features:

* #57 <https://github.com/Kozea/WeasyPrint/issues/57>_: Named pages. * Unprefix properties, see#498 <https://github.com/Kozea/WeasyPrint/issues/498>_. * Add a "verbose" option logging the document generation steps.

Bug fixes:

* #483 <https://github.com/Kozea/WeasyPrint/issues/483>_: Fix slow performance with long pre-formatted texts. *#70 <https://github.com/Kozea/WeasyPrint/issues/70>_: Improve speed and memory usage for long documents. *#487 <https://github.com/Kozea/WeasyPrint/issues/487>_: Don't crash on local() fonts with a space and no quotes.

Version 0.39 ------------

Released on 2017-06-24.

Bug fixes:

* Fix the use of WeasyPrint's URL fetcher with CairoSVG.

Version 0.38 ------------

Released on 2017-06-16.

Bug fixes:

* #477 <https://github.com/Kozea/WeasyPrint/issues/477>_: Don't crash on font-face's src attributes with local functions.

Version 0.37 ------------

Released on 2017-06-15.

WeasyPrint now depends on tinycss2 instead of tinycss.

New features:

* #437 <https://github.com/Kozea/WeasyPrint/issues/437>_: Support local links in generated PDFs.

Bug fixes:

* #412 <https://github.com/Kozea/WeasyPrint/issues/412>_: Use a NullHandler log handler when WeasyPrint is used as a library. *#417 <https://github.com/Kozea/WeasyPrint/issues/417>_,#472 <https://github.com/Kozea/WeasyPrint/issues/472>_: Don't crash on some line breaks. *#327 <https://github.com/Kozea/WeasyPrint/issues/327>_: Don't crash with replaced elements with height set in percentages. *#467 <https://github.com/Kozea/WeasyPrint/issues/467>_: Remove incorrect line breaks. *#446 <https://github.com/Kozea/WeasyPrint/pull/446>_: Let the logging module do the string interpolation.

Version 0.36 ------------

Released on 2017-02-25.

New features:

* #407 <https://github.com/Kozea/WeasyPrint/pull/407>_: Handle ::first-letter. *#423 <https://github.com/Kozea/WeasyPrint/pull/423>_: Warn user about broken cairo versions.

Bug fixes:

* #411 <https://github.com/Kozea/WeasyPrint/pull/411>_: Typos fixed in command-line help.

Version 0.35 ------------

Released on 2017-02-25.

Bug fixes:

* #410 <https://github.com/Kozea/WeasyPrint/pull/410>_: Fix AssertionError in split_text_box.

Version 0.34 ------------

Released on 2016-12-21.

Bug fixes:

* #398 <https://github.com/Kozea/WeasyPrint/issues/398>_: Honor the presentational_hints option for PDFs. *#399 <https://github.com/Kozea/WeasyPrint/pull/399>_: Avoid CairoSVG-2.0.0rc* on Python 2. *#396 <https://github.com/Kozea/WeasyPrint/issues/396>_: Correctly close files open by mkstemp. *#403 <https://github.com/Kozea/WeasyPrint/issues/403>_: Cast the number of columns into int. * Fix multi-page multi-columns and add related tests.

Version 0.33 ------------

Released on 2016-11-28.

New features:

* #393 <https://github.com/Kozea/WeasyPrint/issues/393>_: Add tests on MacOS. *#370 <https://github.com/Kozea/WeasyPrint/issues/370>_: Enable @font-face on MacOS.

Bug fixes:

* #389 <https://github.com/Kozea/WeasyPrint/issues/389>_: Always update resume_at when splitting lines. *#394 <https://github.com/Kozea/WeasyPrint/issues/394>_: Don't build universal wheels. *#388 <https://github.com/Kozea/WeasyPrint/issues/388>_: Fix logic when finishing block formatting context.

Version 0.32 ------------

Released on 2016-11-17.

New features:

* #28 <https://github.com/Kozea/WeasyPrint/issues/28>_: Support @font-face on Linux. * Support CSS fonts level 3 almost entirely, including OpenType features. *#253 <https://github.com/Kozea/WeasyPrint/issues/253>_: Support presentational hints (optional). * Support break-after, break-before and break-inside for pages and columns. *#384 <https://github.com/Kozea/WeasyPrint/issues/384>_: Major performance boost.

Bux fixes:

* #368 <https://github.com/Kozea/WeasyPrint/issues/368>_: Respect white-space for shrink-to-fit. *#382 <https://github.com/Kozea/WeasyPrint/issues/382>_: Fix the preferred width for column groups. * Handle relative boxes in column-layout boxes.

Documentation:

* Add more and more documentation about Windows installation. *#355 <https://github.com/Kozea/WeasyPrint/issues/355>_: Add fonts requirements for tests.

Version 0.31 ------------

Released on 2016-08-28.

New features:

* #124 <https://github.com/Kozea/WeasyPrint/issues/124>_: Add MIME sniffing for images. *#60 <https://github.com/Kozea/WeasyPrint/issues/60>_: CSS Multi-column Layout. *#197 <https://github.com/Kozea/WeasyPrint/pull/197>_: Add hyphens at line breaks activated by a soft hyphen.

Bux fixes:

* #132 <https://github.com/Kozea/WeasyPrint/pull/132>_: Fix Python 3 compatibility on Windows.

Documentation:

* #329 <https://github.com/Kozea/WeasyPrint/issues/329>_: Add documentation about installation on Windows.

Version 0.30 ------------

Released on 2016-07-18.

WeasyPrint now depends on html5lib-0.999999999.

Bux fixes:

* Fix Acid2 *#325 <https://github.com/Kozea/WeasyPrint/issues/325>_: Cutting lines is broken in page margin boxes. *#334 <https://github.com/Kozea/WeasyPrint/issues/334>_: Newest html5lib 0.999999999 breaks rendering.

Version 0.29 ------------

Released on 2016-06-17.

Bug fixes:

* #263 <https://github.com/Kozea/WeasyPrint/pull/263>_: Don't crash with floats with percents in positions. *#323 <https://github.com/Kozea/WeasyPrint/pull/323>_: Fix CairoSVG 2.0 pre-release dependency in Python 2.x.

Version 0.28 ------------

Released on 2016-05-16.

Bug fixes:

* #189 <https://github.com/Kozea/WeasyPrint/issues/189>_:white-space: nowrapstill wraps on hyphens *#305 <https://github.com/Kozea/WeasyPrint/issues/305>_: Fix crashes on some tables * Don't crash when transform matrix isn't invertible * Don't crash when rendering ratio-only SVG images * Fix margins and borders on some tables

Version 0.27 ------------

Released on 2016-04-08.

New features:

* #295 <https://github.com/Kozea/WeasyPrint/pull/295>_: Support the 'rem' unit. *#299 <https://github.com/Kozea/WeasyPrint/pull/299>_: Enhance the support of SVG images.

Bug fixes:

* #307 <https://github.com/Kozea/WeasyPrint/issues/307>_: Fix the layout of cells larger than their tables.

Documentation:

* The website is now on GitHub Pages, the documentation is on Read the Docs. *#297 <https://github.com/Kozea/WeasyPrint/issues/297>_: Rewrite the CSS chapter of the documentation.

Version 0.26 ------------

Released on 2016-01-29.

New features:

* Support the empty-cellsattribute. * Respect table, column and cell widths.

Bug fixes:

* #172 <https://github.com/Kozea/WeasyPrint/issues/172>_: Unable to set table column width on tables td's. *#151 <https://github.com/Kozea/WeasyPrint/issues/151>_: Table background colour bleeds beyond table cell boundaries. *#260 <https://github.com/Kozea/WeasyPrint/issues/260>_: TypeError: unsupported operand type(s) for +: 'float' and 'str'. *#288 <https://github.com/Kozea/WeasyPrint/issues/288>_: Unwanted line-breaks in bold text. *#286 <https://github.com/Kozea/WeasyPrint/issues/286>_: AttributeError: 'Namespace' object has no attribute 'attachments'.

Version 0.25 ------------

Released on 2015-12-17.

New features:

* Support the 'q' unit.

Bug fixes:

* #285 <https://github.com/Kozea/WeasyPrint/issues/285>_: Fix a crash happening when splitting lines. *#284 <https://github.com/Kozea/WeasyPrint/issues/284>_: Escape parenthesis in PDF links. *#280 <https://github.com/Kozea/WeasyPrint/pull/280>_: Replace utf8 with utf-8 for gettext/django compatibility. *#269 <https://github.com/Kozea/WeasyPrint/pull/269>_: Add support for use when frozen. *#250 <https://github.com/Kozea/WeasyPrint/issues/250>_: Don't crash when attachments are not available.

Version 0.24 ------------

Released on 2015-08-04.

New features:

* #174 <https://github.com/Kozea/WeasyPrint/issues/174>_: Basic support for Named strings.

Bug fixes:

* #207 <https://github.com/Kozea/WeasyPrint/issues/207>_: Draw rounded corners on replaced boxes. *#224 <https://github.com/Kozea/WeasyPrint/pull/224>_: Rely on the font size for rounding bug workaround. *#31 <https://github.com/Kozea/WeasyPrint/issues/31>_: Honor the vertical-align property in fixed-height cells. *#202 <https://github.com/Kozea/WeasyPrint/issues/202>_: Remove unreachable area/border at bottom of page. *#225 <https://github.com/Kozea/WeasyPrint/issues/225>_: Don't allow unknown units during line-height validation. * Fix some wrong conflict resolutions for table borders with inset and outset styles.

Version 0.23 ------------

Released on 2014-09-16.

Bug fixes:

* #196 <https://github.com/Kozea/WeasyPrint/issues/196>_: Use the default image sizing algorithm for images’s preferred size. *#194 <https://github.com/Kozea/WeasyPrint/pull/194>_: Try more library aliases withdlopen(). *#201 <https://github.com/Kozea/WeasyPrint/pull/201>_: Considerpage-break-after-avoidwhen pushing floats to the next page. *#217 <https://github.com/Kozea/WeasyPrint/issues/217>_: Avoid a crash on zero-sized background images.

Release process:

* Start testing on Python 3.4 on Travis-CI.

Version 0.22 ------------

Released on 2014-05-05.

New features:

* #86 <https://github.com/Kozea/WeasyPrint/pull/86>_: Support gzip and deflate encoding in HTTP responses *#177 <https://github.com/Kozea/WeasyPrint/pull/177>_: Support for PDF attachments.

Bug fixes:

* #169 <https://github.com/Kozea/WeasyPrint/issues/169>_: Fix a crash on percentage-width columns in an auto-width table. *#168 <https://github.com/Kozea/WeasyPrint/issues/168>_: Make<fieldset>a block in the user-agent stylesheet. *#175 <https://github.com/Kozea/WeasyPrint/issues/175>_: Fix somedlopen()library loading issues on OS X. *#183 <https://github.com/Kozea/WeasyPrint/issues/183>_: Break to the next page before a float that would overflow the page. (It might still overflow if it’s bigger than the page.) *#188 <https://github.com/Kozea/WeasyPrint/issues/188>_: Require a recent enough version of Pyphen

Release process:

* Drop Python 3.1 support. * Set up Travis CI to automatically test all pushes and pull requests. * Start testing on Python 3.4 locally. (Travis does not support 3.4 yet.)

Version 0.21 ------------

Released on 2014-01-11.

New features:

* Add the overflow-wrap <https://drafts.csswg.org/css-text/#overflow-wrap>_ property, allowing line breaks inside otherwise-unbreakable words. Thanks Frédérick Deslandes! * Add theimage-resolution
<https://drafts.csswg.org/css-images-3/#the-image-resolution>_ property, allowing images to be sized proportionally to their intrinsic size at a resolution other than 96 image pixels per CSSin(ie. one image pixel per CSSpx)

Bug fixes:

* #145 <https://github.com/Kozea/WeasyPrint/issues/145>_: Fix parsing HTML from an HTTP URL on Python 3.x *#40 <https://github.com/Kozea/WeasyPrint/issues/40>_: Use more general hyphenation dictionaries for specific document languages. (E.g. usehyph_fr.dic for lang="fr_FR".) *#26 <https://github.com/Kozea/WeasyPrint/issues/26>_: Fixmin-width and max-widthon floats. *#100 <https://github.com/Kozea/WeasyPrint/issues/100>_: Fix a crash on trailing whitespace withfont-size: 0*#82 <https://github.com/Kozea/WeasyPrint/issues/82>_: Borders on tables withborder-collapse: collapsewere sometimes drawn at an incorrect position. *#30 <https://github.com/Kozea/WeasyPrint/issues/30>_: Fix positioning of images withposition: absolute. *#118 <https://github.com/Kozea/WeasyPrint/issues/118>_: Fix a crash when usingposition: absoluteinside aposition: relativeelement. * Fixvisibility: collapse to behave like visibility: hiddenon elements other than table rows and table columns. *#147 <https://github.com/Kozea/WeasyPrint/issues/147>_ and#153 <https://github.com/Kozea/WeasyPrint/issues/153>_: Fix dependencies to require lxml 3.0 or a more recent version. Thanks gizmonerd and Thomas Grainger! *#152 <https://github.com/Kozea/WeasyPrint/issues/152>_: Fix a crash on percentage-sized table cells in auto-sized tables. Thanks Johannes Duschl!

Version 0.20.2 --------------

Released on 2013-12-18.

* Fix #146 <https://github.com/Kozea/WeasyPrint/issues/146>_: don't crash when drawing really small boxes with dotted/dashed borders

Version 0.20.1 --------------

Released on 2013-12-16.

* Depend on html5lib >= 0.99 instead of 1.0b3 to fix pip 1.4 support. * Fix#74 <https://github.com/Kozea/WeasyPrint/issues/74>_: don't crash on space followed by dot at line break. * Fix#78 <https://github.com/Kozea/WeasyPrint/issues/78>_: nicer colors for border-style: ridge/groove/inset/outset.

Version 0.20 ------------

Released on 2013-12-14.

* Add support for border-radius. * Feature#77 <https://github.com/Kozea/WeasyPrint/issues/77>_: Add PDF metadata from HTML. * Feature#12 <https://github.com/Kozea/WeasyPrint/pull/12>_: Use html5lib. * Tables: handle percentages for column groups, columns and cells, and values for row height. * Bug fixes:

* Fix #84 <https://github.com/Kozea/WeasyPrint/pull/84>_: don't crash when stylesheets are not available. * Fix#101 <https://github.com/Kozea/WeasyPrint/issues/101>_: use page ids instead of page numbers in PDF bookmarks. * Uselogger.warning instead of deprecated logger.warn. * Add 'font-stretch' in the 'font' shorthand.

Version 0.19.2 --------------

Released on 2013-06-18.

Bug fix release:

* Fix #88 <https://github.com/Kozea/WeasyPrint/issues/88>_:text-decoration: overlinenot being drawn above the text * Bug fix: Actually draw multiple lines when multiple values are given totext-decoration. * Use the font metrics for text decoration positioning. * Bug fix: Don't clip the border withoverflow: hidden. * Fix#99 <https://github.com/Kozea/WeasyPrint/issues/99>_: Regression: JPEG images not loading with cairo 1.8.x.

Version 0.19.1 --------------

Released on 2013-04-30.

Bug fix release:

* Fix incorrect intrinsic width calculation leading to unnecessary line breaks in floats, tables, etc. * Tweak border painting to look better * Fix unnecessary page break before big tables. * Fix table row overflowing at the bottom of the page when there are margins above the table. * Fixposition: fixedto actually repeat on every page. * Fix#76 <https://github.com/Kozea/WeasyPrint/issues/76>_: repeat<thead> and <tfoot>elements on every page, even with table border collapsing.

Version 0.19 ------------

Released on 2013-04-18.

* Add support for linear-gradient() and radial-gradientin background images. * Add support for theex and chlength units. (1ex is based on the font instead of being always 0.5emas before.) * Add experimental support for Level 4 hyphenation properties. * Drop support for CFFI < 0.6 and cairocffi < 0.4. * Many bug fixes, including:

* Fix #54 <https://github.com/Kozea/WeasyPrint/issues/54>_: min/max-width/height on block-level images. * Fix#71 <https://github.com/Kozea/WeasyPrint/issues/71>_: Crash when parsing nested functional notation.

Version 0.18 ------------

Released on 2013-03-30.

* Add support for Level 3 backgrounds, including multiple background layers per element/box. * Forward-compatibility with (future releases of) cairocffi 0.4+ and CFFI 0.6+. * Bug fixes:

* Avoid some unnecessary line breaks for elements sized based on their content (aka. “shrink-to-fit”) such as floats and page headers. * Allow page breaks between empty blocks. * Fix#66 <https://github.com/Kozea/WeasyPrint/issues/66>_: Resolve images’ auto width from non-auto height and intrinsic ratio. * Fix#21 <https://github.com/Kozea/WeasyPrint/issues/21>_: Thedata:URL scheme is case-insensitive. * Fix#53 <https://github.com/Kozea/WeasyPrint/issues/53>_: Crash when backtracking forbreak-before/after: avoid.

Version 0.17.1 --------------

Released on 2013-03-18.

Bug fixes:

* Fix #41 <https://github.com/Kozea/WeasyPrint/issues/41>_: GObject initialization when GDK-PixBuf is not installed. * Fix#42 <https://github.com/Kozea/WeasyPrint/issues/42>_: absolute URLs without a base URL (ie. document parsed from a string.) * Fix some whitespace collapsing bugs. * Fix absolutely-positioned elements inside inline elements. * Fix URL escaping of image references from CSS. * Fix#49 <https://github.com/Kozea/WeasyPrint/issues/49>_: Division by 0 on dashed or dotted border smaller than one dot/dash. * Fix#44 <https://github.com/Kozea/WeasyPrint/issues/44>_: bad interaction ofpage-break-before/after: avoid and floats.

Version 0.17 ------------

Released on 2013-02-27.

* Added text hyphenation_ with the -weasy-hyphensproperty. * When a document includes JPEG images, embed them as JPEG in the PDF output. This often results in smaller PDF file size compared to the default deflate compression. * Switched to using CFFI instead of PyGTK or PyGObject-introspection. * Layout bug fixes:

- Correctly trim whitespace at the end of lines. - Fix some cases with floats within inline content.

.. _text hyphenation: https://weasyprint.readthedocs.io/en/latest/features.html#css-text-module-level-3-4

Version 0.16 ------------

Released on 2012-12-13.

* Add the zoom parameter to HTML.write_pdfandDocument.write_pdf() <weasyprint.document.Document.write_pdf>* Fix compatibility with old (and buggy) pycairo versions. WeasyPrint is now tested on 1.8.8 in addition to the latest. * Fix layout bugs related to line trailing spaces.

Version 0.15 ------------

Released on 2012-10-09.

* Add a low-level API that enables painting pages individually on any cairo surface. * Backward-incompatible change: remove theHTML.get_png_pagesmethod. The new low-level API covers this functionality and more. * Add support for thefont-stretchproperty. * Add support for@page:blankto select blank pages. * New Sphinx-based and improved docs * Bug fixes:

- Importing Pango in some PyGTK installations. - Layout of inline-blocks withvertical-align: top or bottom. - Do not repeat a block’s margin-top or padding-top after a page break. - Performance problem with large tables split across many pages. - Anchors and hyperlinks areas now follow CSS transforms. Since PDF links have to be axis-aligned rectangles, the bounding box is used. This may be larger than expected with rotations that are not a multiple of 90 degrees.

Version 0.14 ------------

Released on 2012-08-03.

* Add a public API to choose media type used for @media. (It still defaults toprint). Thanks Chung Lu! * Add--base-url and --resolutionto the command-line API, making it as complete as the Python one. * Add support for the<base href="...">element in HTML. * Add support for CSS outlines * Switch to gdk-pixbuf instead of Pystacia for loading raster images. * Bug fixes:

- Handling of filenames and URLs on Windows - Unicode filenames with older version of py2cairo -base_urlnow behaves as expected when set to a directory name. - Make some tests more robust

Version 0.13 ------------

Released on 2012-07-23.

* Add support for PyGTK, as an alternative to PyGObject + introspection. This should make WeasyPrint easier to run on platforms that not not have packages for PyGObject 3.x yet. * Bug fix: crash in PDF outlines for some malformed HTML documents

Version 0.12 ------------

Released on 2012-07-19.

* Add support for collapsed borders on tables. This is currently incompatible with repeating header and footer row groups on each page: headers and footers are treated as normal row groups on table withborder-collapse: collapse. * Addurl_fetcherto the public API. This enables users to hook into WeasyPrint for fetching linked stylesheets or images, eg. to generate them on the fly without going through the network. This enables the creation ofFlask-WeasyPrint
<https://packages.python.org/Flask-WeasyPrint/>_.

Version 0.11 ------------

Released on 2012-07-04.

* Add support for floats and clear. Together with various bug fixes, this enables WeasyPrint to pass the Acid2 test! Acid2 is now part of our automated test suite. * Add support for the width, min-width, max-width, height, min-height and max-height properties in @page. The size property is now the size of the page’s containing block. * Switch the Variable Dimension rules tothe new proposal
<https://github.com/SimonSapin/css/blob/master/margin-boxes-variable-dimension>_. The previous implementation was broken in many cases. * Theimage-rendering, transform, transform-origin and sizeproperties are now unprefixed. The prefixed form (eg. -weasy-size) is ignored but gives a specific warning.

Version 0.10 ------------

Released on 2012-06-25.

* Add get_png_pages()to the public API. It returns each page as a separate PNG image. * Add aresolutionparameter for PNG. Add WeasyPrint Navigator*, a web application that shows WeasyPrint’s output with clickable links. Yes, that’s a browser in your browser. Start it withpython -m weasyprint.navigator* Add support forvertical-align: top and vertical-align: bottom* Add support forpage-break-before: avoid and page-break-after: avoid* Bug fixes

Version 0.9 -----------

Released on 2012-06-04.

* Relative, absolute and fixed positioning * Proper painting order (z-index) * In PDF: support for internal and external hyperlinks as well as bookmarks. * Added thetree parameter to the HTMLclass: accepts a parsed lxml object. * Bug fixes, including many crashes.

Bookmarks can be controlled by the -weasy-bookmark-leveland-weasy-bookmark-label properties, as described in CSS Generated Content
for Paged Media Module <https://drafts.csswg.org/css-gcpm-3/#bookmarks>_.

The default UA stylesheet sets a matching bookmark level on all <h1>to<h6> elements.

Version 0.8 -----------

Released on 2012-05-07.

* Switch from cssutils to tinycss_ as the CSS parser. * Switch to the new cssselect_, almost all level 3 selectors are supported now. * Support for inline blocks and inline tables * Automatic table layout (column widths) * Support for themin-width, max-width, min-heightandmax-heightproperties, except on table-related and page-related boxes. * Speed improvements on big stylesheets / small documents thanks to tinycss. * Many bug fixes

.. _tinycss: https://packages.python.org/tinycss/ .. _cssselect: https://packages.python.org/cssselect/

Version 0.7.1 -------------

Released on 2012-03-21.

Change the license from AGPL to BSD.

Version 0.7 -----------

Released on 2012-03-21.

* Support page breaks between table rows * Support for theorphans and widowsproperties. * Support forpage-break-inside: avoid* Bug fixes

Only avoiding page breaks before/after an element is still missing.

Version 0.6.1 -------------

Released on 2012-03-01.

Fix a packaging bug. (Remove use_2to3 in setup.py. We use the same codebase for Python 2 and 3.)

Version 0.6 -----------

Released on 2012-02-29.

Backward incompatible*: completely change the Python API. See the documentation: https://weasyprint.readthedocs.io/en/latest/tutorial.html#as-a-python-library Backward incompatible*: Proper margin collapsing. This changes how blocks are rendered: adjoining margins "collapse" (their maximum is used) instead of accumulating. * Support images inembed or objectelements. * Switch to pystacia instead of PIL for raster images * Add compatibility with CPython 2.6 and 3.2. (Previously only 2.7 was supported) * Many bug fixes

Version 0.5 -----------

Released on 2012-02-08.

* Support for the overflow and clipproperties. * Support for theopacityproperty from CSS3 Colors. * Support for CSS 2D Transforms. These are prefixed, so you need to use-weasy-transform and -weasy-transform-origin.

Version 0.4 -----------

Released on 2012-02-07.

* Support text-align: justify, word-spacing and letter-spacing. * Partial support for CSS3 Paged Media: page size and margin boxes with page-based counters. * All CSS 2.1 border styles * Fix SVG images with non-pixel units. Requires CairoSVG 0.3 * Support forpage-break-before and page-break-after, except for the valueavoid. * Support for thebackground-clip, background-originandbackground-sizefrom CSS3 (but still with a single background per element) * Support for theimage-renderingfrom SVG. This one is prefixed, use-weasy-image-rendering. It only has an effect on PNG output.

Version 0.3.1 -------------

Released on 2011-12-14.

Compatibility with CairoSVG 0.1.2

Version 0.3 -----------

Released on 2011-12-13.

* Backward-incompatible change: the 'size' property is now prefixed (since it is in an experimental specification). Use '-weasy-size' instead. * cssutils 0.9.8 or higher is now required. * Support SVG images with CairoSVG * Support generated content: the:before and :afterpseudo-elements, thecontent, quotes and counter-*properties. * Support ordered lists: all CSS 2.1 values of thelist-style-typeproperty. * New user-agent stylesheet with HTML 5 elements and automatic quotes for many languages. Thanks Peter Moulder! * Disable cssutils validation warnings, they are redundant with WeasyPrint’s. * Add--versionto the command-line script. * Various bug fixes

Version 0.2 -----------

Released on 2011-11-25.

* Support for tables. * Support thebox-sizingproperty from CSS 3 Basic User Interface * Support all values of vertical-align except top and bottom. They are interpreted as text-top and text-bottom. * Minor bug fixes

Tables have some limitations: Only the fixed layout and separate border model are supported. There are also no page break inside tables so a table higher than a page will overflow.

Version 0.1 -----------

Released on 2011-10-28.

First packaged release. Supports "simple" CSS 2.1 pages: there is no support for floats, tables, or absolute positioning. Other than that most of CSS 2.1 is supported, as well as CSS 3 Colors and Selectors.

---

`Common Use Cases`

Common Use Cases ================

Regenerate PDFs Automatically -----------------------------

During development, you can automatically regenerate a PDF whenever an HTML or CSS file changes. On Linux, macOS and Windows, install watchexec_.

To watch specific files, run:

.. code-block:: sh

watchexec --watch document.html --watch style.css -- python -m weasyprint document.html document.pdf

To watch all HTML and CSS files in the current directory and its subdirectories, use an extension filter:

.. code-block:: sh

watchexec -e html,css -- python -m weasyprint document.html document.pdf

Replace the filenames in these examples with your own HTML, CSS and PDF paths.

.. _watchexec: https://watchexec.github.io/

Include in Web Applications ---------------------------

Using WeasyPrint in web applications sometimes requires attention on some details.

Security Problems .................

First of all, rendering untrusted HTML and CSS files can lead to :ref:security
problems <Security>. Please be sure to carefully follow the different proposed solutions if you allow your users to modify the source of the rendered documents in any way.

Rights Management .................

Another problem is rights management: you often need to render templates that can only be accessed by authenticated users, and WeasyPrint installed on the server doesn’t send the same cookies as the ones sent by the users. Extensions such as Flask-WeasyPrint_ (for Flask_) or Django-WeasyPrint_ (for Django_) solve this issue with a small amount of code. If you use another framework, you can read these extensions and probably find an equivalent workaround.

.. _Flask-Weasyprint: https://github.com/Kozea/Flask-WeasyPrint .. _Flask: https://flask.palletsprojects.com/ .. _Django-WeasyPrint: https://github.com/fdemmer/django-weasyprint .. _Django: https://www.djangoproject.com/

Server Side Requests & Self-Signed SSL Certificates ...................................................

If your server is requesting data from itself, you may encounter a self-signed certificate error, even if you have a valid certificate.

You need to add yourself as a Certificate Authority, so that your self-signed SSL certificates can be requested.

.. code-block:: bash

# If you have not yet created a certificate. sudo openssl req -x509 \ -sha256 \ -nodes \ -newkey rsa:4096 \ -days 365 \ -keyout localhost.key \ -out localhost.crt

# Follow the prompts about your certificate and the domain name. openssl x509 -text -noout -in localhost.crt

Add your new self-signed SSL certificate to your nginx.conf, below the lineserver_name 123.123.123.123;:

.. code-block:: bash

ssl_certificate /etc/ssl/certs/localhost.crt; ssl_certificate_key /etc/ssl/private/localhost.key;

The SSL certificate will be valid when accessing your website from the internet. However, images will not render when requesting files from the same server.

You will need to add your new self-signed certificates as trusted:

.. code-block:: bash

sudo cp /etc/ssl/certs/localhost.crt /usr/local/share/ca-certificates/localhost.crt sudo cp /etc/ssl/private/localhost.key /usr/local/share/ca-certificates/localhost.key

# Update the certificate authority trusted certificates. sudo update-ca-certificates

# Export your newly updated Certificate Authority Bundle file. # If using Django, it will use the newly signed certificate authority as # valid and images will load properly. sudo tee -a /etc/environment <<< 'export REQUESTS_CA_BUNDLE=/etc/ssl/certs/ca-certificates.crt'

Adjust Document Dimensions --------------------------

WeasyPrint does not provide support for adjusting page size or document margins via command-line flags. This is best accomplished with the CSS@pageat-rule, which can be added to the document or provided in a stylesheet. Consider the following example:

.. code-block:: css

@page { size: A3 landscape; / Change from the default size and orientation of A4 portrait / margin: 3cm; / Set margin on each page / }

To apply these rules from the command line without creating a separate CSS file, use the-s option with shell process substitution:

.. code-block:: sh

$ weasyprint input.html output.pdf -s <(echo "@page { size: A3 landscape; margin: 3cm }")

There is much more which can be achieved with the @pageat-rule, such as page numbers, headers, etc. Read more about the page_ at-rule.

.. _page: https://developer.mozilla.org/en-US/docs/Web/CSS/@page

Generate Specialized PDFs -------------------------

WeasyPrint can generate different PDF variants, including PDF/UA and PDF/A. The feature is available by using the--pdf-variantCLI option, or thepdf_variant Python parameter of :func:HTML.write_pdf
<weasyprint.HTML.write_pdf>.

.. code-block:: python

from weasyprint import HTML HTML(string="<p>document</p>").write_pdf("document.pdf", pdf_variant="pdf/a-3u")

.. code-block:: sh

$ weasyprint document.html --pdf-variant="pdf/ua-1" document.pdf

The different supported variants can be listed using weasyprint --help.

Even if WeasyPrint tries to generate valid documents, the result is not guaranteed: the HTML, CSS and PDF features chosen by the user must follow the limitations defined by the different specifications.

PDF/A (Archiving) .................

PDF/A documents are specialized for archiving purposes. They are a simple subset of PDF, with a lot of limitations: no audio, video or JavaScript, defined color spaces, embedded fonts, etc.

If possible, PDF/A-3u should be preferred: it allows transparency layers that are forbidden in A-1, and arbitrary formats for attached files that are forbidden in A-2. The "u" part of the variant indicates that the PDF text is available as Unicode.

PDF/A documents include a PDF identifier, that is mainly useful to indicate that a PDF is a new version of another PDF. By default, WeasyPrint generates a valid PDF identifier, but you can provide your own with the--pdf-identifier CLI option or pdf_identifier Python parameter.

If your document includes images, you must set the image-rendering: crisp-edges property to avoid anti-aliasing, that is forbidden by PDF/A.

PDF/UA (Universal Accessibility) ................................

PDF/UA documents are specialized for accessibility purposes. They include extra metadata that define document information and content structure.

The main constraint to get valid PDF/UA documents is to use a correct HTML structure, to avoid inconsistencies in the PDF structure. The HTML order is also used to define the order of the PDF content.

Some information is required in your HTML file, including a <title>tag, and alang attribute set on the <html> tag.

PDF/X (Graphics Exchange) .........................

PDF/X documents facilitate graphics exchange and adds printing-related requirements such as color profiles.

The easiest way to fulfill these requirements is to use device-dependent CMYK colors and images everywhere in your document. For colors, you can use thedevice-cmyk()function:

.. code-block:: css

body { color: device-cmyk(0% 10% 0% 80%) }

You also have to define the output profile color to use.

.. code-block:: css

@color-profile device-cmyk { components: cyan, magenta, yellow, black; src: url(path/to/cmyk-profile.icc); }

If possible, PDF/X-4 should be preferred: it allows transparency layers that are forbidden by previous variants.

Factur-X / ZUGFeRD (Electronic Invoices) ........................................

Factur-X / ZUGFeRD is a Franco-German standard for hybrid e-invoice, the first implementation of the European Semantic Standard EN 16931. It enables users to include normalized metadata in PDF invoices, such as companies information or invoice amounts, so that compatible software can automatically read this information. This standard is based on PDF/A-3b.

WeasyPrint can generate Factur-X / ZUGFeRD documents. Invoice metadata must be generated by the user and included in the PDF document when rendered. Two different metadata files are required:

- the first one is RDF metadata, containing document metadata and PDF/A extension information; - the second one is Factur-X / ZUGFeRD metadata, containing invoice amounts, plus seller and buyer information.

Here is an example of Factur-X document generation.

rdf.xml:

.. code-block:: xml

<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns:fx="urn:factur-x:pdfa:CrossIndustryDocument:invoice:1p0#" xmlns:pdfaExtension="http://www.aiim.org/pdfa/ns/extension/" xmlns:pdfaSchema="http://www.aiim.org/pdfa/ns/schema#" xmlns:pdfaProperty="http://www.aiim.org/pdfa/ns/property#"> <rdf:Description rdf:about=""> <fx:ConformanceLevel>MINIMUM</fx:ConformanceLevel> <fx:DocumentFileName>factur-x.xml</fx:DocumentFileName> <fx:DocumentType>INVOICE</fx:DocumentType> <fx:Version>1.0</fx:Version> </rdf:Description> <rdf:Description rdf:about=""> <pdfaExtension:schemas> <rdf:Bag> <rdf:li rdf:parseType="Resource"> <pdfaSchema:schema>Factur-X PDFA Extension Schema</pdfaSchema:schema> <pdfaSchema:namespaceURI>urn:factur-x:pdfa:CrossIndustryDocument:invoice:1p0#</pdfaSchema:namespaceURI> <pdfaSchema:prefix>fx</pdfaSchema:prefix> <pdfaSchema:property> <rdf:Seq> <rdf:li rdf:parseType="Resource"> <pdfaProperty:name>DocumentFileName</pdfaProperty:name> <pdfaProperty:valueType>Text</pdfaProperty:valueType> <pdfaProperty:category>external</pdfaProperty:category> <pdfaProperty:description>name of the embedded XML invoice file</pdfaProperty:description> </rdf:li> <rdf:li rdf:parseType="Resource"> <pdfaProperty:name>DocumentType</pdfaProperty:name> <pdfaProperty:valueType>Text</pdfaProperty:valueType> <pdfaProperty:category>external</pdfaProperty:category> <pdfaProperty:description>INVOICE</pdfaProperty:description> </rdf:li> <rdf:li rdf:parseType="Resource"> <pdfaProperty:name>Version</pdfaProperty:name> <pdfaProperty:valueType>Text</pdfaProperty:valueType> <pdfaProperty:category>external</pdfaProperty:category> <pdfaProperty:description>The actual version of the Factur-X XML schema</pdfaProperty:description> </rdf:li> <rdf:li rdf:parseType="Resource"> <pdfaProperty:name>ConformanceLevel</pdfaProperty:name> <pdfaProperty:valueType>Text</pdfaProperty:valueType> <pdfaProperty:category>external</pdfaProperty:category> <pdfaProperty:description>The conformance level of the embedded Factur-X data</pdfaProperty:description> </rdf:li> </rdf:Seq> </pdfaSchema:property> </rdf:li> </rdf:Bag> </pdfaExtension:schemas> </rdf:Description> </rdf:RDF>

factur-x.xml:

.. code-block:: xml

<rsm:CrossIndustryInvoice xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:qdt="urn:un:unece:uncefact:data:standard:QualifiedDataType:100" xmlns:udt="urn:un:unece:uncefact:data:standard:UnqualifiedDataType:100" xmlns:rsm="urn:un:unece:uncefact:data:standard:CrossIndustryInvoice:100" xmlns:ram="urn:un:unece:uncefact:data:standard:ReusableAggregateBusinessInformationEntity:100"> <rsm:ExchangedDocumentContext> <ram:BusinessProcessSpecifiedDocumentContextParameter> <ram:ID>A1</ram:ID> </ram:BusinessProcessSpecifiedDocumentContextParameter> <ram:GuidelineSpecifiedDocumentContextParameter> <ram:ID>urn:factur-x.eu:1p0:minimum</ram:ID> </ram:GuidelineSpecifiedDocumentContextParameter> </rsm:ExchangedDocumentContext> <rsm:ExchangedDocument> <ram:ID>123</ram:ID> <ram:TypeCode>380</ram:TypeCode> <ram:IssueDateTime> <udt:DateTimeString format="102">20200131</udt:DateTimeString> </ram:IssueDateTime> </rsm:ExchangedDocument> <rsm:SupplyChainTradeTransaction> <ram:ApplicableHeaderTradeAgreement> <ram:BuyerReference>Buyer</ram:BuyerReference> <ram:SellerTradeParty> <ram:Name>Supplyer Corp</ram:Name> <ram:SpecifiedLegalOrganization> <ram:ID schemeID="0002">123456782</ram:ID> </ram:SpecifiedLegalOrganization> <ram:PostalTradeAddress> <ram:CountryID>FR</ram:CountryID> </ram:PostalTradeAddress> <ram:SpecifiedTaxRegistration> <ram:ID schemeID="VA">FR11123456782</ram:ID> </ram:SpecifiedTaxRegistration> </ram:SellerTradeParty> <ram:BuyerTradeParty> <ram:Name>Buyer Corp</ram:Name> <ram:SpecifiedLegalOrganization> <ram:ID schemeID="0002">987654324</ram:ID> </ram:SpecifiedLegalOrganization> </ram:BuyerTradeParty> <ram:BuyerOrderReferencedDocument > <ram:IssuerAssignedID>456</ram:IssuerAssignedID> </ram:BuyerOrderReferencedDocument> </ram:ApplicableHeaderTradeAgreement> <ram:ApplicableHeaderTradeDelivery/> <ram:ApplicableHeaderTradeSettlement> <ram:InvoiceCurrencyCode>EUR</ram:InvoiceCurrencyCode> <ram:SpecifiedTradeSettlementHeaderMonetarySummation> <ram:TaxBasisTotalAmount>100.00</ram:TaxBasisTotalAmount> <ram:TaxTotalAmount currencyID="EUR">20.00</ram:TaxTotalAmount> <ram:GrandTotalAmount>120.00</ram:GrandTotalAmount> <ram:DuePayableAmount>120.00</ram:DuePayableAmount> </ram:SpecifiedTradeSettlementHeaderMonetarySummation> </ram:ApplicableHeaderTradeSettlement> </rsm:SupplyChainTradeTransaction> </rsm:CrossIndustryInvoice>

invoice.html:

.. code-block:: html

<h1>Invoice</h1>

Command-line::

weasyprint invoice.html invoice.pdf --attachment=factur-x.xml --attachment-relationship=Data --xmp-metadata=rdf.xml --pdf-variant=pdf/a-3a

Or Python API:

.. code-block:: python

from weasyprint import Attachment, HTML

document = HTML("invoice.html").render()

factur_x_xml = Path("factur-x.xml").read_text() attachment = Attachment(string=factur_x_xml, name="factur-x.xml", relationship="Data") document.metadata.attachments = [attachment]

xmp_metadata = Path("rdf.xml").read_text().encode() document.metadata.xmp_metadata = [xmp_metadata]

document.write_pdf("invoice.pdf", pdf_variant="pdf/a-3b")

Of course, the content of these files has to be adapted to the content of real invoices.

Include PDF Forms -----------------

By default, form fields are transformed into pure text and graphical shapes when exported to PDF. But WeasyPrint gives the possibility to generate real PDF forms that can be filled with a PDF reader. These forms can even send requests with the data filled in the PDF, just as the same form would do in a web browser.

To transform all HTML forms into PDF forms, you can use the --pdf-formsCLI option orpdf_forms Python parameter.

.. code-block:: python

from weasyprint import HTML HTML(string="<input value='test'>").write_pdf("test.pdf", pdf_forms=True)

.. code-block:: sh

$ weasyprint document.html --pdf-forms document.pdf

You can also define which specific fields (input, select, textarea,button) have to be transformed into PDF forms by setting the appearanceCSS property toautoon them. In this case, as for browsers, you’ll have to manually override the default style set by the user agent stylesheet. Readingthe stylesheet set by the --pdf-forms option
<https://github.com/Kozea/WeasyPrint/blob/main/weasyprint/css/html5_ua_form.css>_ can help to override this style.

.. code-block:: html

<style> label { display: block } .pdf-form { appearance: auto } .pdf-form::before { visibility: hidden } </style> <label> Can't be modified in PDF <input value="static"> </label> <label> Can be modified in PDF <input class="pdf-form" value="dynamic"> </label>

PDF forms support can be quite poor depending on the PDF reader you use. If a feature doesn’t work for you, please check that this feature is actually supported by your PDF reader before reporting a bug.

Define PDF Metadata -------------------

PDF documents can include various metadata, such as title, authors or creation date. The easiest way to define them is to include them in your HTML file: these fields are normalized and can be automatically picked up by WeasyPrint.

.. code-block:: html

<html lang="en"> <head> <title>PDF Sample with Metadata</title> <meta name="author" content="Jane Doe"> <meta name="author" content="John Doe"> <meta name="generator" content="HTML generator"> <meta name="keywords" content="HTML, CSS, PDF"> <meta name="dcterms.created" content="2000-12-31T12:34:56+02:00"> <meta name="dcterms.modified" content="2010-07-14"> <meta name="description" content="This is a simple sample"> </head> </html>

HTML metadata values listed here, including language and title, are stored in the corresponding, normalized fields in PDF.

If you use custom metadata fields, they are not stored in PDF by default. You can include them in the PDF info dictionary using the--custom-metadataCLI option or thecustsom_metadata Python parameter.

.. code-block:: python

from weasyprint import HTML HTML(string="<meta name="recipe" content="fries">").write_pdf("recipe.pdf", custom_metadata=True)

.. code-block:: sh

$ weasyprint document.html --custom-metadata document.pdf

Attach Files ------------

You can attach files to your generated PDF. These files can be opened when a link is clicked in the PDF, or just available in the list of attached files in your PDF reader.

To attach a file with a regular link, you can use a regular anchor with therel attribute set to attachment.

.. code-block:: html

<a rel="attachment" href="note.txt">view attached note</a>

To attach a file globally to the document, you can add a linktag in yourhead:

.. code-block:: html

<link rel="attachment" href="note.txt">

If you don’t want to attach your files using HTML tags, you can also use the--attachment CLI option, multiple times if needed.

.. code-block:: sh

$ weasyprint document.html --attachment note.txt --attachment photo.jpg document.pdf

In a Python script, you can also attach files using the :class:weasyprint.Attachment class.

.. code-block:: python

from weasyprint import Attachment, HTML attachments = [Attachment("note.txt"), Attachment("photo.jpg")] HTML(string="<p>PDF with attachments</p>").write_pdf("recipe.pdf", attachments=attachments)

Cache and Optimize Images -------------------------

WeasyPrint provides many options to deal with images: optimize_images,jpeg_quality, dpi and cache.

optimize_imagescan enable size optimization for images. When enabled, the generated PDF will include smaller images with no quality penalty, but the rendering time may be slightly increased.

The jpeg_qualityoption can be set to decrease the quality of JPEG images included in the PDF. You can set a value between 95 (best quality) to 0 (smaller image size), depending on your needs.

The dpioption offers the possibility to reduce the size (in pixels, and thus in bytes) of all included raster images. The resolution, set in dots per inch, indicates the maximum number of pixels included in one inch on the generated PDF.

.. code-block:: python

# Original high-quality images, faster, but generated PDF is larger HTML('https://weasyprint.org/').write_pdf('weasyprint.pdf')

# Optimized lower-quality images, a bit slower, but generated PDF is smaller HTML('https://weasyprint.org/').write_pdf( 'weasyprint.pdf', optimize_images=True, jpeg_quality=60, dpi=150)

cachegives the possibility to use a cache for images, avoiding to download, parse and optimize them each time they are used.

By default, the cache is used document by document, but you can share it between documents if needed. This feature can save a lot of network and CPU time when you render a lot of documents that use the same images.

.. code-block:: python

cache = {} for i in range(10): HTML(f'https://weasyprint.org/').write_pdf( f'example-{i}.pdf', cache=cache)

It’s also possible to cache images on disk instead of keeping them in memory. The--cache-folderCLI option can be used to define the folder used to store temporary images. You can also provide this folder path as a string forcache.

Improve Rendering Speed and Memory Use --------------------------------------

WeasyPrint is often slower than other web engines. Python is the usual suspect, but it’s not the main culprit here. :ref:Optimization is not the main goal of
WeasyPrint <Why Python?> and it may lead to unbearable long rendering times.

First of all: WeasyPrint’s performance gets generally better with time. You can check WeasyPerf_ to compare time and memory needed across versions.

Some tips may help you to get better results.

- A high number of CSS properties with a high number of HTML tags can lead to a huge amount of time spent for the cascade. Avoiding large CSS frameworks can drastically reduce the rendering time. - Tables are known to be slow, especially when they are rendered on multiple pages. When possible, using a common block layout instead gives much faster renderings. - Optimizing images and fonts can reduce the PDF size, but increase the rendering time. Moreover, caching images gives the possibility to read and optimize images only once, and thus to save time when the same image is used multiple times. See :ref:Cache and Optimize Images.

.. _WeasyPerf: https://kozea.github.io/WeasyPerf/

Show Log Messages -----------------

Most errors (unsupported CSS property, missing image…) are not fatal and will not prevent a document from being rendered. WeasyPrint uses the :mod:loggingmodule from the Python standard library to log these errors and let you know about them.

When WeasyPrint is launched in a terminal, logged messages will go to the standard error stream (stderr) by default. When used as a library, logs are not displayed at all. You can change that by configuring theweasyprintlogger object:

.. code-block:: python

import logging logger = logging.getLogger('weasyprint')

# Display warnings, errors and critical messages. logger.setLevel(logging.WARNING)

# Save logs to the weasyprint.log file. logger.addHandler(logging.FileHandler('weasyprint.log')) # Print logs on console. logger.addHandler(logging.StreamHandler())

The weasyprint.progresslogger is used to report the rendering progress. It is useful to get feedback when WeasyPrint is launched in a terminal (using the--verbose or --debugoption), or to give this feedback to end users when used as a library.

See the documentation of the :mod:logging` module for details.

---

Api Reference Copy Section

Changelog Copy Section

Common Use Cases Copy Section

Explore Related Technologies & Topics

Api Reference

`Changelog`

`Common Use Cases`