Next version of devonfw website

Table of Contents

• Collaboration
• Development
  • Initial setup
  • Build
  • Run
  • Adapt Styles
• Deployment

Collaboration

In addition to the github issues, we are maintaining a project board on ZenHub to track the current status.

Development

Initial setup

• 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.

Build

• 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.

Run

• 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.

Adapt Styles

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):

~/asciidoctor-stylesheet$ cp target\stylesheets\devonfw.css ..\target\generated-docs\

Note	This process is automatically done if you execute a complete build of the repository.

Deployment

The deployment of the website is automatically done by the GitHub Action build-and-deploy on each commit.