All interfaces not generated
Closed this issue · 6 comments
https://html.spec.whatwg.org/multipage/indices.html#all-interfaces has "INSERT INTERFACES HERE" rather than a list of interfaces. Works fine single-page.
@sideshowbarker any chance you can help us debug this, since you're most familiar with Wattsi?
I suppose step 1 would be to see if rolling back to an earlier revision of html-build fixes this, but it seems unlikely...
Yeah, will look at this today or this weekend, if I don’t manage to make enough time for it today
From looking at the code this problem has existed all along. Basically cat $HTML_TEMP/wattsi-output/index-html | perl .post-process-index-generator.pl | perl .post-process-partial-backlink-generator.pl > $HTML_OUTPUT/index; runs after Wattsi and never affects multipage.
Making that multipage-friendly seems non-trivial. That Perl script would have to keep track of what "multipage" section the interface appears in (to create hyperlinks that go across section boundaries). And basically aside from changing the main file, also change "indices.html" from multipage.
Doing this as a pre-process will likely not work since Wattsi seems to generate the IDs for partial interfaces. (Wattsi does correctly translate <a href="#..."> for existing IDs which seems quite great.)
However, the post-process never has access to split-filename="" so doesn't know where the interfaces can be found. We could keep a map of <h2 id> to split-filename="" but that would be a bit of a hack.
All the perl scripts should really just be done in wattsi. They're just the bits I never got around to porting.