html2gmi

A command line application to convert HTML to GMI (Gemini text/gemini), written in Go.

A simple wrapper around the Go library https://github.com/LukeEmmet/html2gemini

Usage

html2gmi <flags>

  -c, --citationStart int       Start citations from this index (default 1)
  -i, --input string            Input path. Otherwise uses stdin
  -l, --linkEmitFrequency int   Emit gathered links through the document after this number of paragraphs (default 2)
  -m  --citationMarkers         Output citation style markers 
  -o, --output string           Output path. Otherwise uses stdout
  -v, --version                 Find out what version of html2gmi you're running
  

Remarks

linkEmitFrequency - this flag determines the frequency of the output of link lists. For example 1 means any links from the previous paragraph are emitted after each paragraph. 2, would mean they are emitted every two paragraphs and so on. Any gathered links are always emitted before a new heading.

citationStart - this flag determines the start index of the links. By default this is 1, so the first link is labelled “[1]”, but you can set this as required.

You can pipe content in from other applications, for example utilities that download HTML from the web.

To strip out cruft, you can use an HTML sanitiser before passing the content to this app.

Building

Compile using Go.

Retrieve the package using Go get

go get github.com/LukeEmmet/html2gmi

Build the binary using Go build

go build github.com/LukeEmmet/html2gmi