Just finished setting up Octopress. It took me quite some time, mainly because the documentation is not great. It kind of assumes a level of experience installing ruby applications, that I simply don’t have. After following the installation instructions using rvm, on the Octopress documentation, I ended up with ruby 1.9.2 but gems would crash with the following error:
> ERROR: Loading command: install (LoadError) no such file to load -- zlib
I spent about one hour trying to get this issue fixed without any success. I
tried compiling ruby with the zlib path set to
$rvm_path/usr, I installed zlib via RVM and via apt, re-compiling ruby after that, none of those did the trick.
The first clue to what was going on was when I ran:
$ rvm requirements
And found the following:
> To install rbx and/or Ruby 1.9 head (MRI) (eg. 1.9.2-head), > then you must install and use rvm 1.8.7 first.
I think this is a Linux, or maybe Debian specific issue, which probably is the reason for it not to be mentioned on the Octopress docs. Installing ruby 1.8.7, upgrading rubygems with it and then going back to ruby 1.9.2, fixed the issue.
After that I had no more problems, all the remaining setup went smothly.
Since, although I had heard about Octopress before, I decided to give it a try after reading the “Uses Of Git” post, I would definitely like to see a pure git deployment strategy, using post-update hooks on the server side, or something of the sorts.
If you'd like to get updates when new posts come up, please subscribe to the feed.