Dave Jarvis' Repositories
git clone https://repo.autonoma.ca/repo/keenwrite.git
Removes Batik references
| Author | DaveJarvis <email> |
|---|---|
| Date | 2025-08-29 18:28:54 GMT-0700 |
| Commit | 7ea601b127284e46207664c5752abdc6e9abd7bd |
| Parent | e9680b8 |
| Delta | 6 lines added, 6 lines removed |
docs/06-svg.md
| # SVG compatibility fixes | ||
| -This chapter addresses common compatibility problems that arise when using SVG files created in Inkscape with the Batik SVG drawing software. These issues can prevent proper rendering of vector graphics and result in missing or incorrectly displayed content. | ||
| +This chapter addresses common compatibility problems that arise when using SVG files created in Inkscape. These issues can prevent proper rendering of vector graphics and result in missing or incorrectly displayed content. | ||
| ## Overview | ||
| -The Scalable Vector Graphics (SVG) drawing software---[Batik](https://xmlgraphics.apache.org/batik/)---that's used by the application may be unable to read certain SVG files produced by [Inkscape](https://inkscape.org/). The result is that embedding the vector graphics files may trigger the following issues: | ||
| +The Scalable Vector Graphics (SVG) drawing software---[EchoSVG](https://github.com/css4j/echosvg)---that's used by the application may be unable to read certain SVG files produced by [Inkscape](https://inkscape.org/). The result is that embedding the vector graphics files may trigger the following issues: | ||
| * Unable to create nested element | ||
| * Black blocks, no text displayed | ||
| * Black text instead of coloured | ||
| -The remainder of this document explains these problems and how to fix them. | ||
| +Let's see how to fix them. | ||
| ## Nested element issues | ||
| -This section covers problems related to flowRoot elements that can cause rendering failures when SVG files are processed by Batik. | ||
| +This section covers problems related to `flowRoot` elements that can cause rendering failures when SVG files are processed. | ||
| When referencing a vector graphic using Markdown, the status bar may show the following error: | ||
 | ||
| This section explains why text elements may render as solid black rectangles and provides steps to resolve this rendering issue. | ||
| -Depending on how text is added to a vector graphic in Inkscape, the text may be inserted within an element called a `flowRoot`. Although Batik recognizes `flowRoot` for SVG version 1.2, it cannot fully interpret the contents. Black blocks are drawn instead of the text, such as those depicted in [@fig:blocked-text]. | ||
| +Depending on how text is added to a vector graphic in Inkscape, the text may be inserted within an element called a `flowRoot`. Although `flowRoot` is recognized, the contents may not be fully interpreted. Black blocks are drawn instead of the text, such as those depicted in [@fig:blocked-text]. | ||
|  | ||
| ||
| This section addresses issues where text renders in black instead of the intended colors due to Inkscape-specific font specification references. | ||
| -When an SVG `style` attribute contains a reference to `-inkscape-font-specification`, Batik ignores all values that follow said reference. This results in black text, shown in [@fig:blacked-text]: | ||
| +When an SVG `style` attribute contains a reference to `-inkscape-font-specification`, all values that follow said reference are ignored. This results in black text, shown in [@fig:blacked-text]: | ||
|  | ||
docs/user-manual.pdf
Binary files differ