About

Contents

Rob Brewer

Currently I live in Marlton, NJ, USA and spend my days doing software research and development for a local company. When I'm not working I enjoy swing dancing, unicycling, and travelling. I have an MSE degree in systems engineering from University of Pennsylvania, and a BS degree in electrical engineering from Penn State.

This Site

I built this site using Docutils, which features a very lightweight markup language called reStructuredText. It shares some similarities with Wiki syntax, but is more thoughtfully designed and more powerful. What's nice about it is that you write very readable documents as plain text, and then they can be translated into XHTML for the web or LaTeX for printing.

I have released the scripts I used to build this website in my projects section as buildhtml2. If you would like to see an example of reStructuredText (reST), here is the source for this page. You can also look at the header and footer which is added to every web page. There's also a link at the very bottom of every web page on this site to view the reST source.

Other software and sites that I found useful:

What Didn't Make the Cut?

I nearly went with MoinMoin Wiki or WordPress but decided to roll my own bare-bones templating system with Docutils and write my own CSS for now. A big driver for that decision was my desire to write as much of my content as possible with reStructuredText. Yes, I think it's that good. MoinMoin and Trac support reStructuredText, but it seems like it was an afterthought and it's not clear how well it is supported by the various plugins. My hope is that by going with reStructuredText now, if my needs change in the future I should be able to migrate my content to a new system. And by that time, reStructuredText may have better support by the standard packages out there. The main way I can see my needs changing would be to handle more dynamic content and easier editing from the web.

rest2web also didn't make the cut, but that's a longer story for another page. The short version is that I don't like the way rest2web requires a "restindex" section in every file on the website. This forces me to pollute every page with website-specific data which doesn't even conform to reST syntax. Essentially, rest2web has created its own proprietary file format which happens to have reST in the second portion of it. But rest2web has some other nice features, and I'm wondering how difficult it would be to eliminate this one problem which is a showstopper for me.