In addition to the github issues, we are maintaining a project board on ZenHub to track the current status.
-
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/runmvn 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:https://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):
~/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. |
The deployment of the website is automatically done by the GitHub Action build-and-deploy on each commit.