...

• 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
• Markdown: https://daringfireball.net/projects/markdown/
• 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/

...

• Create a new markdown file like https://raw.githubusercontent.com/apache/incubator-eagle/document/website/introduction.md, where following header on the top: 

  Info
  Learn more about markdown syntax? https://daringfireball.net/projects/markdown/syntax

  Code Block
  --- layout: doc title: ${document_title, for example "Tutorial"} permalink: ${permalink, for example '/docs/index.html'" ---   More Markdown Content Here

• Preview :  Visit new created document by visit http://127.0.0.1:4000/${permalink}, for example, http://127.0.0.1:4000/docs/index.html

  Info
  With jerkell server running, any changes on the markdown files will trigger the jekyll service to rebuild the site automatically with logs like: Regenerating: 1 file(s) changed at 2016-04-07 13:03:44 ...done in 0.383916 seconds.

• Configure new created document into document sidebar in https://github.com/apache/incubator-eagle/blob/document/website/_config.yml#L15 like 

  Code Block
  language bash
  - category: Getting Started links: - title: Introduction url: /docs/index.html

  Then the document like will show on the sidebar like http://eagle.incubator.apache.org/docs/ looks.

How to Publish

• Clone site from apache svn repository http://svn.apache.org/viewvc/incubator/eagle/site/ into local directory EAGLE_SITE_SVN_DIR for example "eagle-site-svn"

• Build as static web site into '_site' directory and commit changes under ${EAGLE_SITE_SVN_DIR} back to apache svn repository

  Code Block
  $ jekyll build 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.

• Commit "_site" content into svn repository 

  Info
  How to use SVN? http://svnbook.red-bean.com/ or use GUI tool http://www.smartsvn.com/

• Validate whether the website is updated in http://eagle.incubator.apache.org/docs/