# Pour installer HtmGem

* Télécharger HtmGem
=> https://tildegit.org/sbgodin/HtmGem/archive/master.zip
* Copier les fichiers à la racine du site.
* Configurer la réécriture d’URL (//URL Rewriting//).
* Écrire du texte dans /index.gmi.
* Ouvrir la page du site!

* Accéder à /htmgem pour la documentation.

## Prérequis

* Php v7.3 minimum
* Module **Php-mbstring** pour gérer l’unicode
* Un serveur web (Apache et Nginx supportés)
* Module **mod-rewrite** pour la réécriture d’URL

### 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
```

Autres styles disponibles :
* style=lagrange,lagrange.css
* style=lagrange,lagrange_gray.css
* style=default,circumlunar.css
* etc…

## Décoration du texte

La décoration du texte, qui interprête le **gras** par exemple, ne fait pas partie de la définition de GemText. La décoration du texte s’applique partout sauf sur les titres et blocs préformatés.

On peut désactiver la décoration du texte avec une ligne **^^^** ou ajouter à la **réécriture** d’URL :
> &textDecoration=0


=> ../css Styles

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