Background

• Home: http://eagle.incubator.apache.org/
• Jekyll: Apache Eagle's document site http://eagle.incubator.apache.org/) is built upon Jekyll (https://jekyllrb.com/) which is a widely-used static websites and blogs generator program. 
  
• Source code:  https://github.com/apache/incubator-eagle/tree/document/website
• Apache SVN Host: Unlike most typical Jekyll web sites, Eagle's website is not hosted on Github Page but Apache SVN server at http://svn.apache.org/viewvc/incubator/eagle/site/

How to Set up Environment

• Install Ruby with RVM (http://rvm.io/) 

  Why use RVM instead of native Ruby? http://code.tutsplus.com/articles/why-you-should-use-rvm--net-19529

  curl -sSL https://get.rvm.io | bash -s stable
  source ~/.profile
  rvm install ruby

• Use Ruby and Gem (https://rubygems.org/) to install Jekyll 

  How to install Jeklly? https://jekyllrb.com/docs/installation/

  rvm list
  rvm use ruby
  gem install jekyll

• Clone Eagle Document Site

  git clone https://github.com/apache/incubator-eagle.git 
  cd incubator-eagle
  git checkout origin/document -b document

• Build and Preview Eagle Document Site (url is http://127.0.0.1:4000/ by default)

  $ cd website
  $ jekyll serve
  /Users/hao/.rvm/gems/ruby-2.2.0/gems/execjs-2.6.0/lib/execjs/external_runtime.rb:135: warning: Insecure world writable dir /usr/local in PATH, mode 040777
  Configuration file: /Users/hao/Workspace/incubator-eagle/website/_config.yml
              Source: /Users/hao/Workspace/incubator-eagle/website
         Destination: /Users/hao/Workspace/incubator-eagle/website/_site
        Generating...
                      done.
   Auto-regeneration: enabled for '/Users/hao/Workspace/incubator-eagle/website'
  Configuration file: /Users/hao/Workspace/incubator-eagle/website/_config.yml
      Server address: http://127.0.0.1:4000/
    Server running... press ctrl-c to stop.

How to Write Document

How to Publish