~callum/gmisub

ref: 26aa0ee43cdbea08d3a41512bf3f88595cf87818 gmisub/gmisub.1.scd -rw-r--r-- 1.2 KiB
26aa0ee4Callum Brown Do not automatically TOFU 1 year, 11 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
gmisub(1)

# NAME

gmisub - Subscribe to Gemini pages

# SYNOPSYS

*gmisub* [-h _path_] [-f _path_] [-d _oldest_date_] _config_path_ _output_path_

# DESCRIPTION

*gmisub* aggregates Gemtext feeds formated according to the "Subscribing to
Gemini pages" specification, which can be found here:++
gemini://gemini.circumlunar.space/docs/companion/subscription.gmi

_config_path_ points to a Gemtext file which lists the Gemini pages that you
would like to subscribe to. Each page should be given as a Gemtext link
(a line beginning with "=>" followed by the URL).

_output_path_ is the file which the generated aggregate will be written to.

*gmisub* uses *gmni*(1)'s TOFU system. All unknown certificates will be trusted
when first seen and added to your Gemini known_hosts file (probably at
~/.local/share/gemini/known_hosts). When a certificate is first trusted a
message will be printed to stdout.

# OPTIONS

*-h* _path_
	Prepend the header file at _path_ to the aggregate.

*-f* _path_
	Append the footer file at _path_ to the aggregate.

*-d* _oldest_date_
	Limit entries included in the aggregate to those on or after the given
	date. The date should be in the form *YYYYMMDD*.