Skip to content

netty/netty-website

Folders and files

NameName
Last commit message
Last commit date

Latest commit

e8d884a · Feb 26, 2025
Mar 13, 2024
Jun 29, 2016
Nov 7, 2013
Sep 12, 2014
Apr 30, 2014
Apr 30, 2014
Jul 21, 2015
Feb 6, 2018
Feb 26, 2025
Feb 11, 2025
Jul 22, 2022
May 14, 2018
Feb 26, 2025
Apr 8, 2022
Jan 12, 2024
Jan 9, 2023
Mar 22, 2019
Nov 8, 2014
Oct 29, 2021
Feb 26, 2025
Jan 12, 2024
Jan 12, 2024
Dec 22, 2013
Jan 6, 2023
Jan 16, 2014
Feb 19, 2013
Mar 13, 2024
Mar 13, 2024
Jan 12, 2024
Jun 1, 2024
Jan 4, 2023
Mar 17, 2022
Feb 18, 2013
Feb 18, 2013
Feb 7, 2023

Repository files navigation

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 git@github.com:<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://github.com/netty/netty-website

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 -u https://netty.io

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/deploy.sh script with the path to the Github Pages repository:

$ cd netty-website
$ _bin/deploy.sh ../netty.github.com

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