From 733450cb359052096d62a37ea343d1c3bddc96a1 Mon Sep 17 00:00:00 2001
From: Christophe HENRY <christophe.henry@sbgodin.fr>
Date: Sat, 27 Mar 2021 23:31:47 +0100
Subject: [PATCH] Translation to English

---
 docs/BNF-en.gmi                            | 110 +++++++++++++++++++++
 docs/BNF-fr.gmi                            |  27 +++--
 docs/configuration-en.gmi                  |  62 ++++++++++++
 docs/configuration-fr.gmi                  |  34 ++++---
 docs/index.gmi                             |   7 ++
 docs/installation-en.gmi                   |  42 ++++++++
 docs/{index-fr.gmi => installation-fr.gmi} |   4 +-
 docs/presentation-fr.gmi                   |  45 ---------
 docs/tutogemtext-en.gmi                    |  74 ++++++++++++++
 docs/tutogemtext-fr.gmi                    |  12 +--
 index-fr.gmi                               |  22 -----
 index.gmi                                  |  13 ++-
 12 files changed, 350 insertions(+), 102 deletions(-)
 create mode 100644 docs/BNF-en.gmi
 create mode 100644 docs/configuration-en.gmi
 create mode 100644 docs/index.gmi
 create mode 100644 docs/installation-en.gmi
 rename docs/{index-fr.gmi => installation-fr.gmi} (90%)
 delete mode 100644 docs/presentation-fr.gmi
 create mode 100644 docs/tutogemtext-en.gmi
 delete mode 100644 index-fr.gmi

