herbrant / i.upmath.me

Upmath LaTeX Renderer

Upmath LaTeX Renderer

Service for generating nice SVG pictures from LaTeX equations for web. You can try it in action in the Markdown and LaTeX online editor.

Requirements

1. TeX Live. I prefer a full installation and disabling write18 support.
2. nginx web server with ngx_http_lua_module (for example, nginx-extras Debian package).
3. php-fpm. proc_open() function must be enabled.
   • Add the TeX bin directory (e.g. /home/tex/tl-2020/bin/x86_64-linux) to the PHP PATH environment variable. Otherwise there can be floating bugs when generating font files.
   • Make the /home/tex/tl-2020/texmf-var dir writable for the php-fpm process user.
4. Node.js and frontend tools: npm, bower, grunt-cli.
5. ghostscript (used internally by dvisvgm TeX component).
6. Utilities: rsvg-convert, optipng, pngout. Install them or modify the code to disable PNG support.

Installation

Deploy files:

git clone [email protected]:parpalak/i.upmath.me.git
cd i.upmath.me
yarn install
composer install
bower install
grunt

Create the site config file:

cp config.php.dist config.php
mcedit config.php # specify the LaTeX bin dir and other paths

Set up the host:

sudo cp nginx.conf.dist /etc/nginx/sites-available/i.upmath.me
sudo mcedit /etc/nginx/sites-available/i.upmath.me

Set up systemd unit for SVGO http service:

sudo cp http-svgo.service.dist /etc/systemd/system/http-svgo.service
sed -i "s~@@DIR@@~$PWD~g" /etc/systemd/system/http-svgo.service
sudo systemctl start http-svgo
sudo systemctl enable http-svgo

Docker

You can run the project using docker. The docker image is built automatically after a push to the main branch using the github actions.

You can run it with

docker run -t -p 8080:80 ghcr.io/parpalak/upmath.me:master

You will find the service active at localhost:8080.