@hello2dj/html-template NPM

HTML template for the AsyncAPI Generator using an AsyncAPI React Component under the hood.

npm

Usage

ag asyncapi.yaml @asyncapi/html-template -o output

If you don't have the AsyncAPI Generator installed, you can install it like this:

npm install -g @asyncapi/generator

Supported parameters

Name	Description	Required	Default	Allowed values	Example
sidebarOrganization	Defines how the sidebar should be organized. Set its value to `byTagsNoRoot` to categorize operations by operations tags. Set its value to `byTags` when you have tags on a root level. These tags are used to model tags navigation and need to have the same tags in operations.	No	undefined	`byTags`, `byTagsNoRoot`	`byTagsNoRoot`
baseHref	Sets the base URL for links and forms.	No	`/`	Any	`/docs`
version	Override the version of your application provided under `info.version` location in the specification file.	No	Version is taken from the spec file.	Any (See Semver versionning)	`1.0.0`
singleFile	Set output into one html-file with styles and scripts inside	No	`false`	`true`,`false`	`true`
outFilename	The filename of the output file.	No	`index.html`	Any	`asyncapi.html`

Development

The HTML-Template is built with an AsyncAPI React Component. For any changes regarding the styling of the page, rendering of the missing/existing elements, please contribute to the AsyncAPI React Component repository.

If you want make changes in template itself, please follow:

Make sure you have the latest generator installed: npm install -g @asyncapi/generator.
Modify the template or its helper functions.
NOTE: If you have to modify the dummy.yml file to develop your features, open a PR with the changes in the asyncapi/generator repository.
Generate output with watcher enabled: npm run develop.
NOTE: If your changes are not visible, this is maybe because the ag use the already installed html-template so you should use the --install option
- run npm run develop:install
- if command failed, delete the cached html-template module in your system and re-rerun the command
Open HTML in your browser: open ./test/output/index.html.

Contributors ✨

Thanks goes to these wonderful people (emoji key):

This project follows the all-contributors specification. Contributions of any kind welcome!

asyncapi generator html template

@asyncapi/parser @asyncapi/react-component highlight.js react react-dom rimraf

@everything-registry/sub-chunk-391 @infinitebrahmanuniverse/nolb-_hel @zalastax/nolb-_hel

0.24.10

2 years ago