imathis/octopress — Issue #317: Documentation could note dependencies on Ubuntu 11.10
Author: pokrface
Created: 2011-12-11 16:58:44+00:00
State: open

Throwing this out purely as informational, as I'm not sure if this is the kind of thing that should be noted in the Octopress install documentation or not, but I found that when setting up a current pull of Octopress on Ubuntu Server 11.10 that I had to install a couple of additional packages prior to Ruby being built, or I'd get errors.

Specifically, without the package "zlib1g-dev" present when Ruby is built, the bundler gem install fails like this:

```
$ gem install bundler
ERROR: Loading command: install (LoadError)
no such file to load -- zlib
ERROR: While executing gem ... (NameError)
uninitialized constant Gem::Commands::InstallCommand
```

Also, without the package "libssl-dev" present when Ruby is built, running "rake generate" for the first time fails like this:

```
$ rake generate
(in /home/pokrface/octopress)
## Generating Site with Jekyll
directory source/stylesheets/
create source/stylesheets/screen.css
Configuration from /home/pokrface/octopress/_config.yml
/home/pokrface/.rbenv/versions/1.9.2-p290/lib/ruby/1.9.1/net/https.rb:92:in `require': no such file to load -- openssl (LoadError)
from /home/pokrface/.rbenv/versions/1.9.2-p290/lib/ruby/1.9.1/net/https.rb:92:in `'
from /home/pokrface/octopress/plugins/gist_tag.rb:10:in `require'
http://octopress.org/ from /home/pokrface/octopress/plugins/gist_tag.rb:10:in `'
from /home/pokrface/.rbenv/versions/1.9.2-p290/lib/ruby/gems/1.9.1/gems/jekyll-0.11.0/lib/jekyll/site.rb:76:in `require'
from /home/pokrface/.rbenv/versions/1.9.2-p290/lib/ruby/gems/1.9.1/gems/jekyll-0.11.0/lib/jekyll/site.rb:76:in `block in setup'
from /home/pokrface/.rbenv/versions/1.9.2-p290/lib/ruby/gems/1.9.1/gems/jekyll-0.11.0/lib/jekyll/site.rb:75:in `each'
from /home/pokrface/.rbenv/versions/1.9.2-p290/lib/ruby/gems/1.9.1/gems/jekyll-0.11.0/lib/jekyll/site.rb:75:in `setup'
from /home/pokrface/.rbenv/versions/1.9.2-p290/lib/ruby/gems/1.9.1/gems/jekyll-0.11.0/lib/jekyll/site.rb:30:in `initialize'
from /home/pokrface/.rbenv/versions/1.9.2-p290/lib/ruby/gems/1.9.1/gems/jekyll-0.11.0/bin/jekyll:224:in `new'
from /home/pokrface/.rbenv/versions/1.9.2-p290/lib/ruby/gems/1.9.1/gems/jekyll-0.11.0/bin/jekyll:224:in `'
from /home/pokrface/.rbenv/versions/1.9.2-p290/lib/ruby/gems/1.9.1/bin/jekyll:19:in `load'
from /home/pokrface/.rbenv/versions/1.9.2-p290/lib/ruby/gems/1.9.1/bin/jekyll:19:in `

'
```

The solution for each was to install the missing lib and re-build Ruby (which I was doing with the totally cool and automated "rbenv install" method), but a note about having those two libs installed prior to starting the Octopress setup would have saved me a bit of frustrated googling.

Very much enjoying Octopress. Thanks!