HtmGem, installation

To run HtmGem — after having copied the files — there is nothing to do but to add the URL rewriting rules.

Prerequisites

• Php v7.3 minimum
• Module php-mbstring to manage unicode
• A web server (Apache and Nginx tested)
• Module mod-rewrite to handle the Gemini pages

Installation

Download

Stable version

Project repository

Nginx

# This text must be placed in the server's configuration
index index.gmi index.php index.html
rewrite ^(.+\.gmi)$ htmgem/index.php?rw=1&url=$1;

Apache

# This text can be placed at the root of the web site in a file ".htaccess".
DirectoryIndex index.gmi index.php index.html
RewriteEngine on
RewriteRule ^(.+\.gmi)$ htmgem/index.php?rw=1&url=$1

Afterwards,

• When a file ends by .gmi. is asked, HtmGem will display it in the browser.
• When only the directory is asked (http:/​/site.tld/path) the file index.gmi will be automatically choosen.

How to build GemText pages?

Advanced configuration

Add additional styles as a link parameter or adapt the text decoration:

Advanced configuration