https://github.com/laurentrdc/pandoc-plot
Render and include figures in Pandoc documents using your plotting toolkit of choice
https://github.com/laurentrdc/pandoc-plot
ggplot2 gnuplot mathematica matlab matplotlib octave pandoc pandoc-filter pandoc-filters plantuml plotly plotly-python plotting plotting-toolkits
Last synced: 15 days ago
JSON representation
Render and include figures in Pandoc documents using your plotting toolkit of choice
- Host: GitHub
- URL: https://github.com/laurentrdc/pandoc-plot
- Owner: LaurentRDC
- License: gpl-2.0
- Created: 2019-11-09T18:32:42.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-09-27T18:35:32.000Z (7 months ago)
- Last Synced: 2024-10-25T04:24:57.895Z (6 months ago)
- Topics: ggplot2, gnuplot, mathematica, matlab, matplotlib, octave, pandoc, pandoc-filter, pandoc-filters, plantuml, plotly, plotly-python, plotting, plotting-toolkits
- Language: Haskell
- Homepage: https://laurentrdc.github.io/pandoc-plot/
- Size: 2.25 MB
- Stars: 226
- Watchers: 9
- Forks: 8
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# pandoc-plot
## A Pandoc filter to generate figures from code blocks in documents
[](https://www.gnu.org/licenses/gpl.html)
`pandoc-plot` turns code blocks present in your documents (Markdown, LaTeX, etc.) into embedded figures, using your plotting toolkit of choice, including Matplotlib, ggplot2, MATLAB, Mathematica, and more.
## Overview
This program is a [Pandoc](https://pandoc.org/) filter. It can therefore
be used in the middle of conversion from input format to output format,
replacing code blocks with figures.
The filter recognizes code blocks with classes that match plotting
toolkits. For example, using the `matplotlib` toolkit:
```` markdown
# My document
This is a paragraph.
```{.matplotlib}
import matplotlib.pyplot as plt
plt.figure()
plt.plot([0,1,2,3,4], [1,2,3,4,5])
plt.title('This is an example figure')
```
````
Putting the above in `input.md`, we can then generate the plot and embed
it in an HTML page:
``` bash
pandoc --filter pandoc-plot input.md --output output.html
```
The resulting `output.html` looks like this:
```html
My document
This is a paragraph.
```
## Supported toolkits
`pandoc-plot` currently supports the following plotting toolkits
(**installed separately**):
- `matplotlib`: plots using the [matplotlib](https://matplotlib.org/)
Python library;
- `plotly_python` : plots using the
[plotly](https://plotly.com/python/) Python library;
- `plotly_r`: plots using the [plotly](https://plotly.com/r/) R
library
- `matlabplot`: plots using [MATLAB](https://www.mathworks.com/);
- `mathplot` : plots using
[Mathematica](https://www.wolfram.com/mathematica/);
- `octaveplot`: plots using [GNU
Octave](https://www.gnu.org/software/octave/);
- `ggplot2`: plots using [ggplot2](https://ggplot2.tidyverse.org/);
- `gnuplot`: plots using [gnuplot](http://www.gnuplot.info/);
- `graphviz`: graphs using [Graphviz](http://graphviz.org/);
- `bokeh`: plots using the [Bokeh](https://bokeh.org/) visualization library;
- `plotsjl`: plots using the [Julia `Plots.jl`](https://docs.juliaplots.org/latest/) package;
- `plantuml`: diagrams using the [PlantUML](https://plantuml.com/) software suite;
- `sageplot`: plots using the [Sage](https://www.sagemath.org/) software system;
- `d2`: plots using [D2](https://d2lang.com/);
- `asymptote`: plots using [Asymptote](https://asymptote.sourceforge.io/).
To know which toolkits are useable on *your machine* (and which ones are
not available), you can check with the `toolkits` command:
``` bash
pandoc-plot toolkits
```
**Wish your plotting toolkit of choice was available? Please [raise an
issue](https://github.com/LaurentRDC/pandoc-plot/issues)\!**
## Documentation
You can find more information in the documentation, available either in the
source repository file `MANUAL.md`, on the [webpage](https://laurentrdc.github.io/pandoc-plot/MANUAL.html), or via the command `pandoc-plot --manual`.
## Installation
### Binaries and Installers
[](https://github.com/LaurentRDC/pandoc-plot/releases)
Windows, Linux, and Mac OS binaries are available on the [GitHub release
page](https://github.com/LaurentRDC/pandoc-plot/releases). There are
also Windows installers.
### conda
[](https://anaconda.org/conda-forge/pandoc-plot)
Like `pandoc`, `pandoc-plot` is available as a package installable with
[`conda`](https://docs.conda.io/en/latest/). [Click here to see the
package page](https://anaconda.org/conda-forge/pandoc-plot).
To install in the current environment:
``` sh
conda install -c conda-forge pandoc-plot
```
### Homebrew
[](https://formulae.brew.sh/formula/pandoc-plot)
`pandoc-plot` is available as a package via [`Homebrew`](https://brew.sh/). [Click here to see the package page](https://formulae.brew.sh/formula/pandoc-plot#default).
To install:
```sh
brew install pandoc-plot
```
### winget
You can install `pandoc-plot` from the [Windows Package
Manager](https://github.com/microsoft/winget-cli) `winget` (just like
`pandoc`). To install:
``` sh
winget install pandoc-plot
```
### From Hackage/Stackage
[](http://hackage.haskell.org/package/pandoc-plot)
`pandoc-plot` is available on
[Hackage](http://hackage.haskell.org/package/pandoc-plot) and
[Stackage](https://www.stackage.org/nightly/package/pandoc-plot). Using
the [`cabal-install`](https://www.haskell.org/cabal/) tool:
``` bash
cabal update
cabal install
```
### From source
Building from source can be done using [`cabal`](https://www.haskell.org/cabal/):
``` bash
git clone https://github.com/LaurentRDC/pandoc-plot
cd pandoc-plot
cabal install # Alternatively, `stack install`
```