💾 Archived View for gmi.sbgodin.fr › htmgem › docs › installation-en.gmi captured on 2023-07-22 at 16:24:23. Gemini links have been rewritten to link to archived content

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

To install HtmGem

Download HtmGem

https://tildegit.org/sbgodin/HtmGem/archive/master.zip

Copy the files at the root of the website.
Configurer la réécriture d’URL (//URL Rewriting//).
Write some text in /index.gmi.
Just open your website!

Go to /htmgem to get the documentation.

Prerequisites

Php v7.3 minimum
Module **Php-mbstring** to handle l’unicode
A web server (Apache and Nginx supported)
Module **mod-rewrite** for the URL rewriting

Nginx

index index.gmi index.php index.html
rewrite ^(.+\.gmi)$ /htmgem/index.php?rw=1&url=$1&style=default,htmgem.css;
error_page 403 /htmgem;
location = /favicon.ico { alias /var/www/dev/htmgem/favicon.ico; }

Apache

DirectoryIndex index.gmi index.php index.html
RewriteEngine on
RewriteRule ^(.+\.gmi)$ htmgem/index.php?rw=1&url=$1&style=default,htmgem.css

Other available styles:

style=lagrange,lagrange.css
style=lagrange,lagrange_gray.css
style=default,circumlunar.css
etc…

Text decoration

The text decoration, which interprets the bold for instance, is not part of GemText definition. The text decoration applies everywhere except on the titles and preformated texts.

It's possible to disable the text decoration with a line **^^^** or add to the URL rewriting:

&textDecoration=0

Styles

How to make GemText pages?