Skip to main content

This is a mkdocs plugin, this could enable the wavedrom charts in the markdown file.Please follow the 'how to' section in reame to enable this plugin

mkdocs-wavedrom-plugin

A MkDocs plugin,
render waveform charts in the wavedrom style.

Installation

Install this package with pip.

from PyPi

pip install mkdocs-wavedrom-plugin

from github

pip install git+https://github.com/kuri65536/mkdocs-mkdocs-plugin

How to use

More information about plugins in the MkDocs documentation

write markdown/wavedrom code

embed your wavedrom code in markdown documents.

```wavedrom
{ signal: [{ name: 'Alfa', wave: '01.zx=ud.23.45' }] }
```

or see a sample markdown for the sample.

setup mkdocs.yml

change mkdocs.yml to use this plugin.

site_name: test
plugins:
    - markdownwavedrom

extra_javascript:
    # - wavedrom.unpkg.js
    # - skin-default.js
    # above, place *.js in docs directory, or below from internet.
    - https://cdn.jsdelivr.net/npm/wavedrom@2.1.2/wavedrom.unpkg.js
    - https://wavedrom.com/skins/default.js

Demo

see sample a test.html result

image

test image

from local

$ python -m venv env
$ ./env/bin/python setup.py install
$ ./env/bin/mkdocs build
$ ./env/bin/mkdocs serve &
$ browse http://localhost:8000/test/index.html

or make build and browse site/test/index.html, if you have make binary.

(optional) download wavedrom

to download javascript files to local

$ make download

Thanks

a lot part of this plugin
were came from mkdocs-mermaid-plugin

Metadata

Release files for mkdocs-wavedrom-plugin 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mkdocs-wavedrom-plugin 0.1.1
File Size Uploaded
mkdocs-wavedrom-plugin-0.1.1.tar.gz 3.2 kB Details

Built distributions (wheels)

Table of built distributions (wheels) for mkdocs-wavedrom-plugin 0.1.1
File Interpreter ABI Platform
mkdocs_wavedrom_plugin-0.1.1-py3-none-any.whl Python 3 none any Details
mkdocs_wavedrom_plugin-0.1.1-py2-none-any.whl Python 2 none any Details

Total release size: 21.4 kB

Release files / mkdocs-wavedrom-plugin-0.1.1.tar.gz

Download URL mkdocs-wavedrom-plugin-0.1.1.tar.gz
Size 3.2 kB
Tags Source
SHA-256 checksum
How to use checksums
2662f42b2282ab1ed01c1173be0b4d56683a4e813d813b1e7eca99954beb6dac
BLAKE2b-256 checksum
How to use checksums
44f1bd7709fcc233b1f2aa6e998366886d24788385264e27b8e2de7790eb94c1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.32.2 CPython/3.6.8

Release files / mkdocs_wavedrom_plugin-0.1.1-py3-none-any.whl

Download URL mkdocs_wavedrom_plugin-0.1.1-py3-none-any.whl
Size 9.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
6fc5502c12a6367a52eba398af98f44d70cdfb271a4d181bda6b9f12d6426e2a
BLAKE2b-256 checksum
How to use checksums
3a32e0240559bcf9bf73c29f321ee5e7aee195a6a7503e1bb9939ce95042ccf0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.32.2 CPython/3.6.8

Release files / mkdocs_wavedrom_plugin-0.1.1-py2-none-any.whl

Download URL mkdocs_wavedrom_plugin-0.1.1-py2-none-any.whl
Size 9.1 kB
Tags Python 2
SHA-256 checksum
How to use checksums
dc1ad1676314f07ab1cb988b265bc21f0a28b8590d72806dda395b580cb5e45e
BLAKE2b-256 checksum
How to use checksums
3d7b90e4cfbf22e06c43c991b11133e256222ebb755eca98eb7cd30a48a59faa
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.32.2 CPython/3.6.8

Release history Release notifications | RSS feed

This release

0.1.1 This release

3 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page