]> sipb.mit.edu Git - ikiwiki.git/blob - doc/plugins/teximg.mdwn
Merge remote-tracking branch 'spalax/paternal/upload-svg'
[ikiwiki.git] / doc / plugins / teximg.mdwn
1 [[!template id=plugin name=teximg author="[[PatrickWinnertz]]"]]
2 [[!tag type/widget type/slow]]
3
4 This plugin provides a [[ikiwiki/directive/teximg]] [[ikiwiki/directive]],
5 that renders LaTeX formulas into images.
6
7 You will need LaTeX installed for this to work, specifically something
8 providing `latex` in the path. You will also need either `dvipng` or a
9 combination of `dvips` and `convert` from ImageMagick/GraphicsMagick.
10
11 On Debian systems, the relevant package names are `texlive-latex-base`
12 and either `dvipng` or `graphicsmagick-imagemagick-compat`.
13
14 ## configuration
15
16 There are several configuration directives that can be used in the setup
17 file. `teximg_prefix` can be set to change the LaTeX preamble, and
18 `teximg_postfix` to change the LaTeX postfix. The `teximg_dvipng` setting
19 can be set to 0 to disable use of `dvipng`, and instead force use of `dvips`
20 and `convert`.