gmitohtml-upstream/README.md

46 lines
1.3 KiB
Markdown
Raw Permalink Normal View History

2020-11-21 17:53:04 +01:00
# gmitohtml
2021-04-08 05:49:29 +02:00
[![GoDoc](https://code.rocketnine.space/tslocum/godoc-static/-/raw/master/badge.svg)](https://docs.rocketnine.space/code.rocketnine.space/tslocum/gmitohtml/pkg/gmitohtml)
2020-11-21 17:53:04 +01:00
[![Donate](https://img.shields.io/liberapay/receives/rocketnine.space.svg?logo=liberapay)](https://liberapay.com/rocketnine.space)
2020-11-23 02:54:44 +01:00
[Gemini](https://gemini.circumlunar.space) to [HTML](https://en.wikipedia.org/wiki/HTML)
conversion tool and daemon
2020-11-21 17:53:04 +01:00
## Download
2020-11-24 18:39:55 +01:00
[**Download gmitohtml**](https://gmitohtml.rocketnine.space/download/?sort=name&order=desc)
2021-04-08 05:49:29 +02:00
gmitohtml is available on Android as [Xenia](https://code.rocketnine.space/tslocum/xenia).
2020-11-24 18:39:55 +01:00
## Compile
2020-11-21 17:53:04 +01:00
gmitohtml is written in [Go](https://golang.org). Run the following command to
download and build gmitohtml from source.
```bash
2021-04-08 05:49:29 +02:00
go get code.rocketnine.space/tslocum/gmitohtml
2020-11-21 17:53:04 +01:00
```
The resulting binary is available as `~/go/bin/gmitohtml`.
2020-11-24 18:29:57 +01:00
## Configure
2021-04-08 05:49:29 +02:00
See [CONFIGURATION.md](https://code.rocketnine.space/tslocum/twins/src/branch/master/CONFIGURATION.md)
2020-11-24 18:29:57 +01:00
2020-11-21 17:53:04 +01:00
## Usage
2020-11-23 03:32:29 +01:00
Run daemon at [http://localhost:1967](http://localhost:1967):
2020-11-21 17:53:04 +01:00
```bash
2020-11-23 03:32:29 +01:00
gmitohtml --daemon=localhost:1967
2020-11-21 17:53:04 +01:00
```
2020-11-23 03:32:29 +01:00
Convert a single document:
2020-11-21 17:53:04 +01:00
```bash
2020-11-23 03:32:29 +01:00
gmitohtml < document.gmi
2020-11-21 17:53:04 +01:00
```
## Support
2021-04-08 05:49:29 +02:00
Please share issues and suggestions [here](https://code.rocketnine.space/tslocum/gmitohtml/issues).