This repo contains the contents of http://developer.rhino3d.com.
These instructions cover running this project locally on both macOS and Windows so that you can preview changes before pushing them to GitHub Pages.
First, navigate somewhere safe and clone the repository.
git clone https://github.com/mcneel/developer-rhino3d-com.git
IMPORTANT: The site is branch-aware and automatically deployed by Travis CI. DO NOT PUSH TO THE
The current (stable) version of Rhino is defined in the
stable: field in the
_config.yml file. The
n branch that corresponds to the stable release is built and deployed to http://developer.rhino3d.com.
master branch represents the WIP version of the site. Changes to the
master branch will be built by Travis and deployed to http://developer.rhino3d.com/wip.
Branches are defined in
version_branches) and will be built and deployed into a subpath with the same name; for example: the
5 branch is built and deployed to http://developer.rhino3d.com/5.
As per the Homebrew website, install via the following one-liner (which will prompt you to install the Xcode Command Line Tools, if you don't already have them).
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
Install Ruby (the easy way)
Note: Since OS X 10.11 (El Capitan) we've seen failures during the
gem install step (
ERROR: While executing gem ... (Errno::EINVAL)) on machines that didn't previously have homebrew installed. Using rbenv seems to solve this.
Simply brew Ruby.
brew install ruby
Now close and reopen the Terminal window to make sure the system knows about the new version of Ruby and skip to installing Jekyll.
Install Ruby (the rbenv way)
This is a slightly more advanced method for installing ruby which allows you to easily switch between ruby versions.
brew install rbenv ruby-build
rbenv init which will prompt you to add
eval "$(rbenv init -)" to
~/.bash_profile. Do this.
Install ruby (see .ruby-version for the current version):
rbenv install 2.3.3
Check that everything worked as expected:
ruby --version– should return something like
ruby 2.3.3p222 (2016-11-21 revision 56859) [universal.x86_64-darwin17]
which ruby– should return something like
The GitHub Pages Ruby Gem provides the same version of Jekyll as exists on the GitHub Pages servers. This ensures we aren't accidentally using features that have either been deprecated or simply don't exist on GitHub's servers yet!
gem install github-pages
You can now serve your local copy of this site by running the following commands, remembering to replace
CLONE_DIRECTORY with the location to which you checked out this repository.
cd CLONE_DIRECTORY script/server
Navigate to http://localhost:4000 in your browser to view the site.
api directory is excluded when previewing the site locally which speeds things up a bit!
Optionally, you can follow the directions found on Setting up your GitHub Pages site locally with Jekyll - Windows to use Bundler to install Jekyll.
Install Ruby and Ruby DevKit
At the "Installation Destination and Optional Tasks" dialog, make sure to check the "Add Ruby executable to your PATH" box.
Then, from the same page download the Development Kit that corresponds to your Ruby installation. Jekyll won't be fully functional without this.
Run the self extracting archive, entering the path
C:\RubyDevKit when prompted.
To initialize and install the DevKit, open up a command prompt and roll up your sleeves...
cd C:\RubyDevKit ruby dk.rb init ruby dk.rb install
Install Jekyll and serve
As with macOS, install the GitHub Pages Ruby Gem, navigate to the clone directory and run jekyll.
gem install github-pages cd CLONE_DIRECTORY jekyll serve
Once you have cloned or forked this repository and are able to build it locally, please read the following guides: