search

imathis / octopress

Octopress is an obsessively designed framework for Jekyll blogging. It’s easy to configure and easy to deploy. Sweet huh?
http://github.com/imathis/octopress
9.31k stars 2.62k forks source link

ruby install page forgets to mention a version #972

Open erikbgithub opened 11 years ago

erikbgithub commented 11 years ago

It was the first time I had to install Ruby on my system for anything, so I followed your guide, yet I always got the error message that rbenv doesn't know ruby and that a binary would be available in the version 1.9.3-p0, which of course is what I just installed. I don't know what I might have missed in your guide but after doing the following command (after your tutorial) it finally worked:

$ rbenv global 1.9.3-p0

Is that enough information to figure out, what might have went wrong?

erikbgithub commented 11 years ago

actually every frickin step doesn't work without googling. Is that what I can expect of all the documentation?

imathis commented 11 years ago

What OS are you on? Also, take it easy. The docs are fine, It's probably something with your system or I'd be drowning in complaints.

erikbgithub commented 11 years ago

Hey, Brandon. Thanks for your fast reaction. I don't think it's something about my environment, though (Ubuntu 12.04 LTE). Some things I remember from last night:

  1. In the rbenv guide the patch-id doesn't seem to be right. it should be p194 not p0 (otherwise it didn't want to work). It feels uncomfortable to update your guide every time a new patch is applied though. Isn't there a better way to say just install ruby 1.9.3 with the latest patch?
  2. Then after rbenv rehash there should be a rbenv global <ruby-version>. If you google for rbenv tutorials, they will also include this command.
  3. You need to actually clone or cp most of the octopress code into your project folder, that you can use octopress. This isn't said anywhere and it's not expected default behaviour (at least in the python world). E.g. you can't call the rake command without a Rakefile. I guess this kind of stuff is common knowledge for the experienced Rubyist, but this being my first try with a Ruby project I didn't know any of it. Figuring all that out at 2am in the morning, doesn't make people happy. ;)

And btw. I got it working now. After the starting issues are solved, it works really well. Also writing markdown and statically compiling the blog feels both much more natural then Wordpress, Django and co. Kudos for the idea! I think I keep it!

parkr commented 11 years ago
  1. We can definitely use the .ruby-version file. Something like rbenv install $(cat .ruby-version) or something.
  2. Just because you are installing this one version doesn't mean you want it to be your default, so this line would have a # to set default ruby, if desired note.
  3. The idea behind the current setup with octopress is that, yeah, you git clone this repository, ensure that your development env (ruby is installed, gems dependencies are installed) is right, and go on blogging. But this repo contains all the stuff you need - just clone and go. I suppose it makes working from current projects difficult, but clean installs are always nice :-)

Glad you got it working.