storage optimization with shared side-bar in the html

[ljbrooks]

I am using mdbook for manual pages, which is auto generated with 100K md files. This is becoming an issue as it would take 100G to 200G disk space and hours of mdbook build time, and I think the bottleneck is how the sidebar is handled.

I looked into the generate html file, it seems every html file is 14MB because the side bar is duplicated verbatim, is having all the MD files listed and it takes a lot of space. I wonder if mdbook can optimize this a bit by sharing the side-bar data in a shared file and let all the HTML files load it.

I am no expert on this, just a speculation based on my observation.

[SichangHe]

Maybe we can do this iframe trick.

But, how do you highlight the current page in the side bar?

[SichangHe]

I suppose we can do this without modifying the binary.

1. Hand write a Table of Content and put it in /src, e.g. /src/toc.html.
2. Remove the sidebar section in index.hbs, and replace it with an iframe, e.g.

    <iframe src="{{ path_to_root }}/toc.html" onload="this.before((this.contentDocument.body||this.contentDocument).children[0]);this.remove()"></iframe>

[notriddle]

Fixed by #2414

[notriddle]

@rustbot close

[rustbot]

Error: The feature close is not enabled in this repository.
To enable it add its section in the triagebot.toml in the root of the repository.

Please file an issue on GitHub at triagebot if there's a problem with this bot, or reach out on #triagebot on Zulip.