diff --git a/docs/BNF-en.gmi b/docs/BNF-en.gmi
new file mode 100644
index 0000000..eb8bb46
--- /dev/null
+++ b/docs/BNF-en.gmi
@@ -0,0 +1,110 @@
+# BNF
+### aka Backus-Naur Form
+=> https://en.wikipedia.org/wiki/Backus%E2%80%93Naur_form Wikipedia / BNF
+
+The purpose of this document is to show the BNF that HtmGem uses and the way it determines the line type and what information it fetches from. For this, it uses **curly brackets** to explicitely show what information it takes. In addition to this, the **canonical form** shows how it should be displayed.
+
+———————————————————— ✀ ————————————————————
+
+textgemini = *(link / preformat / heading / ulist / quoted / plain)
+; Preformat toggle starts as 'false'.
+
+plain = **{[WSP] text} [WSP]** end-of-line
+; If preformat toggle is false, wrap text to the
+; width of the display. Otherwise, do no wrapping.
+; canonical form = {[WSP] text}
+
+preformat = "```" **[WSP]** [{alt-text}] **[WSP]** end-of-line
+; Preformat toggle set to opposite state:
+; false goes to true
+; true goes to false
+; While in preformat toggle is true, link, heading,
+; ulist and quoted lines are NOT interpreted, but
+; displayed as is to the user.
+; canonical form = ``` [SP {alt-text}]
+
+link = '=>' **[WSP]** [{URI-reference}] [**[WSP]** {text}] end-of-line
+; canonical form = '=>' SP {uri-reference} [SP {text}]
+
+heading = '#' **[WSP]** [{text}] **[WSP]** end-of-line
+/ '##' **[WSP]** {text} **[WSP]** end-of-line
+/ '###' **[WSP]** {text} **[WSP]** end-of-line
+; canonical form = ('#' / '##' / '###') [SP {text}]
+
+ulist = '*' **[WSP]** {text} **[WSP]** end-of-line
+; canonical form = '*' SP {text}
+
+quoted = '>' **[WSP]** {text} **[WSP]** end-of-line
+; canonical form = '>' SP {text}
+
+alt-text = text
+text = ***UVCHAR**
+end-of-line = [CR] LF
+
+UVCHAR = VCHAR / UTF8-2v / UTF8-3 / UTF8-4
+UTF8-2v = %xC2 %xA0-BF UTF8-tail ; no C1 control set
+/ %xC3-DF UTF8-tail
+
+; CRLF from RFC-5234
+; DIGIT from RFC-5234
+; SP from RFC-5234
+; VCHAR from RFC-5234
+; OCTET from RFC-5234
+; WSP from RFC-5234
+;
+; UTF8-3 from RFC-3629
+; UTF8-4 from RFC-3629
+; UTF8-tail from RFC-3629
+
+———————————————————— ✀ ————————————————————
+
+This BNF was taken from the working group and adapted to HtmGem's implementation.
+=> https://gitlab.com/gemini-specification/gemini-text/-/issues/7 Gitlab / Original ticket
+
+Changes:
+* white space management
+* capture of text {}
+* canonical form
+
+The white spaces that end a line are never used. See the definition of //text// in the BNF, which no longer contains //SP//.
+
+# Examples
+
+## => links
+
+### Normal link
+> link = '=>' [WSP] [{URI-reference}] [[WSP] {text}] end-of-line
+> ; canonical form = '=>' SP {uri-reference} [SP {text}]
+
+Source: => foo.invalid text of the link
+Data: '=>' {'foo.invalid'} {'text of the link'}
+Canonical: => foo.invalid text of the link
+Html: <a href="foo.invalid">text of the link</a>
+
+Source: =>foo.invalid           text of the link
+Data: '=>' {'foo.invalid'} {'text of the link'}
+Canonical: => foo.invalid text of the link
+Html: <a href="foo.invalid">text of the link</a>
+
+Source: => just_a_page
+Data: '=>' {'just_a_page'} {}
+Canonical: => just_a_page
+Html: <a href="just_a_page">just_a_page</a>
+
+Source: =>
+Data: '=>' {''} {''}
+Canonical: =>
+Html: <a href="">&nbsp;</a>
+
+## # Headings
+> heading = '#' **[WSP]** [{text}] **[WSP]** end-of-line
+> (…)
+> ; canonical form = ('#' / '##' / '###') [SP {text}]
+
+Source: #title
+Data: '#' {"title"}
+Canonical: # title
+
+Source: # title with two spaces between title and with
+Data: '#' {"title  with spaces"}
+Canonical: # title with two spaces between title and with
diff --git a/docs/BNF-fr.gmi b/docs/BNF-fr.gmi
index eb8bb46..ea60777 100644
--- a/docs/BNF-fr.gmi
+++ b/docs/BNF-fr.gmi
@@ -1,8 +1,9 @@
 # BNF
-### aka Backus-Naur Form
-=> https://en.wikipedia.org/wiki/Backus%E2%80%93Naur_form Wikipedia / BNF
+### Backus-Naur Form
+=> https://fr.wikipedia.org/wiki/Forme_de_Backus-Naur Wikipedia / BNF
 
-The purpose of this document is to show the BNF that HtmGem uses and the way it determines the line type and what information it fetches from. For this, it uses **curly brackets** to explicitely show what information it takes. In addition to this, the **canonical form** shows how it should be displayed.
+(EN) The purpose of this document is to show the BNF that HtmGem uses and the way it determines the line type and what information it fetches from. For this, it uses **curly brackets** to explicitely show what information it takes. In addition to this, the **canonical form** shows how it should be displayed.
+(FR) Le but de ce document est de montrer la BNF que HtmGem utilise et la façon dont il détermine le type de ligne et quelles informations il en tire. Pour cela, il utilise des **accolades** pour montrer explicitement quelles informations il prend. De plus, la **forme canonique** montre comment ça devrait être affiché.
 
 ———————————————————— ✀ ————————————————————
 
@@ -58,21 +59,27 @@ UTF8-2v = %xC2 %xA0-BF UTF8-tail ; no C1 control set
 
 ———————————————————— ✀ ————————————————————
 
-This BNF was taken from the working group and adapted to HtmGem's implementation.
+(EN) This BNF was taken from the working group and adapted to HtmGem's implementation.
+(FR) Cette BNF a été adaptée à l’implémentation de HtmGem depuis la version du groupe de travail.
 => https://gitlab.com/gemini-specification/gemini-text/-/issues/7 Gitlab / Original ticket
 
-Changes:
+(EN) Changes:
 * white space management
 * capture of text {}
 * canonical form
+(FR) Changements :
+* gestion des espaces blancs
+* capture du texte {}
+* forme canonique
 
-The white spaces that end a line are never used. See the definition of //text// in the BNF, which no longer contains //SP//.
+(EN) The white spaces that end a line are never used. See the definition of //text// in the BNF, which no longer contains //SP//.
+(FR) Les espaces blancs terminant une ligne ne sont jamais utilisés. Voir la définition de //text// dans la BNF, qui ne contient plus //SP//.
 
-# Examples
+# Exemples
 
-## => links
+## => liens
 
-### Normal link
+### Lien normal
 > link = '=>' [WSP] [{URI-reference}] [[WSP] {text}] end-of-line
 > ; canonical form = '=>' SP {uri-reference} [SP {text}]
 
@@ -96,7 +103,7 @@ Data: '=>' {''} {''}
 Canonical: =>
 Html: <a href="">&nbsp;</a>
 
-## # Headings
+## # En-têtes
 > heading = '#' **[WSP]** [{text}] **[WSP]** end-of-line
 > (…)
 > ; canonical form = ('#' / '##' / '###') [SP {text}]
diff --git a/docs/configuration-en.gmi b/docs/configuration-en.gmi
new file mode 100644
index 0000000..eeb36da
--- /dev/null
+++ b/docs/configuration-en.gmi
@@ -0,0 +1,62 @@
+# Advanced configuration
+
+By default, the same style is used for all the pages, //htmgem/css/htmgem.css//, except when a file having the same name as the page but with the extension **.css** exists in the same directory. In such as case, it's used.
+
+When the CSS option is activated in the configuration (see /rewrite// below) other behaviors are possible. **Beware**, it won't work with a Gemini client as HtmGem is only reachable with a web browser.
+* &style=**htmgem** : Uses the default style.
+* &style=**none** : The page HTML is sent without style.
+* &style=**<autre nom>** : The file htmgem/css/<autre nom>.css is used as a style.
+* &style=**/<path>** : The provided file (absolute path) is used as a style.
+* &style=**source** : The source code of the page is sent to the browser, see below…
+* &style=**pre** : The source code of the page is sent to the browser enclosed in //<pre>//, see below…
+
+## URL rewriting to set the style to use
+
+Modifying the web server configuration works but it's rather heavy. It's possible to test a particular style this way:
+> https:/​/site.tld/htmgem/index.php?url=/url/page.gmi&style=<…>
+
+It's also possible to make a URL rewriting which incorporate the style:
+> rewrite ^(.+\.gmi)$ /htmgem/?url=$1;
+> rewrite ^(.+\.gmi)\ *\|\ *([\w_]+)$ /htmgem/?url=$1&style=$2;
+
+For instance, when it's activated:
+=> configuration-en.gmi%20|%20pre Shows the readable source code on the screen, using the markup **<pre>**.
+=> configuration-en.gmi%20|%20source configuration-en.gmi | source : Downloads the source code.
+
+=> ../css Sélecteur de style : the page containing the style allows to test them 😎
+
+### With style already included…
+
+=> configuration-en.gmi%20|%20htmgem Style //HtmGem//, the default style
+=> configuration-en.gmi%20|%20none Style //none//
+=> configuration-en.gmi%20|%20terminal Style //terminal//
+=> configuration-en.gmi%20|%20black_wide Style //black wide//
+=> configuration-en.gmi%20|%20simple Style //simple//
+=> configuration-en.gmi%20|%20raw Style //raw//
+=> configuration-en.gmi%20|%20debug Style //debug//
+
+## 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.
+
+### Disable the text decoration
+
+It's possible to:
+* disable and enable the text decoration with a line **^^^**,
+* add what follows to the URL **rewriting**:
+> &textDecoration=0
+
+## BNF / Syntax
+
+HtmGem uses a precise implementation of the GemText BNF. It indicates exactly what text portions are to be used.
+=> BNF-en.gmi BNF
+
+=> tutogemtext-en.gmi How to build GemText pages?
+
+———————————————————— ————————————————————
+
+Amongst the distributed files and directories, only the ones below are useful for HtmGem:
+* **htmgem/*.php** : These files translate the GemText to HTML.
+* **htmgem/css/htmgem.css** : If it's missing, the display will be without style — literally.
+* **htmgem/css/…** : Keep the styles you use.
+The others can be deleted (included this present file //configuration-en.gmi//) although they are not harmful.
diff --git a/docs/configuration-fr.gmi b/docs/configuration-fr.gmi
index 751c499..bb56bc9 100644
--- a/docs/configuration-fr.gmi
+++ b/docs/configuration-fr.gmi
@@ -1,12 +1,12 @@
 # Configuration avancée
 
-Par défaut, le style est incorporé dans chaque page récupérée par le navigateur web. Le même style est utilisé pour toutes les pages, //htmgem/css/htmgem.css//, sauf lorsqu’un fichier ayant le même nom que la page mais avec l’extension **.css** existe dans le même répertoire. Dans ce cas, il est utilisé.
+Par défaut, le même style est utilisé pour toutes les pages, //htmgem/css/htmgem.css//, sauf lorsqu’un fichier ayant le même nom que la page mais avec l’extension **.css** existe dans le même répertoire. Dans ce cas, il est utilisé.
 
-Lorsque l’option css est activé dans la configuration (voir //rewrite// plus haut) d’autres comportements sont possibles. **Attention**, cela ne fonctionnera pas avec un client Gemini puisque HtmGem n’est accessible que via un navigateur web.
-* &style=**htmgem** : Utilise le style par défaut, mais en tant que fichier externe.
+Lorsque l’option css est activé dans la configuration (voir //rewrite// plus bas) d’autres comportements sont possibles. **Attention**, cela ne fonctionnera pas avec un client Gemini puisque HtmGem n’est accessible que via un navigateur web.
+* &style=**htmgem** : Utilise le style par défaut.
 * &style=**none** : La page HTML est envoyée sans style.
-* &style=**<autre nom>** : Le fichier htmgem/css/<autre nom>.css est utilisé en tant que style externe.
-* &style=**/<path>** : Le fichier indiqué (chemin absolu) est utilisé en tant que style externe.
+* &style=**<autre nom>** : Le fichier htmgem/css/<autre nom>.css est utilisé en tant que style.
+* &style=**/<path>** : Le fichier indiqué (chemin absolu) est utilisé en tant que style.
 * &style=**source** : Le code source de la page est envoyée au navigateur, voir ci-après…
 * &style=**pre** : Le code source de la page est envoyée au navigateur encadré par des //<pre>//, voir ci-après…
 
@@ -20,17 +20,20 @@ Il est aussi possible de faire une réécriture d’URL qui intègre le style :
 > rewrite ^(.+\.gmi)\ *\|\ *([\w_]+)$ /htmgem/?url=$1&style=$2;
 
 Par exemple, lorsque ce sera activé :
-=> index-fr.gmi%20|%20pre Produit le code source de façon lisble à l’écran en utilisant la balise **<pre>**.
-=> index-fr.gmi%20|%20source Le lien index-fr.gmi | source Téléverse le code source.
+=> configuration-fr.gmi%20|%20pre Produit le code source de façon lisble à l’écran en utilisant la balise **<pre>**.
+=> configuration-fr.gmi%20|%20source configuration-fr.gmi | source : Téléverse le code source.
 
 => ../css Sélecteur de style : la page contenant les styles permet de les essayer 😎
 
 ### Avec les styles déjà fournis…
 
-=> index-fr.gmi%20|%20none Style //none//
-=> index-fr.gmi%20|%20terminal Style //terminal//
-=> index-fr.gmi%20|%20black_wide Style //black wide//
-=> index-fr.gmi%20|%20simple Style //simple//
+=> configuration-fr.gmi%20|%20htmgem Style //HtmHem//, le style par défaut
+=> configuration-fr.gmi%20|%20none Style //none//
+=> configuration-fr.gmi%20|%20terminal Style //terminal//
+=> configuration-fr.gmi%20|%20black_wide Style //black wide//
+=> configuration-fr.gmi%20|%20simple Style //simple//
+=> configuration-fr.gmi%20|%20raw Style //brut//
+=> configuration-fr.gmi%20|%20debug Style //debug//
 
 ## Décoration du texte
 
@@ -43,12 +46,17 @@ On peut :
 * ajouter ce qui suit à la **réécriture** d’URL :
 > &textDecoration=0
 
+## BNF / Syntax
+
+HtmGem utilise une implémentation précise de la BNF de GemText. Il indique exactement quelle portions de texte doivent être utilisées.
+=> BNF-fr.gmi BNF
+
 => tutogemtext-fr.gmi Comment faire des pages GemText ?
 
 ———————————————————— ————————————————————
 
 Parmi les fichiers et répertoires distribués, seuls sont utiles pour le fonctionnement de HtmGem :
-* **htmgem/*.php** : Ces fichiers se chargent de traduire le gemtext en HTML.
+* **htmgem/*.php** : Ces fichiers se chargent de traduire le GemText en HTML.
 * **htmgem/css/htmgem.css** : S’il manque, l’affichage sera dépourvu de style — littéralement.
 * **htmgem/css/…** : Conservez les styles que vous utilisez.
-Les autres peuvent être supprimés (y compris ce présent fichier //index-fr.gmi//) bien qu’ils ne présentent aucun danger.
+Les autres peuvent être supprimés (y compris ce présent fichier //configuration-fr.gmi//) bien qu’ils ne présentent aucun danger.
diff --git a/docs/index.gmi b/docs/index.gmi
new file mode 100644
index 0000000..45b2d63
--- /dev/null
+++ b/docs/index.gmi
@@ -0,0 +1,7 @@
+# Developers' documentation
+
+=> https://gmi.sbgodin.fr/htmgem Project main page
+=> https://tildegit.org/Sbgodin/htmgem Source code, comments
+=> https://gemini.circumlunar.space Main Gemini capsule
+=> ../CHANGELOG.gmi Change log
+=> ../COPYING.gmi Licence Gnu Affero General Public License v3 — 19 november 2007
diff --git a/docs/installation-en.gmi b/docs/installation-en.gmi
new file mode 100644
index 0000000..07db762
--- /dev/null
+++ b/docs/installation-en.gmi
@@ -0,0 +1,42 @@
+# 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
+=> https://tildegit.org/sbgodin/HtmGem/archive/master.zip Stable version
+=> https://tildegit.org/Sbgodin/htmgem Project repository
+
+### Nginx
+```
+# This text must be placed in the server's configuration
+index index.php index.gmi index.html
+rewrite ^(.+\.gmi)$ htmgem/?url=$1;
+```
+
+### Apache
+```
+# This text can be placed at the root of the web site in a file ".htaccess".
+DirectoryIndex index.php index.gmi index.html
+RewriteEngine on
+RewriteRule ^(.+\.gmi)$ htmgem/?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.
+
+=> tutogemtext-en.gmi How to build GemText pages?
+
+## Advanced configuration
+
+Add additional styles as a link parameter or adapt the text decoration:
+=> configuration-en.gmi Advanced configuration
diff --git a/docs/index-fr.gmi b/docs/installation-fr.gmi
similarity index 90%
rename from docs/index-fr.gmi
rename to docs/installation-fr.gmi
index 99ffffc..10c6e7d 100644
--- a/docs/index-fr.gmi
+++ b/docs/installation-fr.gmi
@@ -1,13 +1,13 @@
 # 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//).
