Proven Corporation

This document explains HTML templating with the Sphinx documentation system. Sphinx is a tool for converting restructured text documentation into presentation formats like HTML or LaTeX.

Sphinx is used for Python documentation (compare old vs. new), but it is great for for any project in any language. Integrated wikis (like Trac) are nice; but I prefer to keep the documentation together with the source code. Sphinx is perfect for that. It also looks like a million bucks.

This document was tested on Fedora 8; however it is likely to work on all platforms that Python supports. Please contact me if you have questions or comments.

Read the rest of this entry »

Recently, I had to get MonoDevelop working on CentOS 5 for a project. Here is my blow-by-blow summary of how to get it working. The procedure is designed for CentOS 5, and it works on my Fedora 8 system as well. Since most of the activity is just compiling stuff from source, it should be pretty easy to follow on a different distribution. It’s just a matter of getting the correct packages installed in the preparation phase.

Read the rest of this entry »