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

75 lines
3.4 KiB
Plaintext
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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
=> https://gmi.sbgodin.fr/ https://gmi.sbgodin.fr/ ⸻ Christophe HENRY