Files

Diego Rondini 68a57f69f0 docs: switch to goldmark markdown handler (#1304 )

Abandon no longer supported blackfriday markdown handler and switch to
default goldmark markdown handler. Enabled typographer extension to
handle quotes and dashes.

Website is now building with hugo > 0.100 as well.

Build tested with hugo 0.101.0:
$ docker run --rm -it -v $(pwd):/src:Z -p 1313:1313 klakegg/hugo:0.101.0
server

Signed-off-by: Diego Rondini <diego.rondini@kynetics.com>

2023-01-10 08:00:06 +01:00

content

docs: fix sandbox URL (#1303 )

2023-01-10 07:59:27 +01:00

layouts

docs: fix sandbox URL (#1303 )

2023-01-10 07:59:27 +01:00

static

docs: fix sandbox URL (#1303 )

2023-01-10 07:59:27 +01:00

cleanup.sh

Introduce new, Hugo templates based, website (#713 )

2018-08-01 11:01:02 +02:00

config.toml

docs: switch to goldmark markdown handler (#1304 )

2023-01-10 08:00:06 +01:00

install-theme.sh

Fix Typos and remove unchanged theme files (#719 )

2018-08-23 13:29:08 +02:00

pom.xml

Introduce new, Hugo templates based, website (#713 )

2018-08-01 11:01:02 +02:00

README.md

Introduce new, Hugo templates based, website (#713 )

2018-08-01 11:01:02 +02:00

README.md

Eclipse hawkBit Documentation

The hawkBit documentation is built with Hugo using the Material theme. Compiling the documentation is not included within the regular Maven build.

Prerequisites

Install Hugo: see installing Hugo documentation on how to install Hugo.
Install hawkBit: run mvn install in the parent directory to generate the latest REST docs for hawkBit.

Build and Serve documentation

The following Maven targets are available in order to build and serve the documentation:

mvn install: i. Copies the generated REST docs to content/rest-api/ and ii. downloads the required Hugo theme
mvn site: Serve the documentation on localhost:1313/hawkbit/
mvn clean: Delete generated artifacts (REST docs, Hugo theme)

Note: Currently, only Unix/macOS is supported! For Windows, use the hugo commands in CMD.

Generate /public folder

In order to generate the /public folder, which can be put on a web-server, run the following command:

$ hugo