Mention required OS in Readme

[schildbach]

The README.md doesn't mention the OS that is needed for running the commands like "apt-get".

Under Ubuntu 12.10, I was able to just install everything needed by

sudo apt-get install jekyll

[tcatm]

True. Those commands were originally put there as they were needed on the debian VM used to render the page. On recent distros just installing jekyll should be enough, too.

[saivann]

ruby1.9.1-dev build-essential at least are needed to install the ruby gems in my experience.

[schildbach]

But you don't need ruby gems if you install everything from the distro repo.

[saivann]

Just tested 12.04 and 12.10 default ubuntu install.

Current dependencies are OK for 12.04 as jekyll is not in the repositories (but we can drop build-essential and ruby1.9.1-dev for 12.04)

However with 12.10 and "apt-get install jekyll", jekyll "seems" to build correctly. However the CSS file is missing in the _site directory. It seems we need to fix something first before we change the dependencies. I remember that "ruby1.9.1-dev" dependency was linked to some FTBFS problem, and it might be required for 12.10.

[schildbach]

For the record, on Ubuntu 12.10 I had to install

sudo apt-get install node-less

in order to fix problems not finding "lessc".

[schildbach]

And now I'm using

cd _site
python -m SimpleHTTPServer 8000

to just serve the site directory for local testing.

However, all the links are broken. They point to e.g. http://localhost:8000/en/choose-your-wallet while the actual resource is at http://localhost:8000/en/choose-your-wallet.html

[saivann]

Indeed, basic url-rewriting is required to get clean-url feature we can have on a simple apache server or on github. The last time I looked to find a way to handle this with jekyll webrick server, I ended up finding that it would require to patch the server..

[schildbach]

Ok, better than nothing. I can replace the URLs by hand. At least CSS and JS appears to be loaded correctly, so I can test layouts.

[saivann]

Seems perfect with node-less. CSS and plugins build fine, and faster!

How about this in the README :

Installing dependencies on Ubuntu 12.10

sudo apt-get install jekyll node-less

Installing dependencies on older Ubuntu and Debian distributions

sudo apt-get install rubygems ruby1.9.1-dev build-essential
sudo gem install jekyll json less therubyracer

[schildbach]

Perfect. I was going to suggest the same.