Topic: “GitHub”

# Why I Love Markdown

For about the last two months, I’ve steady been moving toward doing all my writing in Markdown. Truth be told, I’ve been moving that way slowly off and on before that, having been looking for a simple syntax like it for quite some time. I’d spent some time writing in Textile—a number of my posts for Pillar on the Rock were composed with it, and I’ve even used it on this site in the past with a (now-largely defunct and therefore unlinked) plugin. Textile is great in a lot of ways – if you’re looking for a syntax that maps directly to HTML. (In fact, if that’s what you’re looking for, Textile is much better than Markdown.)

Then, over the last six months or so, I’ve been using Markdown here and there. Read on, intrepid explorer →

# SICP for Kindle – improved by yours truly

I was looking for a Kindle version of the MIT Press classic text on computer programming, Structure and Interpretation of Computer Programs, which is (delightfully!) available online in its entirety here as an HTML book. (MIT is awesome like that.) I found one, by twcamper on GitHub.

Unfortunately, I discovered that he had eliminated paragraph indentation – apparently Kindle was doing that automatically at some point, but they have since stopped – so I forked it, thinking I’d just add it in, rebuild the .mobi file, and be on my way. Alas, it wasn’t that simple: his documentation skipped a few things (it looks like it was more a way of storing his personal project than meant for public consumption), so I spent a good chunk of the morning figuring out how the project worked, making some tweaks to get it to work the way I wanted it to, and updating the documentation so others could follow my steps themselves if they wanted to make their own tweaks to the CSS file.

You can get the updated book directly from the Downloads page. If you want the Ruby code used to generate it, you can get that direct from the main GitHub page for the project, which also has a (much improved, in my opinion) writeup on how to actually use it. Enjoy!