[Oberon] Web-based books and other documents

[Andreas Pirklbauer]

I agree that some of these examples are impressive and also seem to be visually more appealing than a Wiki book. But I'm not familiar with any of those publication tools in great detail, so I can't really assess the relative merits.
I'll probably just create a pdf version, together with the source, and leave it to others to publish the text on a platform of their choosing.


On Sunday, July 2, 2017, 3:38:06 PM GMT+2, Skulski, Wojciech <skulski at pas.rochester.edu> wrote:

>PS: I have not checked, but how does one upload something to the Wikibook? Who maintains it? What is its goal?

I do not want to disrupt a wonderful task of writing a book, but... Somehow I do not like the wiki.

Here is the "read the docs" project which seems geared towards just that, writing a good quality documents: readthedocs.org/

There is also something named sphinx, which is somehow related to ReadTheDocs: www.sphinx-doc.org/en/stable/

The list of books and other documents written with these tools is pretty impressive:

www.sphinx-doc.org/en/stable/examples.html

Examples include libraries for python,  docs.scipy.org/doc/numpy/reference/ and docs.scipy.org/doc/scipy/reference/

Python itself is also using these tools: docs.python.org/3/

And here is a document with lots of graphics: web.mit.edu/music21/doc/about/what.html

W.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.inf.ethz.ch/pipermail/oberon/attachments/20170702/9ab39df6/attachment.html>