This plugin adds functionality to mdbook for scientific application.
It allows the writer to generate named LaTeX, named Gnuplots and supports bibtex files. Further cross-referencing in text to equation, figures or literature is possible. A sample output can be seen here.
Compile this crate and add the mdbook-scientific to your search path. Also bib2xhtml is required if you want to generate a bibliography. Then add the following to your book.toml:
```toml [preprocessor.scientific] renderer = ["html"]
bibliography = "literature.bib" bib2xhtml = "/home/lorenz/Documents/tmp/bib2xhtml/"
assets = "src/"
[output.html] additional-css = ["src/scientific.css"] ```
latex and dvisvgmgnuplotFor block equation rendering use the following syntax
md
$$equation, <name>
...
$$
the equation identifier is only needed if you want to name the equation block. You can cross-reference it then with $ref:equ:<name>$ in the whole mdbook.
The same syntax is working with latex and gnuplot figures, both are requiring a subtitle for the plot. Further a gnuplotonly figure only uses Gnuplot to render the file to SVG.
Example for gnuplot rendering
md
$$gnuplot, <name>, <subtitle>
...
$$
and then cross-reference with $ref:fig:<name>$.
If block is empty, then the preprocessor looks into the assets path specified in the configuration. So for a block $$latex, legendrepoly, Legendre Polynomials$$ it looks for the file src/legendrepoly.tex.
The BibTeX file referenced in the configuration file is added as a additional chapter and citations can be generated with $ref:bib:<name>$.
Proof of concept, with the following outstanding urgent todos for practical viability:
$ signs in code blocks