MkDocs plugin to embed AsyncAPI HTML viewer in your markdown file.
Project description
mkdocs-asyncapi-plugin
This plugin helps to render AsycnAPI schema in your mkdocs markdown page. It uses AsyncAPI Standalone react component to render your asyncapi schema file.
Supports both .json and .yml files. Simply use the tag:
<asyncapi-tag src="/path/to/schema.json"/>
In addition to the src
attribute following attributes work with the tag.
|Action|Atrribute|Accepted values|
|---|---|---|---|
| Show or hide | sidebar
| true
or false
|
| Show or hide | info
| true
or false
|
| Show or hide | servers
| true
or false
|
| Show or hide | operations
| true
or false
|
| Show or hide | messages
| true
or false
|
| Show or hide | schemas
| true
or false
|
| Show or hide | errors
| true
or false
|
| expand or collapse | messageExamples
| true
or false
|
| sidebar configuration| showServers
| byDefault
or bySpecTags
or byServersTags
|
| sidebar configuration| showOperations
| byDefault
or bySpecTags
or byServersTags
|
| asyncapi parser configuration | parserOptions
| See available options here |
| label customization | publishLabel
| Any string value |
| label customization | subscribeLabel
| Any string value |
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file mkdocs-asyncapi-tag-plugin-0.1.0.tar.gz
.
File metadata
- Download URL: mkdocs-asyncapi-tag-plugin-0.1.0.tar.gz
- Upload date:
- Size: 5.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.8.8
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 68bea2ddea38acec62aa315c9b7268a7fb833cc4f83c137d533000ef87769c96 |
|
MD5 | ffeb45e7d139969a931dd362536df9bc |
|
BLAKE2b-256 | 73743d3ff73db26de055fe4a9c191da9026730137aed03dbe9e497fe67365f33 |
File details
Details for the file mkdocs_asyncapi_tag_plugin-0.1.0-py3-none-any.whl
.
File metadata
- Download URL: mkdocs_asyncapi_tag_plugin-0.1.0-py3-none-any.whl
- Upload date:
- Size: 6.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.8.8
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | d4303f386ae74893f88f5a392fd436b02bd4daf53ef845b7dec6029e0bfeda68 |
|
MD5 | 96f8cf9b49ee020928c365490ff0b92a |
|
BLAKE2b-256 | 66d97e2f1cd9b692fe344b2f8678af07e08b91d8c8d4f0cfc53d0e01865379b2 |