ericparland/site-tmp

Eagle Documentation Site

Welcome to the Apache Eagle documentation!

Prerequisites

Install jekyll gem

$ gem install jekyll

Generate the site, and start a server locally:

$ jekyll serve -w

The -w option tells jekyll to watch for changes to files and regenerate the site automatically when any content changes.

Point your browser to http://localhost:4000

By default, jekyll will generate the site in a _site directory.

Editing documentations

1. Create a markdown file and add following content in header

    ---
    layout: doc
    title:  "Eagle Overview" 
    permalink: /docs/some-new-doc.html
    ---
    
    More content here ..
   

2. Register the link in documentations sidebar navigation

    documentations:
      - category: "Some category"
        links:
          - title: Some new doc
            url: /docs/some-new-doc.html
   

Publishing the Apache Website

In order to publish the website, you must have committer access to Eagle's subversion repository.

The Eagle website is published using Apache svnpubsub. Any changes committed to subversion will be automatically published to eagle.apache.org.

To publish changes, tell jekyll to generate the site in the publish directory of subversion, then commit the changes:

cd docs
jekyll build -d /path/to/svn/repo/publish
cd /path/to/svn/repo/publish
svn commit