The html files used to generate the epub don't have a title. This makes reading the epub pretty uncomfortable, because you pass from one paragraph to the next one without noticing that the chapter has changed.
I see that the html files have a period in the title tag in the head, and no mention of the title as h1 or anything.
-- Pietro Cerutti I have pledged to give 10% of income to effective charities and invite you to join me - https://givingwhatwecan.org
I see that example/markdown-to-xhtml.retro is supposed to render h1 titles (
#
in the markdown) as<span class="h1">
.now, something weird happens. In the repo, there's no span with class h1:
> grep h1 doc/html/chapters/techniques/strings.html .h1, .h2, .h3, .h4 { white-space: normal; } .h1 { font-size: 125%; }
however, they pop up if I regenerate the docs with retro built from master.
> echo bye | ./bin/retro RETRO 12 (2024.9) 524288 Max, 44755 Used, 479533 Free > ./bin/retro tools/generate-html-docs.retro Create directories chapters chapters/building chapters/general chapters/internals chapters/tech-notes chapters/techniques chapters/toolchain chapters/toolchain/info chapters/toolchain/man html Generate `index.html` Convert chapters to XHTML ................................................................. Relocate files > grep h1 doc/html/chapters/techniques/strings.html .h1, .h2, .h3, .h4 { white-space: normal; } .h1 { font-size: 125%; } <p><span class="h1">Working With Strings</span>
And when I regenerate the epub, it looks fine. Probably something went wrong with the generation of the html files in the repo.
I hope this helps...
This has been fixed in http://fossils.retroforth.org:8000/nga/info/7dd2b1bd7506c2c4