• Open the console in your devonfw distribution (console.bat).

• Clone this project git clone --recurse-submodules --depth 1 https://github.com/devonfw/devonfw.github.io.git.

• Inside /devonfw.github.io/ run mvn clean package -Doutput.format=html.

  • Remark: for your own trials, it might be worth, to go into /devonfw.github.io/devonfw-guide/ and delete all *.wiki folders to speed up build as you might not want to generate the complete docs section of the website.

• Option 1:

  • Install http-server from npm: npm install -g http-server

  • run http-server target/generated-docs/ -o. The default port used will be 8080 but a different one can be specified using the argument -p port-number.

• Option 2:

  • run python -m http.server -d target/generated-docs/ port-number.

Now you will be able to go to http://localhost:<port-number>/index.html.

The entire stylesheet is maintained based on SASS in asciidoctor-stylesheet/sass folder with devonfw.scss file as an entry point. You can build the stylesheet only by running mvn clean package in the asciidoctor-stylesheet folder, which will generate the resulting CSS file to asciidoctor-stylesheet/stylesheets/devonfw.css.

Building the style locally, you can copy this file by hand to /target/generated-docs/ of your cloned repository, where you might already have a version of the website running. Overwriting the already existing devonfw.css will result in a change of your locally served website.

Run the following command to overwrite devonfw.css (inside devonfw.github.io/asciidoctor-stylesheet):