brew install git
brew install ruby
gem install bundler
In order to use Github securely, we will generate a SSH key and grant it access to our Github account Follow the directions outlined here
Github Repository Open your Terminal.app and execute the following commands to clone a copy of the repository to your PC
cd Documents git clone [email protected]:OAXFoundation/oaxfoundation.github.io.git cd oaxfoundation.github.io bundle install
Running the website on your PC In the Terminal.app:
cd ~/Documents/oaxfoundation.github.io bundle exec jekyll serve
The first time may take a while as Jekyll generates all the files for our website but afterwards you should see this:
✘ [email protected] ~/work/oax/www.oax.org master bundle exec jekyll serve [12:00PM] Configuration file: /Users/waylandchan/work/oax/oaxfoundation.github.io/_config.yml Source: /Users/waylandchan/work/oax/oaxfoundation.github.io Destination: /Users/waylandchan/work/oax/oaxfoundation.github.io/_site Incremental build: disabled. Enable with --incremental Generating... done in 6.409 seconds. Auto-regeneration: enabled for '/Users/waylandchan/work/oax/oaxfoundation.github.io' Server address: http://127.0.0.1:4000/ Server running... press ctrl-c to stop.
Now that the site is running locally, you can press CMD and click on the http://127.0.0.1/ link (shown in Terminal.app) to open the site in your browser.
You can make changes to your website and they will be automatically detected by Jekyll. To see the changes, simply refresh your browser. Once you are finished, you can exit by hitting CTRL-C in Terminal.app.