Skip to content


Subversion checkout URL

You can clone with
Download ZIP
An Awestruct project that generates the Netty project web site
HTML Other
branch: master
Failed to load latest commit information.
3.10 new releases
3.5 Update generated docs for all 3.x versions
3.6 New 3.6.10.Final release
3.7 Announce releases
3.8 Announce releases
3.9 new releases
4.0 Add new release
4.1 new releases
5.0 Update javadocs for new releases
_bin Use the new tracking code for Google Analysis / Remove unused site pr…
_config Fix date
_ext Implement link shortening
_layouts Fix URL
files Update the IntelliJ IDEA inspection profile
images Make the background of components.png transparent
lib Update logo images
news Add new release
sponsor Update logo images
wiki Fix broken links
.awestruct_ignore Ignore 5.*
.gitignore Add Netty 3.9.2.Final
404.html.haml Fix 404 page
CNAME We're going live :-)
Gemfile Update Awestruct and other dependencies Upgrade to awestruct 0.5.0
community.html.haml Fix a broken link
downloads.html.haml Add the build badge to the nightly build section
index.html.haml Update the JDK requirement Clean-up for
robots.txt New web site that will replace XWiki
search.html.haml New web site that will replace XWiki
testimonials.html.haml Upgrade to Bootstrap 3.0.0

This is an web site project based on Awestruct. It generates the complete web site and documentation of the Netty project.

To contribute to the project documentation, simply fork this repository and issue a pull request.

Step 1. Installing Awestruct

Your system must have a working Ruby installation (1.9+) because Awestruct is written in Ruby. You can install Awestruct using the bundle command:

$ bundle install

Step 2. Fork netty-website Repository

First, fork the official repository and clone it into your local storage:

$ git clone<username>/netty-website.git

Switch to your newly cloned repository and add netty-website as a remote

cd netty-website/
git remote add upstream git://

Optionally, you may wish to create a branch if you are planning multiple contributions. Please choose the branch name wisely because everyone will see it.

$ git fetch upstream
$ git checkout -b <branchName> upstream/master

Step 3. Making Changes and Testing

Modify the web site files as you wish.

To test locally, start the embedded web server using Awestruct.

$ cd netty-website
$ bundle exec awestruct --auto --server

The web site will be available at http://localhost:4242/

When the embedded Awestruct web server is running, changes you make will trigger a re-generation of the web site. Wait for this to complete before refreshing your browser to see your changes.

Step 4. Committing your changes

To commit all your changes:

$ git commit -a

Next, push your changes back to your fork on github. You only need to supply a branch name if you previously created a branch.

$ git push origin <branchName>

Lastly, submit a pull request from your repository. Make sure to make the pull request using the branch you used for the guide.

Step 5. Deploying the web site

Only those with commit access will be able to perform this step.

Run the _bin/ script with the path to the Github Pages repository:

$ cd netty-website
$ _bin/ ../

The example above copies the generated web site into the local Github Pages repository located at ../, and pushes all the changes to origin.

Something went wrong with that request. Please try again.