https://github.com/iblech/latex2png
A short shell script to compile LaTeX sources to cropped PNG images
https://github.com/iblech/latex2png
Last synced: 4 months ago
JSON representation
A short shell script to compile LaTeX sources to cropped PNG images
- Host: GitHub
- URL: https://github.com/iblech/latex2png
- Owner: iblech
- Created: 2016-06-14T11:52:35.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2018-06-12T11:16:51.000Z (about 7 years ago)
- Last Synced: 2025-01-13T05:42:09.594Z (5 months ago)
- Language: Shell
- Size: 3.91 KB
- Stars: 2
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# latex2png
A short shell script to compile LaTeX sources to cropped PNG images.
## Usage
```shell
# one-shot mode:
latex2png foo.tex
# or continuously regenerate the PNG images upon any changes to any .tex file
# in directory foo/
latex2png foo
```
The LaTeX source files can either be normal source files containing a proper
header, or alternatively just contain a single block of commands (which are
then rendered in a math environment).
## Dependencies
* `pdflatex`, `pdfcrop`, and `pdftoppm`. These programs are usually contained
in packages with names like `texlive-latex-base`, `texlive-extra-utils`, and
`poppler-utils`, respectively.
* Optionally `inotifywait` from a package like `inotify-tools`.
## Security considerations
Don't run `latex2png` on untrusted files.
## In connection with remote filesystems
Some filesystems don't generate inotify events. In this case you should
manually specify the checking interval when using latex2png in continuous mode:
```shell
LATEX2PNG_INTERVAL=60 latex2png foo # check every 60 seconds
```
## License
To the extent that this shell script exceeds a basic threshold of originality,
it is dual-licensed, meaning that you can (and are invited to) use,
redistribute and modify it under the terms of either:
1. The GNU General Public License (GPL), version 3 or (at your option) any
later version published by the Free Software Foundation.
2. The LaTeX Project Public License (LPPL), version 1.3c or (at your option)
any later version published by the LaTeX3 project.