Update project description
1 file changed
tree: b109c6e30941edf9cbcd3250d9c2c63ce2af4036
  1. site/
  2. .gitignore
  3. LICENSE
  4. NOTICE
  5. README
  6. README.md
README.md

Apache Bahir Website

The Apache Bahir website was forked from the Apache Website Template.

The website gets generated using Jekyll.

To use it, copy the site directory into your project. You must also include licensing information from the LICENSE and NOTICE files in your own project.

How to deploy your project's web site

(In the following instructions we assume that your project is called ‘Apache Foo’; search and replace with your actual project name.)

Setup

1. cd site
2. svn co https://svn.apache.org/repos/asf/bahir/site target
3. sudo apt-get install rubygems ruby2.1-dev zlib1g-dev
4. sudo gem install bundler github-pages jekyll
5. bundle install

Add javadoc

If your project supports javadoc, you can copy the generated javadoc into svn each time you need to re-generate.

1. cd ..
2. mvn -DskipTests site
3. mv target/site/apidocs site/_site

Running locally

Before opening a pull request, you can preview your contributions by running from within the directory:

1. bundle exec jekyll serve
2. Open [http://localhost:4000](http://localhost:4000)

Pushing to site

1. cd site/_site
2. svn status
3. You'll need to `svn add` any new files
4. svn ci

Within a few minutes, svnpubsub should kick in and you'll be able to see the results at bahir.apache.org.

Adding contributors

To add a contributor to the project, or to modify existing contributors, edit site/_data/contributors.yml. The project members list will be re-generated.