Initial single-page docs

[fmalita]

Using mkdocs-print-site-plugin:

• add a single-page version of the docs under lottie-spec/print_page/

• hide live examples from the consolidated page

[fmalita]

The TOC may need some cleanup/tweaking, maybe someone more familiar with mkdocs can take a stab.

[b-wils]

What's the intended discovery path for this? I couldn't find a link anywhere, so ended up looking up the docs.

Maybe we can add a link to index.md or in the nav bar?

[fmalita]

I intentionally left it hidden for now because the TOC may require some extra polishing. But yeah, a link in index.md or nav bar is exactly where I think it should end up.

[mbasaglia]

I wonder if we can inject a tree processor that cleans up empty sections before the TOC is generated

[fmalita]

I wonder if we can inject a tree processor that cleans up empty sections before the TOC is generated

AFAICT markdown processors are not applied to plugin output...

Maybe we could have a separate mkdocs config just for the single page version? Or a separate mkdocs config for the actual spec content ?

[fmalita]

What's the intended discovery path for this? I couldn't find a link anywhere, so ended up looking up the docs.

Maybe we can add a link to index.md or in the nav bar?

Added a link in "Where to start".

[mbasaglia]

I patched the plugin: timvink/mkdocs-print-site-plugin#112

We can reference it as git+https://github.com/mbasaglia/mkdocs-print-site-plugin.git@clean-toc for pip packages (you might need to uninstall the old one first)

[fmalita]

I patched the plugin: timvink/mkdocs-print-site-plugin#112

We can reference it as git+https://github.com/mbasaglia/mkdocs-print-site-plugin.git@clean-toc for pip packages (you might need to uninstall the old one first)

Thanks, done!

[mbasaglia]

Could we use this to make a PDF as well?

[fmalita]

I think it's doable but the process is not exactly straightforward (Chrome printing + Puppeteer): https://timvink.github.io/mkdocs-print-site-plugin/how-to/export-PDF.html#automated-export-using-nodejs-and-chrome

[mbasaglia]

I guess if someone wants the PDF they could print to file anyway

[mbasaglia]

I patched the plugin: timvink/mkdocs-print-site-plugin#112

We can reference it as git+https://github.com/mbasaglia/mkdocs-print-site-plugin.git@clean-toc for pip packages (you might need to uninstall the old one first)

The patch got merged, so if they make a release we can switch back to the official package