That's very interesting, thanks! We should look into that. - Alon
On Thu, Jun 19, 2014 at 2:12 PM, Warren Seine <[email protected]> wrote: > If you like Sphinx, you should definitely have a look at ReadTheDocs > <https://readthedocs.org/>. Basically, it's a platform for hosting > documentation from Sphinx source files. The source of the documentation > stays on GitHub and documentation is regenerated on commit hooks. It's > quite popular in the Python community, though there's nothing specific to > the language. > > Of course, there's an export feature for PDF and ePub. Also, the default > themes are nice enough to start with. > > Cheers, > > > On Thursday, June 19, 2014 8:37:29 PM UTC+2, Alon Zakai wrote: > >> Sphinx sounds interesting, thanks. The export options in particular (PDF, >> ePub) are appealing. >> >> - Alon >> >> >> >> On Wed, Jun 18, 2014 at 10:09 PM, Bruce Mitchener <[email protected]> >> wrote: >> >> On Thu, Jun 19, 2014 at 1:16 AM, Alon Zakai <[email protected]> wrote: >>> >>>> Hi everyone, >>>> >>>> We are planning to start an overhaul of the emscripten documentation >>>> soon, that is, of the contents of the wiki on github. One option might be >>>> to move to Jekyll, which is convenient as it has good github integration. >>>> >>>> If you have any thoughts on the current docs and how they can be >>>> improved, let's discuss here. >>>> >>> >>> I really like working with Sphinx and ReStructured Text: >>> http://sphinx-doc.org/ >>> >>> I've used it (successfully) to produce thousands of pages of technical >>> documentation, encompassing multiple books. We publish these materials in >>> HTML, PDF and ePub. We've written our own extensions as needed and it has >>> been pretty easy. >>> >>> I can't say enough positive things about it and only have a few >>> relatively minor complaints. >>> >>> - Bruce >>> >>> -- >>> You received this message because you are subscribed to the Google >>> Groups "emscripten-discuss" group. >>> To unsubscribe from this group and stop receiving emails from it, send >>> an email to [email protected]. >>> For more options, visit https://groups.google.com/d/optout. >>> >> >> -- > You received this message because you are subscribed to the Google Groups > "emscripten-discuss" group. > To unsubscribe from this group and stop receiving emails from it, send an > email to [email protected]. > For more options, visit https://groups.google.com/d/optout. > -- You received this message because you are subscribed to the Google Groups "emscripten-discuss" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. For more options, visit https://groups.google.com/d/optout.
