Author: spod Date: Thu Apr 20 18:56:40 2017 New Revision: 1792111 URL: http://svn.apache.org/viewvc?rev=1792111&view=rev Log: Add Jekyll and rbenv install instructions
Modified: cassandra/site/src/README Modified: cassandra/site/src/README URL: http://svn.apache.org/viewvc/cassandra/site/src/README?rev=1792111&r1=1792110&r2=1792111&view=diff ============================================================================== --- cassandra/site/src/README (original) +++ cassandra/site/src/README Thu Apr 20 18:56:40 2017 @@ -6,6 +6,30 @@ Prerequisite The site depends on Jekyll (https://jekyllrb.com/) which should be installed. +Please use Jekyll 3.4.x for compiling the html pages, so we get identical results for everyone. + +Installing Jekyll independently from the version shipped with your OS can be done as follows: + +# Use rbenv to use a specific Ruby version with Jekyll: +# See: https://github.com/rbenv/rbenv/#installation +git clone -b v1.1.0 https://github.com/rbenv/rbenv.git ~/.rbenv +echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.zshrc # change to bashrc if needed + +# Install ruby +# See: https://github.com/rbenv/rbenv/#installing-ruby-versions +rbenv install 2.4.1 + +# Associate with Cassandra svn directory +cd ~/svn/cassandra-site # change as needed +rbenv local 2.4.1 +which rbenv # should point to shim +ruby --version + +# Install jekyll with local rbenv version +gem install jekyll -v 3.4.3 +jekyll --version + + Updating the site -----------------