[GH-ISSUE #1042] Fix missing icons in Epub for definitions, examples, and collaborations #5637

Closed
opened 2026-04-21 21:36:36 -05:00 by GiteaMirror · 1 comment
Owner

Originally created by @profvjreddi on GitHub (Nov 9, 2025).
Original GitHub issue: https://github.com/harvard-edge/cs249r_book/issues/1042

In the Epub version of the textbook, icons for definitions, examples, and collaborations do not appear as expected. This issue seems to be related to foldbox.css and style files not properly handling the icon visibility or inclusion for these sections.

Steps to Reproduce

  1. Generate or open the Epub version of the book.
  2. Navigate to sections labelled as definitions, examples, or collaborations.
  3. Observe that no icon is visible for these categories.

Expected Behavior

Icons should be displayed for definitions, examples, and collaborations in the Epub output.

Potential Causes

  • Issues/missing rules in foldbox.css or related style files affecting Epub styling.
  • Relevant selectors, font files, or image assets may not be referenced or included correctly during Epub build.

Suggested Fix

  • Investigate foldbox.css and related style files for icon styling.
  • Ensure any required assets (SVG, PNG, webfont, etc.) are available and properly exported for Epub.
  • Test Epub output for sections with icons after adjusting style rules.

Labels: ePub, bug
Issue Type: Bug

Originally created by @profvjreddi on GitHub (Nov 9, 2025). Original GitHub issue: https://github.com/harvard-edge/cs249r_book/issues/1042 In the Epub version of the textbook, icons for definitions, examples, and collaborations do not appear as expected. This issue seems to be related to `foldbox.css` and style files not properly handling the icon visibility or inclusion for these sections. ## Steps to Reproduce 1. Generate or open the Epub version of the book. 2. Navigate to sections labelled as definitions, examples, or collaborations. 3. Observe that no icon is visible for these categories. ## Expected Behavior Icons should be displayed for definitions, examples, and collaborations in the Epub output. ## Potential Causes - Issues/missing rules in `foldbox.css` or related style files affecting Epub styling. - Relevant selectors, font files, or image assets may not be referenced or included correctly during Epub build. ## Suggested Fix - Investigate `foldbox.css` and related style files for icon styling. - Ensure any required assets (SVG, PNG, webfont, etc.) are available and properly exported for Epub. - Test Epub output for sections with icons after adjusting style rules. --- Labels: ePub, bug Issue Type: Bug
GiteaMirror added the type: bugarea: collabsformat: epub labels 2026-04-21 21:36:37 -05:00
Author
Owner

@profvjreddi commented on GitHub (Apr 20, 2026):

Fixed. The HTML build uses Bootstrap Icons via CSS pseudo-elements, which EPUB readers don't load — no external font fetch and no icon font embedded in the package. Swapped the three callout types to Unicode glyphs in epub-vol1.css / epub-vol2.css:

  • 📖 Definition
  • 💡 Example
  • 💻 Interactive Colab

Unicode renders reliably across Kindle, Apple Books, Kobo, ClearView, Tolino without a bundled font. Same pattern extends to the other callout types if I want to swap more later.

<!-- gh-comment-id:4284565985 --> @profvjreddi commented on GitHub (Apr 20, 2026): Fixed. The HTML build uses Bootstrap Icons via CSS pseudo-elements, which EPUB readers don't load — no external font fetch and no icon font embedded in the package. Swapped the three callout types to Unicode glyphs in `epub-vol1.css` / `epub-vol2.css`: - 📖 Definition - 💡 Example - 💻 Interactive Colab Unicode renders reliably across Kindle, Apple Books, Kobo, ClearView, Tolino without a bundled font. Same pattern extends to the other callout types if I want to swap more later.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: github-starred/cs249r_book#5637