HtmGem/docs/installation-en.gmi

45 lines
1.2 KiB
Plaintext
Raw Normal View History

2022-08-01 09:15:30 +00:00
# To install HtmGem
2021-03-27 22:31:47 +00:00
2022-08-01 09:15:30 +00:00
* Download HtmGem
=> https://tildegit.org/sbgodin/HtmGem/archive/master.zip
* Copy the files at the root of the website.
* Configurer la réécriture dURL (//URL Rewriting//).
* Write some text in /index.gmi.
* Just open your website!
2021-03-27 22:31:47 +00:00
2022-08-01 09:15:30 +00:00
* Go to /htmgem to get the documentation.
2021-03-27 22:31:47 +00:00
2022-08-01 09:15:30 +00:00
### Prerequisites
2021-03-27 22:31:47 +00:00
2022-08-01 09:15:30 +00:00
* Php v7.3 minimum
* Module **Php-mbstring** to handle lunicode
* A web server (Apache and Nginx supported)
* Module **mod-rewrite** for the URL rewriting
2021-03-27 22:31:47 +00:00
### Nginx
```
2021-03-28 19:50:36 +00:00
index index.gmi index.php index.html
2022-08-01 09:15:30 +00:00
rewrite ^(.+\.gmi)$ /htmgem/index.php?rw=1&url=$1&style=default,htmgem.css;
error_page 403 /htmgem;
location = /favicon.ico { alias /var/www/dev/htmgem/favicon.ico; }
2021-03-27 22:31:47 +00:00
```
### Apache
```
2021-03-28 19:50:36 +00:00
DirectoryIndex index.gmi index.php index.html
2021-03-27 22:31:47 +00:00
RewriteEngine on
2022-08-01 09:15:30 +00:00
rewriteRule ^(.+\.gmi)$ htmgem/index.php?rw=1&url=$1&style=default,htmgem.css
2021-03-27 22:31:47 +00:00
```
2022-08-01 09:15:30 +00:00
## 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.
It's possible to disable the text decoration with a line **^^^** or add to the URL rewriting:
> &textDecoration=0
2021-03-27 22:31:47 +00:00
2022-08-01 09:15:30 +00:00
=> ../css Styles
2021-03-27 22:31:47 +00:00
2022-08-01 09:15:30 +00:00
=> tutogemtext-en.gmi How to make GemText pages?