Dear Sage developers,
Over the years, many of us have grown personal collections of
tutorials written at the occasion of various events (courses, Sage
Days, ...), often written in reST. Putting them together would foster
reuse, collective writing, cross references, cross-reviews, and
maturation in general, with the aim to migrate the mature ones in
Sage.
That's what some of us were doing in the Sage-Combinat queue; the
workflow was horrendous but the sharing effect worked really well.
To relaunch that effort, with a lean and modern workflow, I have
created a repository:
https://github.com/sagemath/more-sagemath-tutorials
and initialized it with the documents from the Sage-Combinat queue [1].
The HTML version is hosted at ReadTheDocs and automatically rebuilt:
https://more-sagemath-tutorials.readthedocs.io/en/latest/
Note the style reminiscent of Sage's documentation. That's no
accident: most of its features (wikipedia & trac links, mathjax,
crosslinks to the Python and Sage documentation) are available [2].
The project's README contains more details and rationale for using
reST for authoring tutorials and similar documents.
Comments, suggestions and contributions most welcome!
Cheers,
Nicolas
[1] they were also stored in a branch at http://trac.sagemath.org/ticket/16810
[2] I am in the process of extracting this into a standalone pip
package to make it reusable in other pip packages for Sage.
--
Nicolas M. Thiéry "Isil" <nthi...@users.sf.net>
http://Nicolas.Thiery.name/
--
You received this message because you are subscribed to the Google Groups
"sage-devel" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to sage-devel+unsubscr...@googlegroups.com.
To post to this group, send email to sage-devel@googlegroups.com.
Visit this group at https://groups.google.com/group/sage-devel.
For more options, visit https://groups.google.com/d/optout.
