HTML template for the AsyncAPI Generator

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`
pdf	Generates output HTML as PDF	No	`false`	`true,false`	`false`

If you only generate an html website, set the environment variable PUPPETEER_SKIP_CHROMIUM_DOWNLOAD to true and the generator will skip downloading chromium.

Development

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.
Adjust styling and generate tailwind.min.css with npm run generate:assets
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):

_{James Crowley} 💻 🐛	_{Waleed Ashraf} 💻 🐛	_{Julian Rabe} 💻	_Sebastián ⚠️ 💻	_{Gordeev Artem} 💻	_{Mitchell Sawatzky} 💻	_{Talmiz Ahmed} 💻
_{Jürgen B.} 🚇	_{Gabriel Claudino} 💻	_{Barbara Szwarc} 📖	_{Julian S.} 💻	_{Ludovic Dussart} 💻