svn commit: r1792111 - /cassandra/site/src/README

[sp...@apache.org]

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
 -----------------