+Pour faire fonctionner HtmGem — après avoir copié les fichiers — il ne reste qu’à ajouter les règles 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
+* Module **mod-rewrite** pour prendre en charge les pages Gemini
 
 ## Installation
 
diff --git a/docs/presentation-fr.gmi b/docs/presentation-fr.gmi
deleted file mode 100644
index 8d04fab..0000000
--- a/docs/presentation-fr.gmi
+++ /dev/null
@@ -1,45 +0,0 @@
-# HtmGem, voir Gemini via le web
-
-HtmGem permet d’héberger des pages Gemini et de les publier sur un serveur web muni de **Php**. À l’ouverture d’une page ***.gmi**, il la traduit pour le navigateur web. Cette présente page est affichée de cette façon. Gemini utilise son propre protocole, format, clients et serveurs ; HtmGem permet d’en 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,
-* n’en remplacera aucun,
-* vise le rapport puissance sur poids maximum,
-* prend la vie privée très sérieusement.
-```
-=> https://gemini.circumlunar.space/
-
-=> https://tildegit.org/sbgodin/HtmGem/archive/master.zip Téléchargez la branche courante pour l’installer
-=> https://tildegit.org/Sbgodin/htmgem Code source, rapports de bug, commentaires…
-
-=> https://gmi.sbgodin.fr/htmgem Page principale de HtmGem via le web
-=> gemini://gmi.sbgodin.fr/htmgem Page principale de HtmGem via Gemini
-
-=> CHANGELOG.gmi Journal des modifications (//changelog//)
-=> COPYING.gmi GNU Affero General Public License (AGPLv3)
-
-Ceci est la page d’installation et de présentation d’**HtmGem**.
-=> docs/tutogemtext-fr.gmi Cliquez ici pour voir le tutoriel pour écrire des pages Gemini.
-
-=> docs/index-fr.gmi Installation
-# HtmGem, voir Gemini via le web
-
-HtmGem permet d’héberger des pages Gemini et de les publier sur un serveur web muni de **Php**. À l’ouverture d’une page ***.gmi**, il la traduit pour le navigateur web. Cette présente page est affichée de cette façon. Gemini utilise son propre protocole, format, clients et serveurs ; HtmGem permet d’en utiliser le format (Gemtext) via le web.
-
-
-=> https://tildegit.org/sbgodin/HtmGem/archive/master.zip Téléchargez la branche courante pour l’installer
-=> https://tildegit.org/Sbgodin/htmgem Code source, rapports de bug, commentaires…
-
-=> https://gmi.sbgodin.fr/htmgem Page principale de HtmGem via le web
-=> gemini://gmi.sbgodin.fr/htmgem Page principale de HtmGem via Gemini
-
-=> CHANGELOG.gmi Journal des modifications (//changelog//)
-=> COPYING.gmi GNU Affero General Public License (AGPLv3)
-
-Ceci est la page d’installation et de présentation d’**HtmGem**.
-=> docs/tutogemtext-fr.gmi Cliquez ici pour voir le tutoriel pour écrire des pages Gemini.
-
-=> docs/index-fr.gmi Installation
diff --git a/docs/tutogemtext-en.gmi b/docs/tutogemtext-en.gmi
new file mode 100644
index 0000000..163f169
--- /dev/null
+++ b/docs/tutogemtext-en.gmi
@@ -0,0 +1,74 @@
+# GemText tutorial
+
+Gemini is a protocol, a syntax, servers and clients. Its syntax is the GemText. Its principle is that it's the Gemini browser of the user which decides about the display. The font, the size, the page background, everything. One of the goal is to focus on the text and some other details explained below.
+
+The paragraph you just read is on one physical line, cut by the program you use in several logical lines to fit your screen. Between this text line and the preceding one, there's an empty line to mark the paragraph change.
+Here, I just did a line wrap. The margin should be lower, but it depends upon the program you are using.
+
+The titles of level one, two and three are first written as they are physically on this page, then on the line after they are displayed normally by the Gemini browser:
+
+​# Title level 1
+# Title level 1
+
+​## Title level 2
+## Title level 2
+
+​### Title level 3
+### Title level 3
+
+# Citations
+
+​> Text citation. The line can be as long as needed, it's your program that must cut the line to display it. One physical line can be long, but there's no need to wrap the line.
+> Text citation. The line can be as long as needed, it's your program that must cut the line to display it. One physical line can be long, but there's no need to wrap the line.
+
+# Preformated blocks
+
+​```
+The preformated blocks are lines enclosed by ``` on one line before the block and a ``` after the block.
+​```
+```
+The preformated blocks are lines enclosed by ``` on one line before the block and a ``` after the block.
+```
+
+# Unordered lists
+
+​* The unordered lists are lines beginning by * one after the others.
+​* They can be used to enumerate.
+​* However, GemText doesn't recognize the ordered lists.
+* The unordered lists are lines beginning by * one after the others.
+* They can be used to enumerate.
+* However, GemText doesn't recognize the ordered lists.
+
+# The links
+
+There can be only one link on a line. And the line is dedicated to! Here's for instance a link to the site centralizing at the moment the information about Gemini:
+
+​=> gemini:/​/gemini.circumlunar.space/docs/specification.gmi Gemini specifications
+=> gemini://gemini.circumlunar.space/docs/specification.gmi Gemini specifications
+
+​=> https:/​/gemini.circumlunar.space/docs/specification.gmi
+=> https://gemini.circumlunar.space/docs/specification.gmi
+
+# Text decoration
+
+The text decoration is not part of Gemini's specifications.
+
+This *​*line*​* uses the /​/text decoration/​/ which can ~​~strike through~​~ or _​_underline_​_ words.
+This **line** uses the //text decoration// which can ~~strike through~~ or __underline__ words.
+
+It's possible to disable and enable the text decoration with **^^^** on a line.
+
+And voilà! You know everything 🥳
+
+———————————————————— ————————————————————
+
+## HtmGem
+
+HtmGem allows to host Gemini pages and publish them on a web server with **Php**. When opening a page ***.gmi**, it translates it for the web browser. This page is displayed this way. It allows to use the Gemini syntax (GemText) on the web.
+=> https://gmi.sbgodin.fr/htmgem
+
+
+### License of this page
+This page is under the free licence **CC BY-SA 2.0**.
+=> https://creativecommons.org/licenses/by-sa/2.0/en/ Text under license CC BY-SA 2.0
+=> gemini://gmi.sbgodin.fr/ gemini:/​/gmi.sbgodin.fr/ ⸻ Christophe HENRY
diff --git a/docs/tutogemtext-fr.gmi b/docs/tutogemtext-fr.gmi
index 5da5026..dd1c3e0 100644
--- a/docs/tutogemtext-fr.gmi
+++ b/docs/tutogemtext-fr.gmi
@@ -1,4 +1,4 @@
-# Tutorial GemText
+# Tutoriel GemText
 
 Gemini est un protocole, une syntaxe, des serveurs et des clients. Sa syntaxe est le GemText. Son principe est que c’est le navigateur Gemeni de l’utilisateur qui décide de l‘affichage. La police de caractère, la taille, le fond d‘écran, tout. L’un des buts recherchés est de se concentrer sur le texte et quelques autres détails abordés ci-après.
 
@@ -24,10 +24,10 @@ Les titres de niveau un, deux puis trois sont d’abord écrits ci-après tel qu
 # Blocs préformatés
 
 ​```
