[Oberon] Web-based books and other documents
andreas_pirklbauer at yahoo.com
Sun Jul 2 15:46:26 CEST 2017
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:
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
-------------- next part --------------
An HTML attachment was scrubbed...
More information about the Oberon