|0.3.0||Oct 3, 2022|
|0.2.4||Mar 5, 2022|
|0.2.3||Dec 11, 2021|
|0.2.2||Sep 28, 2021|
|0.1.1||Sep 28, 2021|
#685 in Text processing
31 downloads per month
svgbob preprocessor for mdbook
A preprocessor for mdbook to convert
svgbob codeblocks into nice SVG images using
This crate serves as an alternative to mdbook-svgbob which was a big inspiration while writing the code for this crate.
The reason why I created this was that the original uses outdated dependencies and seems to break tables some reason, and it requires the source to have Unix line endings as it breaks with Windows line endings. I also wanted to learn how to write mdbook preprocessors and had a usecase for an updated svgbob integration.
Install with cargo:
cargo install mdbook-svgbob2
Or to install from the git mirror:
cargo install --git https://github.com/matthiasbeyer/mdbook-svgbob2.git
Add this to your cargo.toml:
Optionally add any arguments for the svgbob settings:
[preprocessor.svgbob2] font_size = "14" font_family = "monospace" fill_color = "black" background = "transparent" stroke_color = "var(--fg)" # variable from the mdbook css files stroke_width = "2.0" scale = "8.0" enhance_circuitries = "true" include_backdrop = "true" include_styles = "true" include_defs = "true" merge_line_with_shapes = "false" # this is a non-svgbob custom setting font_color = "var(--fg)"
The above are the default settings. Most of them are the svgbob defaults, with
the exception of
stroke_color which have been changed to
better fit mdbook.
svgbob currently does not support changing the font color (although there are feature requests for this to be added), and because a pure black font color doesn't work well with different mdbook themes, the ability to change the font color was added.
svgbob codeblocks in some chapter:
```svgbob .---. /-o-/-- .-/ / /-> ( * \/ '-. \ \ / ' ```
and it should display as a nicely rendered svg when rendered with mdbook.