-Les blocs préformatés sont des lignes encadrées par un ``` sur une ligne avant le bloc et un ``` après le bloc. Les lignes contenant ``` ne sont pas affichées :
+Les blocs préformatés sont des lignes encadrées par un ``` sur une ligne avant le bloc et un ``` après le bloc.
 ​```
 ```
-Les blocs préformatés sont des lignes encadrées par un ``` sur une ligne avant le bloc et un ``` après le bloc. Les lignes contenant ``` ne sont pas affichées :
+Les blocs préformatés sont des lignes encadrées par un ``` sur une ligne avant le bloc et un ``` après le bloc.
 ```
 
 # Listes non-ordonnées
@@ -58,7 +58,7 @@ Cette **ligne** utilise la //décoration du texte// qui peut ~~barrer~~ ou __sou
 
 On peut désactiver et activer la décoration du texte avec **^^^** sur une ligne.
 
-Et voilà ! Vous savez tout ce qui est à savoir 🥳
+Et voilà ! Vous savez tout 🥳
 
 ———————————————————— ————————————————————
 
@@ -69,6 +69,6 @@ HtmGem permet d’héberger des pages Gemini et de les publier sur un serveur we
 
 
 ### License de cette page
-Cette page est sous licence libre **CC BY-SA 2.0 FR**.
-=> https://creativecommons.org/licenses/by-sa/2.0/fr/ Texte sous licence CC BY-SA 2.0 FR
+Cette page est sous licence libre **CC BY-SA 2.0**.
+=> https://creativecommons.org/licenses/by-sa/2.0/fr/ Texte sous licence CC BY-SA 2.0
 => gemini://gmi.sbgodin.fr/ gemini:/​/gmi.sbgodin.fr/ ⸻ Christophe HENRY
diff --git a/index-fr.gmi b/index-fr.gmi
deleted file mode 100644
index e4565cf..0000000
--- a/index-fr.gmi
+++ /dev/null
@@ -1,22 +0,0 @@
-# HtmGem, voir Gemini via le web
-
-HtmGem rend vos pages **Gemini** accessibles sur le web. Il fonctionne aussi sur un hébergement mutualisé.
-
-# Installation
-* Copier les fichiers.
-* Configurer la réécriture d’url.
-
-=> docs/index-fr.gmi Installer HtmGem
-
-# Gemini…
-Gemini est un protocole, une syntaxe, des serveurs et des clients. C’est le même principe que le web, en plus rudimentaire et stable. Sa syntaxe est le **GemText**. Son principe est que c’est le navigateur Gemini de l’utilisateur qui décide de l‘affichage. La police de caractère, la taille, le fond d‘écran, tout.
-
-=> docs/tutogemtext-fr.gmi Tutoriel **Gemtext** et exemples
-
-
-———————————————————— ————————————————————
-=> https://gmi.sbgodin.fr/htmgem Page principale du projet
-=> https://tildegit.org/Sbgodin/htmgem Code source, commentaires
-=> https://gemini.circumlunar.space Capsule principale Gemini
-=> CHANGELOG.gmi Journal des modifications
-=> COPYING.gmi Licence Gnu Affero General Public License v3 — 19 november 2007
diff --git a/index.gmi b/index.gmi
index 688200f..070df28 100644
--- a/index.gmi
+++ b/index.gmi
@@ -1,8 +1,13 @@
 # HtmGem
 
+=> docs/installation-fr.gmi Installation de HtmGem, en français
+HtmGem rend vos pages **Gemini** accessibles sur le web. Il fonctionne aussi en hébergement mutualisé.
+=> docs/tutogemtext-fr.gmi Tutoriel GemText
 
-=> index-fr.gmi **Français**
-HtmGem rend vos pages **Gemini** accessibles sur le web. Il fonctionne aussi sur un hébergement mutualisé.
-
-=/> **English**
+=> docs/installation-en.gmi HtmGem installation, in English
 HtmGem makes your **Gemini** pages reachable on the web. It can be used on a shared host.
+=> docs/tutogemtext-en.gmi GemText tutorial
+
+
+=> docs/index.gmi **Developers' documentation**
+The documentation (in English) for the developers's stands here. Please read them carefully before doing anything on the source code.