Improves the presentation of HtmGem

This commit is contained in:
Christophe HENRY 2021-03-10 10:47:40 +01:00
parent 799b34c536
commit db12ae5856
1 changed files with 26 additions and 4 deletions

View File

@ -1,8 +1,29 @@
# HtmGem, voir Gemini à travers HTTP # HtmGem, voir Gemini à travers HTTP
Ceci est la page dinstallation et de présentation d**HtmGem**. Ceci est la page dinstallation et de présentation d**HtmGem**.
=> tests/tutogemtext.gmi Cliquez ici pour voir le tutoriel pour écrire des pages Gemini.
Pour faire fonctionner HtmGem, il ne reste quà ajouter une règle de ré-écriture dURL (//URL Rewriting//). Si vous pouvez lire ce texte en ayant demandé //htmgem.php// avec le navigateur, il ne reste que cette dernière étape à franchir 😄 HtmGem permet dhéberger des pages Gemini et de les publier sur le web. À louverture dune page ***.gmi**, il la traduit en HTML. Cette présente page est affichée de cette façon. Gemini utilise son propre protocole, format, clients et serveurs ; HtmGem permet den utiliser le format (Gemtext) via le web.
```
Gemini est un nouveau protocole internet qui :
* est plus lourd que gopher,
* est plus léger que le web,
* nen remplacera aucun,
* vise le rapport puissance sur poids maximum,
* prend la vie privée très sérieusement.
```
=> https://gemini.circumlunar.space/
=> https://framagit.org/Sbgodin/htmgem Code source de HtmGem
=> https://gmi.sbgodin.fr/htmgem Page principale de HtmGem via le web
=> gemini://gmi.sbgodin.fr/htmgem Page principale de HtmGem via Gemini
———————————————————— ————————————————————
# Installation
Pour faire fonctionner HtmGem — après avoir copié les fichiers — il ne reste quà ajouter une règle de ré-écriture dURL (//URL Rewriting//). Si vous pouvez lire ce texte en ayant demandé //htmgem.php// avec le navigateur, il ne reste que cette dernière étape à franchir 😄
### Nginx ### Nginx
``` ```
@ -20,7 +41,7 @@ RewriteRule ^(.+\.gmi)$ htmgem/?url=$1
``` ```
Par la suite, Par la suite,
* Quand un fichier se terminant par //.gmi// sera demandé, HtmGem le traduira à la volée en HTML. * Quand un fichier se terminant par **.gmi** sera demandé, HtmGem le traduira à la volée en HTML.
* Quand seul le répertoire sera demandé (http://site.tld/path) le fichier //index.gmi// sera automatiquement choisi. * Quand seul le répertoire sera demandé (http://site.tld/path) le fichier //index.gmi// sera automatiquement choisi.
Le paramétrage dApache et de Nginx est similaire. Par la suite, la syntaxe Nginx sera utilisée. Le paramétrage dApache et de Nginx est similaire. Par la suite, la syntaxe Nginx sera utilisée.
@ -32,10 +53,11 @@ Il est supposé que HtmGem est installé à la racine du site dans un répertoir
🢂 Appeler cette présente page directement, en cliquant ci-après. Elle devrait être formatée exactement comme actuellement : 🢂 Appeler cette présente page directement, en cliquant ci-après. Elle devrait être formatée exactement comme actuellement :
=> index.gmi => index.gmi
🢂 Enfin, pour vérifier que le fichier //index.gmi// est automatiquement appelé quand le fichier //**.gmi**// nest pas indiqué : 🢂 Enfin, pour vérifier que le fichier //index.gmi// est automatiquement appelé quand le fichier **.gmi** nest pas indiqué :
=> /htmgem Lien vers la racine du site => /htmgem Lien vers la racine du site
Linstallation est terminée 🥳 La suite du texte donne des informations complémentaires, et nest pas nécessaire dans limmédiat. Linstallation est terminée 🥳 La suite du texte donne des informations complémentaires, et nest pas nécessaire dans limmédiat. Les fichiers **.gmi** que vous créerez seront disponibles dès maintenant.
=> tests/tutogemtext.gmi Inspirez-vous du tutoriel
———————————————————— ———————————————————— ———————————————————— ————————————————————