Proposal: Asciidoc-based conversion for EPUB/HTML5 support (EPUB available inside)

[hcoona]

Some community members have expressed interest in having more convenient formats (such as EPUB) in addition to the existing PDF #46 #256 #205 . Previous attempts to generate EPUB directly from LaTeX (via Pandoc, LaTeXML, or TeX4ht) have not yielded satisfactory results.

To address this, I have developed a custom parser and renderer that converts the LaTeX sources into Asciidoc. Compared to Markdown, Asciidoc retains necessary formatting features without relying on non-standard extensions, while also providing backends for HTML5, EPUB, and PDF.

The current implementation can successfully convert all files under src/content, and the results have been manually reviewed. Apart from TikZ diagrams, which are not yet fully supported, the conversion is stable and produces accurate Asciidoc output.

The work is available here:
https://github.com/hcoona/milewski-ctfp-pdf/tree/dev/shuaizhang/main

This could serve as a foundation for generating EPUB and HTML5 versions alongside the existing PDF, making the material easier to read across different devices.

Feedback from maintainers and contributors would be very valuable in determining next steps.

[hcoona]

milewski-ctfp-html.zip provided as a preview. :)

[hcoona]

ctfp.html provided as a preview. Index not build for the HTML yet.

To convert to epub, I still need to figure out a good way to convert the math into images via LaTeX. Current HTML version render with MathJax.

[hcoona]

ctfp.zip Updated version of HTML file. It's too large to upload so I compressed it.

I converted the LaTeX equations into SVG images and embedded into the HTML file. It makes a further step to build EPUB3 file.

Convert this file with Calibre to EPUB looks good to me. I read it on my Kindle.

[hcoona]

ctfp.zip The first version of EPUB3 built from Asciidoc files. It still have some problems but can prove my idea.

1. \_ not escaped correctly.
2. Embedded SVG math equation are too small.