groff-web

Description

Minimal groff web frontend

Installation

Dependencies:

apt install -y groff-base grap nginx php-fpm

Download and extract files. Then, copy web root and set up permissions to www-data user so PDFs can be generated.

wget "https://gitlab.com/tavo-wasd/groff-web/-/archive/main/groff-web-main.tar.gz"
tar -xvf groff-web-main.tar.gz
cp -r groff-web-main/public /var/www/groff-web
chown -R www-data:www-data /var/www/groff-web

nginx setup.

cp groff-web-main/nginx.conf /etc/nginx/sites-available/groff-web.conf
sed -i 's/groff.example.org/MY.DOMAIN.COM/' /etc/nginx/sites-available/groff-web.conf
ln -s /etc/nginx/sites-available/groff-web.conf /etc/nginx/sites-enabled
systemctl reload nginx

Configuration

These are included in the public/compiler.sh file, the binaries' PATH can be modified in case you want to compile groff from source, for example. As for the preprocessors, grap isn't installed by default in most systems, so you might want to remove the G, also chem gives me a bit of trouble when used with eqn.

SOELIM="/usr/bin/soelim" # soelim PATH
REFER="/usr/bin/refer"   # refer PATH
GROFF="/usr/bin/groff"   # groff PATH
PRE="-ketpG"             # Preprocessors

These are not set, but you can set them if you want a directory with macros, or a custom bibliography file.

BIB="bibliography" # Bibliography file
MAC="macros"       # Macros dir

License

GPL v3.0