math-svg: A Plugin for Pelican

License

Render math expressions to svg and embed them.

Installation

This plugin can be installed via:

python -m pip install pelican-math-svg

Requirements

required LaTeX tools (all included in TeX Live and possibly other LaTeX distributions):
- lualatex (or another LaTeX compiler if changed in the settings, see below)
- pdfcrop
- dvisvgm
scour (optional)
svgo (optional)

Usage

In Markdown you can use $x$ for inline math and

$$
  \int x^2
$$

for display math.

It is required to set the stroke color using the strokeonly class (this class name can be changed, see configuration options below), otherwise lines would be rendered white:

svg path.strokeonly {
    color: #000;
}

To change the fill color for equations as well, thus essential changing the default color for math, specify the following additionally:

span.math svg path,
div.math svg path {
    fill: #000;
}

Configuration

In your pelicanconf.py you can use the following options to tweak the behavior of the plugin:

Setting	Description	Default Value
`MATH_SVG["titles"]	Whether to generate `<title>` tags containing the raw LaTeX code (recommended for accessibility).	`True`
`MATH_SVG["scale_inline"]`	scaling factor for inline math	`1.0`
`MATH_SVG["scale_display"]`	scaling factor for display math	`1.0`
`MATH_SVG["strokeonly_class]`	CSS class for SVG paths that have no filling and a black stroke color, useful when changing the color of rendered equations	`strokeonly`
`MATH_SVG["latex"]["args"]`	CLI arguments of the invoked LaTeX compiler	`"--interaction=errorstopmode", "--halt-on-error"`
`MATH_SVG["latex"]["preamble"]`	preamble of the generated LaTeX document	`[r"\documentclass[preview,border={2pt 0pt}]{standalone}",r"\usepackage{amsmath}",r"\usepackage{amssymb}",]`
`MATH_SVG["latex"]["program"]`	LaTeX compiler to use	`lualatex`
`MATH_SVG["pdfcrop"]["args"]`	CLI arguments for `pdfcrop`	`--hires`
`MATH_SVG["dvisvgm"]["args"]`	CLI arguments for `dvisvgm`	`["--pdf", "--optimize=all", "--no-fonts", "--exact-bbox"]`
`MATH_SVG["scour"]["args"]`	CLI arguments for `scour`	`["--strip-xml-prolog", "--remove-descriptions", "--remove-metadata", "--enable-comment-stripping", "--strip-xml-space", "--enable-id-stripping",]`
`MATH_SVG["scour"]["enabled"]`	whether to use `scour` to optimize SVG output	`True` if `scour` is in `$PATH`, `False` otherwise
`MATH_SVG["svgo"]["args"]`	CLI arguments for `svgo`	`["--multipass", "--precision", "5"]`
`MATH_SVG["svgo"]["enabled"]`	whether to use `svgo` to optimize SVG output	`True` if `svgo` is in `$PATH`, `False` otherwise

Contributing

Contributions are welcome and much appreciated. Every little bit helps. You can contribute by improving the documentation, adding missing features, and fixing bugs. You can also help out by reviewing and commenting on existing issues.

To start contributing to this plugin, review the Contributing to Pelican documentation, beginning with the Contributing Code section.

License

This project is licensed under the GPLv3 license.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pelican-math-svg-0.7.2.tar.gz (20.9 kB view details)

Uploaded Aug 23, 2021 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

pelican_math_svg-0.7.2-py3-none-any.whl (21.5 kB view details)

Uploaded Aug 23, 2021 Python 3

File details

Details for the file pelican-math-svg-0.7.2.tar.gz.

File metadata

Download URL: pelican-math-svg-0.7.2.tar.gz
Upload date: Aug 23, 2021
Size: 20.9 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: poetry/1.1.8 CPython/3.7.11 Linux/5.8.0-1039-azure

File hashes

Hashes for pelican-math-svg-0.7.2.tar.gz
Algorithm	Hash digest
SHA256	`c3ff462f34615b15c35bde631d1689a632d947ea0dd43917530211e3c2d0eee5`
MD5	`8c79f82b07ae654fbb9f8d30aa334101`
BLAKE2b-256	`e60430b648faaf40a798c477591b8097ae7795bf8ffa2298fe19c951a978b291`

See more details on using hashes here.

File details

Details for the file pelican_math_svg-0.7.2-py3-none-any.whl.

File metadata

Download URL: pelican_math_svg-0.7.2-py3-none-any.whl
Upload date: Aug 23, 2021
Size: 21.5 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: poetry/1.1.8 CPython/3.7.11 Linux/5.8.0-1039-azure

File hashes

Hashes for pelican_math_svg-0.7.2-py3-none-any.whl
Algorithm	Hash digest
SHA256	`d1824ed48a6440ab96019070dc09ab91b0cced8a28148be0dea0571fd2c3440f`
MD5	`3b4e58a5ccaaec2c528cbbe0df866c67`
BLAKE2b-256	`c67a4d226dfcf417c3369e0750f2ad9908e6ae5db1bf293d1cb2d5fe955c9802`