Text.Gemini.Web

A tiny Gemtext to HTML converter for gemmula.

Encodes parsed Gemtext documents and lines as HTML Text.

Encoding documents

encode :: GemDocument -> Text

Encode parsed GemDocument as a HTML file. The output Text uses LF-endings. Uses the prettyItem function below.

Valid HTML characters are escaped before encoding.

Empty GemLists are ignored and empty GemTexts are replaced with /.

Encoding single items

prettyItem :: GemItem -> Text

Encode a single parsed GemItem as HTML text. The output Text uses LF-endings and might be multiple lines.

Valid HTML characters are escaped before encoding.

Unlike encodeItem, long lines (> 80) will be split to multiple lines to make it look prettier. Empty GemTexts are also replaced with /.

Links have a "scheme" attribute set to "gemini" if the scheme of the URI is gemini://, to make them stylable with CSS.

Beware that the output text doesn't end with a newline.

encodeItem :: GemItem -> Text

Encode a single parsed GemItem as HTML text. The output Text uses LF-endings and might be multiple lines.

Valid HTML characters are escaped before encoding.

Beware that the output text doesn't end with a newline.

Rewriting links

rewriteLink :: GemItem -> GemItem

Rewrite .gmi links as .html links.

Beware that this only applies to local GemLinks. For rewriting non-local links as http, see webifyLink.

webifyLink :: GemItem -> IO GemItem

Rewrite gemini:// link as http:// if it can be reached over HTTP.

This is only useful if the specified link has a proxied mirror (like geminiprotocol.net).

Does nothing if the link is local or can't be reached.

Other

getTitle :: GemDocument -> Maybe Text

Get the text of the first h1 in the document, if there's any.

Useful for using as title.