Markdown to ePub Edgecase Document List

[crutchcorn]

• Internal links need to be made into absolute links (![Some link](/posts/other) -> ![Some link](https://unicorn-utterances.com/posts/other)) #1050
• Internal links that are part of the same collection need to be removed entirely (![Some link](/posts/ffg-other) -> Some link)
• <details> and <summary> need to expand before rendering to ePub #1051
• <iframe> with uu-code links need to be removed entirely
  • Because this content can be wrapped in no-epub comments, these can be handled the same as other iframes.
• External links need to generate reference links:
  • <a> and <iframe> elements need to be collected and numbered for each chapter of each book.
  • <a> elements should have superscript for their link number
    • e.g. "Here is a link.^[37]"
  • <iframe> elements should be replaced with a link based on the embed title
    • e.g. "React What is a Directive? - StackBlitz^[38]"
  • A "References" chapter should be added at the end of each book containing a list of all referenced links
    • This should be split by chapter - e.g. "Chapter 8, Element Reference" -> Link 37 -> https://example.com
    • The link numbers are still unique - so Chapter 8 might contain Links 32-39, and Chapter 9 might have Links 40-42

[fennifith]

Internal links that are part of the same collection need to be removed entirely

It looks like internal links are possible within an epub - likewise for supporting anchors/heading links. Would this be something we want to implement instead of removing them entirely?

(this would require mapping each chapter link to the filename that it goes into - which can be passed into html-to-epub)

[MateuszWasik]

<details> and <summary> need to expand before rendering to ePub

It appears that <details> and <summary> elements are not supported by the EPUB format, and our rehype plugin, intended to expand those elements before rendering EPUB, is not functioning.

As we discussed, the solution is to transform those elements into divs and add a class that will style them to resemble <details> exactly. This transformation will be implemented within the rehype plugin before rendering to the EPUB format.