The AssertJ site is hosted on github, in the gh-pages branch of the assertj repository, just use github pull requests to contribute to it.
The site is composed of static HTML pages based on Bootstrap. A simple templating system is used to avoid duplicating site elements like menus or headers. The style aspects of AssertJs site are managed with LESS files.
To generate the full site use the command:
As the site is composed of generated files (HTML, css), you need to commit the generated files to publish them.
The templating system is a simple python script named generate-html.py which performs the following steps :
Thus the rules :
To generate HTML files (without building CSS files), use the command:
The css files used are built from the following LESS files :
To modify AssertJ style, either change existing values in custom-variables.less or add new instructions in assertj.less.
To generate the CSS files, it is best to reuse the build all command since generating HTML files is super fast: