~crc_/retroforth#101: 
epub: chapter names are not rendered

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

Status
RESOLVED FIXED
Submitter
Pietro Cerutti
Assigned to
Submitted
16 days ago
Updated
10 days ago
Labels
documentation

Pietro Cerutti 16 days ago ยท edit

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...

~crc_ REPORTED FIXED 10 days ago

Register here or Log in to comment, or comment via email.