Skip to content

Latest commit

 

History

History
50 lines (29 loc) · 2.43 KB

README.asciidoc

File metadata and controls

50 lines (29 loc) · 2.43 KB

Next version of devonfw website

badge

Collaboration

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

Development

Initial setup

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.