fix(epub): Replace CSS variables with literal values to prevent XML parsing errors

Browse Source

Addresses #1052

## Problem
The EPUB version was failing to open in ClearView with XML parsing errors:
"Comment must not contain '--' (double-hyphen)" at multiple lines.

## Root Cause
CSS custom properties (--crimson, --text-primary, etc.) contain double
hyphens which violate XML comment specifications. While the stylesheet
is linked externally in the built EPUB, some readers may embed or process
the CSS in ways that trigger strict XML parsers.

## Solution
Replaced all 66 instances of CSS variables with their literal hex color
values throughout epub.css. This ensures EPUB compatibility across
different readers while maintaining the same visual appearance.

## Changes
- quarto/assets/styles/epub.css: Removed :root variables, replaced all
  var() references with literal values, added documentation
- quarto/config/_quarto-epub.yml: Added note about inkscape requirement

## Testing
Built EPUB successfully, validated XHTML files with xmllint. CSS variables
confirmed present in original, absent in fixed version.

...

This commit is contained in:

Vijay Janapa Reddi

2025-11-25 02:53:08 -05:00

parent 75785d63a6

commit 040b95ef00

Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL

Download Patch File Download Diff File Expand all files Collapse all files

Diff Content Not Available