3978454900
* Generating rest doc from swagger json Signed-off-by: Denislav Prinov <denislav.prinov@bosch.com> * refactoring and adding doc Signed-off-by: Denislav Prinov <denislav.prinov@bosch.com> * refactoring Signed-off-by: Denislav Prinov <denislav.prinov@bosch.com> * Don't directly inject files in the executable jar since it brakes it Signed-off-by: Denislav Prinov <denislav.prinov@bosch.com> * using the attachArtifact configuration to generate secondary artifact Signed-off-by: Denislav Prinov <denislav.prinov@bosch.com> * Splitting the json documentation into mgmt and ddi. And some refactoring Signed-off-by: Denislav Prinov <denislav.prinov@bosch.com> * refactoring Signed-off-by: Denislav Prinov <denislav.prinov@bosch.com> * Split mgmt and DDI components from the json Signed-off-by: Denislav Prinov <denislav.prinov@bosch.com> --------- Signed-off-by: Denislav Prinov <denislav.prinov@bosch.com>
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 JQ: see installing jq documentation on how to install jq.
- Install NODE.js and npm see installing Node.js and npm documentation on how to install Node.js and npm
- Install Redocly CLI see installing Redocly CLI documentation on how to install Redocly CLI
- Install hawkBit: run
mvn installin 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 tocontent/rest-api/and ii. downloads the required Hugo theme -
mvn site: Serve the documentation on localhost:1313/hawkbit/Note: the local port could be different. Please, look at the mvn site command output.
-
mvn clean: Delete generated artifacts (REST docs, Hugo theme)
Generate /public folder
In order to generate the /public folder, which can be put on a web-server, run the following command:
$ hugo