mirror of
https://tildegit.org/sbgodin/HtmGem.git
synced 2023-08-25 13:53:12 +02:00
Improves general presentation
This commit is contained in:
parent
db12ae5856
commit
9b4f33f42f
@ -39,7 +39,7 @@ h1, h2, h3 {
|
||||
|
||||
h1 { font-size: 2rem; }
|
||||
h2 { font-size: 1.8rem; }
|
||||
h3 { font-size: 1.5rem; }
|
||||
h3 { font-size: 1.2rem; }
|
||||
|
||||
blockquote {
|
||||
background-color: #eee;
|
||||
|
||||
@ -34,7 +34,7 @@ h1, h2, h3 {
|
||||
|
||||
h1 { font-size: 2rem; }
|
||||
h2 { font-size: 1.8rem; }
|
||||
h3 { font-size: 1.5rem; }
|
||||
h3 { font-size: 1.2rem; }
|
||||
|
||||
blockquote {
|
||||
background-color: #010;
|
||||
|
||||
24
index.gmi
24
index.gmi
@ -1,9 +1,9 @@
|
||||
# HtmGem, voir Gemini à travers HTTP
|
||||
# HtmGem, voir Gemini via le web
|
||||
|
||||
Ceci est la page d’installation et de présentation d’**HtmGem**.
|
||||
=> tests/tutogemtext.gmi Cliquez ici pour voir le tutoriel pour écrire des pages Gemini.
|
||||
=> tutogemtext.gmi Cliquez ici pour voir le tutoriel pour écrire des pages Gemini.
|
||||
|
||||
HtmGem permet d’héberger des pages Gemini et de les publier sur le web. À l’ouverture d’une 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 d’en utiliser le format (Gemtext) 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 :
|
||||
@ -15,7 +15,7 @@ Gemini est un nouveau protocole internet qui :
|
||||
```
|
||||
=> https://gemini.circumlunar.space/
|
||||
|
||||
=> https://framagit.org/Sbgodin/htmgem Code source de HtmGem
|
||||
=> https://framagit.org/Sbgodin/htmgem Page du projet de 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
|
||||
|
||||
@ -25,6 +25,13 @@ Gemini est un nouveau protocole internet qui :
|
||||
|
||||
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//). Si vous pouvez lire ce texte en ayant demandé //htmgem.php// avec le navigateur, il ne reste que cette dernière étape à franchir 😄
|
||||
|
||||
## 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 intercepter les pages Gemini
|
||||
|
||||
### Nginx
|
||||
```
|
||||
# Ce texte doit être placé dans la configuration du serveur.
|
||||
@ -57,7 +64,7 @@ Il est supposé que HtmGem est installé à la racine du site dans un répertoir
|
||||
=> /htmgem Lien vers la racine du site
|
||||
|
||||
L’installation est terminée 🥳 La suite du texte donne des informations complémentaires, et n’est pas nécessaire dans l’immédiat. Les fichiers **.gmi** que vous créerez seront disponibles dès maintenant.
|
||||
=> tests/tutogemtext.gmi Inspirez-vous du tutoriel
|
||||
=> tutogemtext.gmi Inspirez-vous du tutoriel
|
||||
|
||||
———————————————————— ————————————————————
|
||||
|
||||
@ -106,7 +113,8 @@ La décoration du texte, qui interprête la mise en forme **gras** par exemple,
|
||||
|
||||
# Quand tout marche…
|
||||
|
||||
Parmi les fichiers et répertoires distribués, seuls sont utiles :
|
||||
* **htmgem/index.php** : Il se charge de traduire le gemtext en HTML
|
||||
Parmi les fichiers et répertoires distribués, seuls sont utiles pour le fonctionnement de HtmGem :
|
||||
* **htmgem/index.php** : Il se charge de traduire le gemtext en HTML.
|
||||
* **htmgem/css/htmgem.css** : S’il manque, l’affichage sera dépourvu de style — littéralement.
|
||||
Les autres peuvent être supprimés (y compris ce présent fichier) bien qu’ils ne présentent aucun danger. Ils restent nécessaires au développement du projet et sont disponibles sur le site de HtmGem. Les autres fichiers du répertoire //css// peuvent servir comme styles alternatifs.
|
||||
* **htmgem/css/… : Conservez les styles que vous utilisez.
|
||||
Les autres peuvent être supprimés (y compris ce présent fichier //index.gmi//) bien qu’ils ne présentent aucun danger.
|
||||
|
||||
186
tests/test.gmi
186
tests/test.gmi
@ -1,186 +0,0 @@
|
||||
# Test page
|
||||
|
||||
* puce
|
||||
=> lien1
|
||||
=> lien2
|
||||
|
||||
```
|
||||
The text as it is in the source code, in a preformatted block.
|
||||
```
|
||||
The text as it is rendered, of course the following examples will have identical preformatted content and rendered content.
|
||||
|
||||
```
|
||||
* single line
|
||||
```
|
||||
* single line
|
||||
|
||||
```
|
||||
* line one
|
||||
* line two
|
||||
```
|
||||
* line one
|
||||
* line two
|
||||
|
||||
```
|
||||
*incorrect list because there's no space right after the star.
|
||||
```
|
||||
*incorrect list because there's no space right after the star.
|
||||
|
||||
```
|
||||
Below, a line with just one star, must be rendered as is.
|
||||
*
|
||||
```
|
||||
Below, a line with just one star, must be rendered as is.
|
||||
*
|
||||
|
||||
```
|
||||
Below, a line with one star and one space, must be a single <li>
|
||||
*
|
||||
```
|
||||
Below, a line with one star and one space, must be a single <li>
|
||||
*
|
||||
|
||||
```
|
||||
Below, a line with one star and two spaces, must be a single <li>
|
||||
*
|
||||
```
|
||||
Below, a line with one star and two spaces, must be a single <li>
|
||||
*
|
||||
|
||||
```
|
||||
Below, two lines with one star, must be single <li>
|
||||
*
|
||||
*
|
||||
```
|
||||
Below, two lines with one star, must be single <li>
|
||||
*
|
||||
*
|
||||
|
||||
```
|
||||
# h1
|
||||
## h2
|
||||
### h3
|
||||
#### h4 (Should be read as h3)
|
||||
```
|
||||
# h1
|
||||
## h2
|
||||
### h3
|
||||
#### h4 (Should be read as h3)
|
||||
|
||||
```
|
||||
Four spaces between the quotes " ", shrinked in HTML
|
||||
```
|
||||
Four spaces between the quotes " ", shrinked in HTML
|
||||
|
||||
```
|
||||
^^^
|
||||
Plain text link: https://website.com/
|
||||
^^^
|
||||
```
|
||||
^^^
|
||||
Plain text link: https://website.com/
|
||||
^^^
|
||||
|
||||
```
|
||||
Link with double slash: http://truc
|
||||
```
|
||||
Link with double slash: http://truc
|
||||
|
||||
```
|
||||
^ Link inside a single non-decorated line: http://truc
|
||||
```
|
||||
^ Link inside a single non-decorated line: http://truc
|
||||
|
||||
```
|
||||
Below this line, just "=>" will be ignored and displayed as is.
|
||||
=>
|
||||
```
|
||||
Below this line, just "=> " will be ignored and displayed as is.
|
||||
=>
|
||||
|
||||
```
|
||||
=> gemini://somesite
|
||||
```
|
||||
=> gemini://somesite
|
||||
|
||||
```
|
||||
=> gemini://somesite label of the website
|
||||
```
|
||||
=> gemini://somesite label of the website
|
||||
|
||||
|
||||
|
||||
Du **gras**…
|
||||
Encore du **gras** !
|
||||
|
||||
__This line starts with two _ and none at the end.
|
||||
The formatting stays in the physical line.
|
||||
|
||||
Below, headers with spaces at the beginning of the line:
|
||||
# Missed h1, there's a space as a first character.
|
||||
# Missed h2, there are two spaces as first characters.
|
||||
|
||||
# Below this line, three empty lines:
|
||||
|
||||
|
||||
|
||||
# Two long lines, without empty line in-between:
|
||||
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
|
||||
Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium doloremque laudantium, totam rem aperiam, eaque ipsa quae ab illo inventore veritatis et quasi architecto beatae vitae dicta sunt explicabo. Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed quia consequuntur magni dolores eos qui ratione voluptatem sequi nesciunt. Neque porro quisquam est, qui dolorem ipsum quia dolor sit amet, consectetur, adipisci velit, sed quia non numquam eius modi tempora incidunt ut labore et dolore magnam aliquam quaerat voluptatem. Ut enim ad minima veniam, quis nostrum exercitationem ullam corporis suscipit laboriosam, nisi ut aliquid ex ea commodi consequatur? Quis autem vel eum iure reprehenderit qui in ea voluptate velit esse quam nihil molestiae consequatur, vel illum qui dolorem eum fugiat quo voluptas nulla pariatur?
|
||||
|
||||
# Some links
|
||||
=> Link_without_label
|
||||
=> Link link with label
|
||||
=>Link_without_label
|
||||
=>Link link with label
|
||||
=>gemini://site.com gemini://site.com
|
||||
|
||||
### Links made of only dots, and spaces after
|
||||
=> .
|
||||
=> ..
|
||||
=> ...
|
||||
|
||||
# Preformatted text
|
||||
``` Preformatted text
|
||||
At vero eos et accusamus et iusto odio dignissimos ducimus qui blanditiis praesentium voluptatum deleniti atque corrupti quos dolores et quas molestias excepturi sint occaecati cupiditate non provident, similique sunt in culpa qui officia deserunt mollitia animi, id est laborum et dolorum fuga. Et harum quidem rerum facilis est et expedita distinctio. Nam libero tempore, cum soluta nobis est eligendi optio cumque nihil impedit quo minus id quod maxime placeat facere possimus, omnis voluptas assumenda est, omnis dolor repellendus. Temporibus autem quibusdam et aut officiis debitis aut rerum necessitatibus saepe eveniet ut et voluptates repudiandae sint et molestiae non recusandae. Itaque earum rerum hic tenetur a sapiente delectus, ut aut reiciendis voluptatibus maiores alias consequatur aut perferendis doloribus asperiores repellat.
|
||||
|
||||
< apt install cowsay >
|
||||
--------------------
|
||||
\ ^__^
|
||||
\ (oo)\_______
|
||||
(__)\ )\/\
|
||||
||----w |
|
||||
|| ||
|
||||
|
||||
<b>Not in HTML bold</b> and not in **markup bold**
|
||||
|
||||
```
|
||||
|
||||
|
||||
# Quotations
|
||||
|
||||
## Two consecutives physical lines of quotations
|
||||
> Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
|
||||
> Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
|
||||
|
||||
## Two separated physical lines of quotations
|
||||
> Quotations: Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
|
||||
|
||||
> Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
|
||||
|
||||
##One line of empty quotation:
|
||||
>
|
||||
|
||||
##Two lines of empty quotations:
|
||||
>
|
||||
>
|
||||
|
||||
|
||||
** Text using <b>.
|
||||
|
||||
//Text using <i>.
|
||||
~~Text using <del>.
|
||||
__Text using <u>.
|
||||
|
||||
Text having words in **bold**, //italic//, ~~deleted~~, __underlined__.
|
||||
And some other mixed: **//bold italic// ~~bold deleted~~** //~~**italic deleted bold.
|
||||
@ -59,25 +59,20 @@ Voici un autre lien, directement visible parce qu’il n’a pas de description
|
||||
=> https://gemini.circumlunar.space/docs/specification.gmi
|
||||
=> https://gemini.circumlunar.space/docs/specification.gmi
|
||||
|
||||
# Ce que j’ai mis en plus…
|
||||
# Ce qu’il y a en plus…
|
||||
|
||||
HtmGem suit les préconisations de Gemini, sauf pour quelques ajouts… Attention, le texte formaté ne s’affiche — à cette heure — que via HtmGem. Vous n’en voyez que les caractères déclenchant le formatage. Mais le texte reste néanmoins lisible.
|
||||
HtmGem suit les préconisations de Gemini, sauf pour le texte formaté. Il ne s’affiche — à cette heure — que via HtmGem. Vous n’en voyez que les caractères déclenchant le formatage. Mais le texte reste néanmoins lisible via un client Gemini.
|
||||
|
||||
^ Quand on veut signifier que le texte est en **gras** on y met des astérisques autour. De même pour les mots __soulignés__, ceux écrits en //italique// ou même quand on les ~~barre~~.
|
||||
Mais j’estime que le format GemText est alors pas assez **expressif** et qu’il se prive de capacités utiles qui ne sont vraiment pas dures à //concevoir//. Idéalement, on tendrait vers l‘édition de livres électroniques.
|
||||
^ Cette **ligne** n‘affiche ~~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.
|
||||
|
||||
Alors voici ce que j’y ajoute :
|
||||
* Par défaut, le texte mis en forme s’applique – 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 formaté avec ^^^ :
|
||||
## Ajouts à la norme :
|
||||
* Par défaut, le texte mis en forme s’applique 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 ^^^ :
|
||||
|
||||
^ Avec un ^ au début de cette ligne le texte apparaît ~~sans~~ la mise en forme.
|
||||
|
||||
# HtmGem
|
||||
|
||||
HtmGem est un programme écrit en Php permettant d’accéder à un serveur web rendant les pages Gemini. Il traduit chaque page Gemini en Html.
|
||||
=> https://git.sr.ht/~sbgodin/htmgem Code source de HtmGem
|
||||
=> https://gmi.sbgodin.fr Ma page personnelle qui utilise HtmGem
|
||||
=> gemini://gmi.sbgodin.fr Ma page personnelle en passant nativement par un programme interprétant Gemini
|
||||
## 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. Gemini utilise son propre protocole, format, clients et serveurs ; HtmGem permet d’en utiliser le format (Gemtext) via le web.
|
||||
=> https://gmi.sbgodin.fr/htmgem
|
||||
|
||||
|
||||
### License de cette page
|
||||
Loading…
Reference in New Issue
Block a user