librsvg bugs

From Wikimedia Commons, the free media repository
Jump to navigation Jump to search

Wikimedia Commons currently uses librsvg 2.50.3[1] for rendering images. It's a fast renderer compared to Inkscape or batik, but it can be buggy at times. There is a discussion about updating to a newer version on phab:T265549 or on re-evaluating the svg-renderer on phab:T40010.

Some files may be fixed now. If there are any files that were uploaded earlier and have an error in displaying, you can try Purging the file to force a re-render. You should check all the resolutions, since the bugs can show up differently in different resolutions.

If you see a buggy image, tag it with {{Rsvg bug}}. This puts it in Category:Pictures showing a librsvg bug. Some more bugs are reported at Commons:Commons SVG Checker#Checks.

librsvg-history on Wikimedia
version live on Wikimedia
number date[2] begin end
2.3.93[3] 2006[4]
2.14.0[4] 2006[4] at least 2007[5]
2.40.16[6] 2016-06 2016[6] 2017[7]
2.40.18[7] 2017-07 2017[7] 2019[8]
2.40.20-3[9] 2017-12 2019[8] 2020[10]
2.40.21[11] 2020-02 2020[10] 2023-05-16[1]
2.44.10[1] 2018-12 2023-05-16[1] 2024-06-06[12]
2.50.0 2020-09
2.50.3 2024-06-06[12]
2.50.7 2021-06[13]
2.52.0 2021-09
2.58.0 2024-03

Rendering of text

[edit]

Hairline cracks

[edit]

phab:T20936: This bug appears also in modern browsers on zooming levels.

White gap visible at odd px sizes (299px)
Same pic 1px larger rendered (300px)

An workaround can be the using of merge path.

Pattern

[edit]

phab:T20463: The libRSVG's handling of SVG pattern is only rudimentary. Some fixed examples (bug in file history):

Marker

[edit]

The presentation of markers is in different viewers implemented differently. The origin point varies. Inkscape shows the boundaries incorrectly.

Code of 3) use the translate attribute.

<circle id="circle3" transform="translate(20, 20)" stroke="rgb(0%, 70%, 0%)" cx="0" cy="0" r="20"/>
<marker id="marker3" refX="20" refY="20" viewBox="0 0 40 40"
    markerUnits="userSpaceOnUse" markerWidth="40" markerHeight="40">
  <use xlink:href="#circle3"/>  
</marker> 
<line x1="130" x2="270" y1="180" y2="180" marker-start="url(#marker3)" marker-end="url(#marker3)"/>
</svg>

Note that orient="auto-start-reverse" is not implemented in SVG 1.1.

List of open Phab SVG bugs

[edit]

Incomplete (please add missing ones e.g. from https://phabricator.wikimedia.org/tag/wikimedia-svg-rendering/)

Can be solved using svgworkaroundbot.toolforge.org

[edit]

Solution not yet determined

[edit]
  • phab:T261192 Rendering multilingual (systemLanguage) SVG files fails after upgrading librsvg from 2.40.21 to 2.44.10 possibly due to the LANG environment variable not controlling the language preference
  • phab:T265549 Update librsvg to > 2.44.10. Several librsvg issues are not fixed in 2.44.10 (Debian Buster), but are in later versions. Debian Bullseye (testing) is currently shipping 2.50.1.

References

[edit]