Go to file
Adële 123d524c5d Merge pull request 'Add a simple gemserv config parser' (#6) from rdelaage/ergol-http:gemservConfig into main
Reviewed-on: https://codeberg.org/adele.work/ergol-http/pulls/6
2021-05-25 21:16:21 +02:00
.gitignore minor adapation and doc 2021-04-03 06:41:20 +02:00
.htaccess minor adapation and doc 2021-04-03 06:41:20 +02:00
LICENSE Initial commit 2021-04-02 18:29:58 +02:00
README.md adding screenshot 2021-04-03 06:49:41 +02:00
TwitterColorEmoji-SVGinOT.ttf add files 2021-04-02 21:10:46 +02:00
changelog.gmi add files 2021-04-02 21:10:46 +02:00
config-sample.php Gemserv config parser should be finished 2021-05-25 20:21:31 +02:00
ergol-http-screenshot.png Refresh readme screenshot 2021-04-21 18:21:27 +02:00
index.php Gemserv config parser should be finished 2021-05-25 20:21:31 +02:00
style.css Better style for blockquote and preformatted block 2021-05-05 07:34:49 +02:00
template.php Add template file 2021-05-23 13:24:57 +02:00

README.md

ergol-http

Ergol companion to serve #gemini capsules through http/https. It is a http wrapper written in php, working with ergol gemini server or standalone.

Screenshot of a web browser using ergol-http

author : Adële

ergol-http is under MIT/X Consortium License

ergol-http uses and provides a copy of Twitter Emoji aka twemoji packaged in a TrueType font format. twemoji is also published under MIT license.

Main repository on Codeberg.

Installation

Clone repository or unzip archive and copy main files in the document root of your website. Copy config-sample.php to config.php and change edit config.php to adapt it.

cd ~/
git clone https://codeberg.org/adele.work/ergol-http.git
cd ergol-http
cp index.php style.css TwitterColorEmoji-SVGinOT.ttf .htaccess /var/www/
cp config-sample.php /var/www/config.php
nano /var/www/config.php

Web server needs to support url rewriting. Rule is present in .htaccess.

In Apache config:

RewriteEngine on
RewriteRule   "^/(.*)"  "/?q=$1"  [R,L]

In lighttpd config:

server.modules += ("mod_rewrite")
url.rewrite-once = ( "^/(.*)" => "/?q=/$1"  )

It is also possible to run ergol-http with php embedded web server (not the recommended way).

php -S 0.0.0.0:8080 -t ./ ./index.php

Upgrade

Get the last version the same way as installation but do not overwrite your config.php, check if there are new constants in config-sample.php and add them into your config.php.