svgbob extension for Python Markdown
Project description
markdown-svgbob
This is an extension for Python Markdown which renders diagrams using svgbob.
You can try it out using the Svgbob Editor.
Project/Repo:
Code Quality/CI:
Name | role | since | until |
---|---|---|---|
Manuel Barkhau (mbarkhau@gmail.com) | author/maintainer | 2019-04 | - |
Install
$ pip install markdown-svgbob
This package includes the following binaries:
svgbob_0.4.1_x86_64-Darwin
svgbob_0.4.1_x86_64-Linux
svgbob_0.4.1_x86_64-Windows
If you are on another platform, or want to use a more recent version of svgbob_cli
, you will need to install rust and then svgbob via cargo.
$ curl https://sh.rustup.rs -sSf | sh # see https://rustup.rs/
$ cargo install svgbob_cli
This extension will always use the installed version of svgbob if it is available.
Usage
In your markdown text you can define the block:
```bob
.---.
/-o-/--
.-/ / /->
( * \/
'-. \
\ /
'
```
The info string bob
is chosen to match spongedown.
Development/Testing
$ git clone https://gitlab.com/mbarkhau/markdown-svgbob
$ cd markdown-svgbob
$ make install
$ make lint mypy test
MkDocs Integration
In your mkdocs.yml
add this to markdown_extensions.
markdown_extensions:
- markdown_svgbob:
tag_type: inline_svg
bg_color: white
fg_color: black
min_char_width: 80
Valid options for tag_type
are inline_svg
(the default), img_utf8_svg
and img_base64_svg
.
The option min_char_width
allows you to create diagrams of a uniform scale.
Changelog for https://gitlab.com/mbarkhau/markdown-svgbob
v202001.0013-beta
- Fix #2: Ignore trailing whitespace after closing fence.
v202001.0012-beta
- Add:
min_char_width
option. Allows diagrams in a document to have a uniform scale.
v202001.0011-beta
- Fix: Bad image substitution when markdown has multiple diagrams
v202001.0009-beta
- Fix: Bad parsing of fences
v201907.0008-beta
- Fix: use PEP 508 environment marker to not always install the
typing
package. Fixes gitlab#1
v201905.0007-beta
- Add: bg_color and fg_color options
v201905.0006-beta
- Fix: better error reporting
- Fix: cleanup temp dir
v201904.0004-beta
- Initial release
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
Hashes for markdown-svgbob-202001.13b0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | d003cbc9636aec8c2f6061e8afd2d0f73ed1e90804b75c58e4aade02566649e2 |
|
MD5 | 4b8f0bfb836a620ba1b8c00569fbeaa5 |
|
BLAKE2b-256 | c9d36fd023d9acbcff94910fdeb625f101120bedef7b3c5c2364caf19e616795 |
Hashes for markdown_svgbob-202001.13b0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | bdce91e7c60f23733d4d867dc28a8b8a8a6fd8ede5041e9c73b881075b679633 |
|
MD5 | 6dd0cb1d674b1b19a7681469aad513e9 |
|
BLAKE2b-256 | 1ca410821397cf821808066b0699d9154dca24669827a9d02afd0aee72477afe |