One technology that seems to be getting some traction lately, and one that I really like, is reStructuredText, a part of the Docutils project. I use it extensively for both code documentation and "normal"documents, and I’ve reached a point where I really feel productive in it.
Because I like restructured text, because I’d rather write my blog posts in emacs than some web editor, and because I’m driven to make things more complex than they need to be, I decided to see if I couldn’t find a way to transform restructured text into wordpress-friendly HTML. Thus this was born rst2wordpress, a python/docutils script that aims to produce good-looking HTML that will pass wordpress muster from rst source documents.
The basic idea is that you can write your post in whatever editor you want, using restructured text. Then, when you’re happy with it, simply run
python rst2wordpress.py my_doc.rst > my_doc.html
Right now, you have to copy the "body" of the HTML output and paste it into wordpress. Ultimately, I’d like to produce exactly what wordpress wants, possibly even uploading it. We’ll see.
Consider this post the first test…if it looks OK to you, then I’m doing something right 🙂