Literate Programming for Gits (and rst2wordml)
My apologies to the British readers for the title.
I’ve been working on lots of things as the little spare time I have allows. I’ve managed to update rst2wordml, mostly thanks to the proddings of Alan Isaac. Thanks Alan!
I’ve recently switched my source control from Subversion to Git. The primary reason I switched was git’s breeze easy support for branching and merging. It’s so easy to start a new feature in a branch and then later merge it into the trunk. There are lots of other reasons for me to switch as well: distributed development, ease of backups, size of repositories, .svn droppings, etc. However, I admit that Subversion definitely has a more mature tool set and works much better on Windows than git does. Linus himself gives a great introduction to git, though I think he could use a dose of modesty.
I’ve also publicized my desire to create a tool for literate programming using reST. It turns out there is such a tool already! PyLit does almost exactly what I wanted to do. It’s a separate tool outside of the docutils source, and what I had envisioned (and partly developed) was something more integrated, but it does what I need it to and saves me that much work.
As a bonus, there’s also a tool, rest2web, that turns a series of reST documents into a complete website. I can use this to write the articles as an entire site rather than just a set of html pages. My project is about ready to take off.
Now if I could just figure out how to get my ISP’s server and git to cooperate so I can put the repository for rst2wordml up on this website.