# HtmGem, installation

Pour faire fonctionner HtmGem — après avoir copié les fichiers — il ne reste qu’à ajouter une règle de ré-écriture d’URL (//URL Rewriting//).

## Prérequis

* Php v7.3 minimum
* Module **Php-mbstring** pour gérer l’unicode
* Un serveur web (Apache et Nginx testés)
* Module **mod-rewrite** pour lire les pages Gemini

## Installation

### Téléchargement
=> https://tildegit.org/sbgodin/HtmGem/archive/master.zip Version stable
=> https://tildegit.org/Sbgodin/htmgem Dépôt du projet

### Nginx
```
# Ce texte doit être placé dans la configuration du serveur.
index index.php index.gmi index.html
rewrite ^(.+\.gmi)$ htmgem/?url=$1;
```

### Apache
```
# Ce texte peut se placer à la racine du site dans un fichier ".htaccess".
DirectoryIndex index.php index.gmi index.html
RewriteEngine on
RewriteRule ^(.+\.gmi)$ htmgem/?url=$1
```

Par la suite,
* Quand un fichier se terminant par **.gmi** sera demandé, HtmGem l’affichera dans le navigateur.
* Quand seul le répertoire sera demandé (http:/​/site.tld/path) le fichier //index.gmi// sera automatiquement choisi.

=> tutogemtext-fr.gmi Comment faire des pages GemText ?

## Configuration avancée

Ajoutez des styles supplémentaires en paramètre de lien ou adaptez la décoration du texte :
=> configuration-fr.gmi Configuration avancée