Request to have offline (e.g. epub) files available for downloading

[pransh15]

@bordenc submitted a proposal for the ability to download files as .epub on mdn/mdn#706, sharing it here for more comments.

Proposal

Python documentation is available for offline download, notably in epub and html files. Granted, Sphinx supports epub and html outputs, whereas the best tool for markdown to epub conversion seems to be pandoc. Nevertheless, it would be great to be able to download MDN guides for offline reading.

Browser support

No response

Tasks

• [ ]

Dependencies

• [ ]

Additional information

No response

Are you willing to support this work?

I can probably bash out some Python or some other config file that would allow something like pandoc to compile the guides into offline formats. It's probably not worth writing a separate toolchain, especially in javascript, to do this.

[bordenc]

Thank you for migrating.

Having worked with the documentation (somewhat), I think one of the first challenges is establishing a linear reading order, which is necessary to program the ePub's "spine". The documentation I've read appears written in a cross-linked reference style. It doesn't appear to be written in a way that naturally lends to being readable cover-to-cover.

Happy to stand corrected.