💾 Archived View for gmi.sbgodin.fr › htmgem › docs › installation-en.gmi captured on 2022-03-01 at 15:15:21. Gemini links have been rewritten to link to archived content

-=-=-=-=-=-=-

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