~chambln/gmi

ref: 36a5ea1e3fabd37af5f050a55224fd56de9168bc gmi/README.gmi -rw-r--r-- 1.5 KiB
36a5ea1eGregory Chamberlain Undo 3f2f3fb (Add Web link to the Project Gemini server) 2 months ago
                                                                                
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
# gmi

Tiny Gemini browser written in POSIX-compliant shell.

=> gemini://gemini.circumlunar.space Project Gemini

## Dependencies

* POSIX shell and command utilities
* openssl
* less
* fzf

## Installation

Install for all users (as root):

```
make install
```

Install for this user only:

```
make PREFIX=~/.local install
```

## Usage

See gmi(1).

## Known issues

* When visiting files on disk, relative references will not necessarily
  work properly.  This is because these links are (erroneously) followed
  relative to the directory we are in rather than that of the file itself.
* The ‘Reload’ option does not work properly when visiting a Gemini
  page whose URI was given on the command-line without the ‘gemini://’
  scheme prefix.  Simply prepending the scheme after the fact is not a
  correct solution because it looks like it could be a relative link anyway.
  One potential solution to this is to make the scheme mandatory, which
  would also make some other aspects of the program implementation simpler.
* Arguably a feature but the ‘Back’ button only remembers the last
  resource you visited, even if you came ‘Back’ from that
  resource.  So you cannot always return where you started by
  repeatedly going ‘Back’ -- instead you’ll just toggle back
  and forth between two resources.
* Dot (.) and dot-dot (..) segments in links are not (yet) resolved.
  Some Gemini servers will resolve it for you (e.g. Agate I believe).
  Others are less lenient.