mirror of
https://tildegit.org/sbgodin/HtmGem.git
synced 2023-08-25 13:53:12 +02:00
Christophe HENRY
859b0aad81
* Removes "^" to disable text decoration line-wise. * Split HTML generation in two: parsing and translating. * Create class to handle gemtext parsing. * Create class to translate to HTML. * Create class to generate back gemtext (for future test cases). * Uses generators to parse then translate. * Fix: 404 doesn't occur for an empty file. * Page 404 fully generated by HtmGem itself. * CSS is no longer incorporated in the HTML page. * Handle CSS inclusion by addCss() calls.
79 lines
4.2 KiB
Plaintext
79 lines
4.2 KiB
Plaintext
# Tutorial 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.
|
||
|
||
Le paragraphe que vous venez de lire existe sur une seule ligne physique, que le programme que vous utilisez a dû découper en plusieurs lignes logiques afin que cela tienne sur votre écran. Entre cette présente ligne de texte et celle d’avant, il y a une ligne vide pour marquer le changement de paragraphe.
|
||
Ici, j’ai simplement passé à la ligne. L’espacement devrait être moindre mais cela dépend du programme que vous utilisez.
|
||
|
||
Les titres de niveau un, deux puis trois sont d’abord écrits ci-après tel qu’ils sont écrits physiquement dans cette page, puis sur la ligne d’après ils sont affichés normalement par le navigateur Gemini :
|
||
|
||
# Titre de niveau 1
|
||
# Titre de niveau 1
|
||
|
||
## Titre de niveau 2
|
||
## Titre de niveau 2
|
||
|
||
### Titre de niveau 3
|
||
### Titre de niveau 3
|
||
|
||
# Citations
|
||
|
||
> Citation de texte. La ligne peut être aussi longue que voulue, c’est votre programme qui doit découper la ligne pour l’afficher. Une seule ligne physique peut être longue, mais il n’y a pas besoin de placer de retour à la ligne.
|
||
> Citation de texte. La ligne peut être aussi longue que voulue, c’est votre programme qui doit découper la ligne pour l’afficher. Une seule ligne physique peut être longue, mais il n’y a pas besoin de placer de retour à la ligne.
|
||
|
||
# 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 lignes contenant ``` ne sont pas affichées :
|
||
```
|
||
|
||
# Listes non-ordonnées
|
||
|
||
* Les listes non-ordonnées sont des lignes commençant par * les unes après les autres.
|
||
* Elles servent à énumérer.
|
||
* Par contre, GemText ne reconnaît pas les listes numérotées.
|
||
* Les listes non-ordonnées sont des lignes commençant par * les unes après les autres.
|
||
* Elles servent à énumérer.
|
||
* Par contre, GemText ne reconnaît pas les listes numérotées.
|
||
|
||
# Les liens
|
||
|
||
Il ne peut exister qu’un lien par ligne. Et la ligne est dédiée à ça ! Voici par exemple un lien vers le site centralisant pour le moment les informations sur Gemini :
|
||
|
||
=> gemini://gemini.circumlunar.space/docs/specification.gmi Spécifications de Gemini
|
||
=> gemini://gemini.circumlunar.space/docs/specification.gmi Spécifications de Gemini
|
||
|
||
=> https://gemini.circumlunar.space/docs/specification.gmi
|
||
=> https://gemini.circumlunar.space/docs/specification.gmi
|
||
|
||
# Décoration du texte
|
||
|
||
La décoration du texte ne fait pas partie des spécifications de Gemini.
|
||
|
||
Cette **ligne** utilise la //décoration du texte// qui peut ~~barrer~~ ou __souligner__ des mots.
|
||
Cette **ligne** utilise la //décoration du texte// qui peut ~~barrer~~ ou __souligner__ des mots.
|
||
|
||
On peut désactiver et activer la décoration du texte avec **^^^** sur une ligne.
|
||
|
||
Et voilà ! Vous savez tout ce qui est à savoir 🥳 Les spécifications complètes sont sur le site de Gemini :
|
||
=> https://gemini.circumlunar.space/docs/specification.gmi
|
||
|
||
———————————————————— ————————————————————
|
||
|
||
## HtmGem
|
||
|
||
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. Il permet d’utiliser la syntaxe Gemini (GemText) via le web.
|
||
=> https://gmi.sbgodin.fr/htmgem
|
||
|
||
|
||
### 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 de la licence CC BY-SA 2.0 FR
|
||
=> gemini://gmi.sbgodin.fr/ gemini://gmi.sbgodin.fr/ ⸻ Christophe HENRY
|
||
|
||
### Navigation
|
||
=> index.gmi
|