1
0
mirror of https://tildegit.org/sbgodin/HtmGem.git synced 2023-08-25 13:53:12 +02:00
HtmGem/tutogemtext.gmi

85 lines
5.1 KiB
Plaintext
Raw Normal View History

2021-03-09 11:26:31 +01:00
Gemini se découpe en son protocole (comme HTTP) et son language, GemText. Ici, je vais approfondir ce quest le langage GemText. Son principe est que cest le programme de lutilisateur (le navigateur web, pour HTTP) qui décide de laffichage. La police de caractère, la taille, le fond décran, tout. À lexception du texte et de quelques autres détails qui suivent.
Si vous utilisez un programme qui ninterprète pas tous les styles de lignes, certaines vous sembleront dupliquées…
La ligne que vous venez de lire existe sur une 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 davant, il y a une ligne vide pour marquer le changement de paragraphe.
Ici, jai simplement passé à la ligne. Lespacement devrait être moindre.
Il y a tout de même quelques types spéciaux de ligne.
On commence par le titre de niveau 1. Il est dabord écrit ci-après tel que je le vois, puis sur la ligne daprès il est rendu normalement par votre programme :
# Comment fonctionne GemText ?
# Comment fonctionne GemText ?
Je viens décrire « # Comment fonctionne GemText » deux fois. Une fois sans quil soit interprété, où vous le voyez tel que je le vois. Et une deuxième fois où votre programme peut lafficher différemment.
# Titre de niveau 1
# Titre de niveau 1
## Titre de niveau 2
## Titre de niveau 2
### Titre de niveau 3
### Titre de niveau 3
# Les citations
Quand on veut citer un texte, on écrit avec le caractère > en début de ligne. Dabord affichée comme je lai écrit puis comme le programme laffiche normalement :
> Citation de texte. La ligne peut être aussi longue que voulue, cest votre programme qui doit découper la ligne pour lafficher. Une seule ligne physique peut être longue, mais il ny a pas besoin de placer de retour à la ligne.
> Citation de texte. La ligne peut être aussi longue que voulue, cest votre programme qui doit découper la ligne pour lafficher. Une seule ligne physique peut être longue, mais il ny a pas besoin de placer de retour à la ligne.
# Les 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 :
```
Ceci est une ligne préformatée. Quand la ligne est longue, elle nest pas découpée. Le programme doit présenter un ascenseur horizontal pour permettre de tout voir.
```
```
Ceci est une ligne préformatée. Quand la ligne est longue, elle nest pas découpée. Le programme doit présenter un ascenseur horizontal pour permettre de tout voir.
```
# Les 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 quun 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
Voici un autre lien, directement visible parce quil na pas de description :
=> https://gemini.circumlunar.space/docs/specification.gmi
=> https://gemini.circumlunar.space/docs/specification.gmi
2021-03-10 11:13:33 +01:00
# Ce quil y a en plus…
2021-03-09 11:26:31 +01:00
2021-03-10 11:13:33 +01:00
HtmGem suit les préconisations de Gemini, sauf pour le texte formaté. Il ne saffiche — à cette heure — que via HtmGem. Vous nen voyez que les caractères déclenchant le formatage. Mais le texte reste néanmoins lisible via un client Gemini.
2021-03-09 11:26:31 +01:00
2021-03-10 11:13:33 +01:00
^ Cette **ligne** naffiche ~~pas~~ la décoration du //texte//. Elle reste lisible même en voyant les caractères de formatage.
Cette **ligne** affiche la décoration du //texte//. Elle reste lisible même en voyant les caractères de formatage.
2021-03-09 11:26:31 +01:00
2021-03-10 11:13:33 +01:00
## Ajouts à la norme :
* Par défaut, le texte mis en forme sapplique sur les lignes de texte, listes et citations.
* Pour désactiver la mise en forme du texte, on peut soit commencer la ligne par ^, soit faire un bloc non décoré avec ^^^ :
2021-03-09 11:26:31 +01:00
2021-03-10 11:13:33 +01:00
## HtmGem
HtmGem permet dhéberger des pages Gemini et de les publier sur un serveur web muni de **Php**. À louverture dune 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 den utiliser le format (Gemtext) via le web.
=> https://gmi.sbgodin.fr/htmgem
2021-03-09 11:26:31 +01:00
### 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
=> ..