2021-01-29 19:55:24 +00:00
|
|
|
gmi-web(1) "1.0.0"
|
2021-01-28 06:09:49 +00:00
|
|
|
|
|
|
|
# NAME
|
|
|
|
|
2021-01-29 19:55:24 +00:00
|
|
|
gmi-web - A bridge between Gemini and HTML.
|
2021-01-28 06:09:49 +00:00
|
|
|
|
|
|
|
# SYNOPSIS
|
|
|
|
|
2021-01-29 23:27:39 +00:00
|
|
|
*gmi-web* [--lang] <_OPTIONS_> [_FILES_]
|
2021-01-28 17:56:02 +00:00
|
|
|
|
|
|
|
# DESCRIPTION
|
|
|
|
|
2021-01-29 19:55:24 +00:00
|
|
|
Convert Gemtext to semantic HTML styled in a readable, predictable
|
2021-01-28 06:34:23 +00:00
|
|
|
and mobile-friendly fashion!
|
2021-01-28 06:09:49 +00:00
|
|
|
|
2021-01-28 17:56:02 +00:00
|
|
|
# OPTIONS
|
|
|
|
|
2021-01-29 23:27:39 +00:00
|
|
|
*--lang*
|
2021-01-29 23:17:25 +00:00
|
|
|
Required for <meta languge="">
|
|
|
|
|
2021-01-29 22:32:30 +00:00
|
|
|
*CSS Variables*
|
2021-01-29 19:55:24 +00:00
|
|
|
Any variable documented in *gmi.css*(5) can be set via _OPTIONS_ of the same
|
|
|
|
name.
|
|
|
|
|
2021-01-29 23:27:39 +00:00
|
|
|
*gmi-web* --lang "en" --foreground "#FFFFF" --background "#00000" $(find . -name \*.gmi)
|
2021-01-29 19:55:24 +00:00
|
|
|
|
2021-01-29 23:59:12 +00:00
|
|
|
*--config* [_JSON_]
|
|
|
|
All the options documented here and by *--help* may be captured in a .json
|
|
|
|
file and passed to *--config*.
|
|
|
|
|
2021-01-29 22:32:30 +00:00
|
|
|
*--images* *--audio* *--video*
|
|
|
|
Include the respective media inline.
|
2021-01-29 00:24:22 +00:00
|
|
|
|
2021-01-28 17:56:02 +00:00
|
|
|
*--no-css*
|
2021-01-29 23:59:12 +00:00
|
|
|
Use only the bare minimum <style>
|
2021-01-28 17:56:02 +00:00
|
|
|
|
2021-01-29 22:32:30 +00:00
|
|
|
# EXAMPLES
|
|
|
|
|
2021-01-29 22:36:30 +00:00
|
|
|
Render .html for all the .gmi files in the current directory
|
2021-01-29 06:15:23 +00:00
|
|
|
|
2021-01-29 22:32:30 +00:00
|
|
|
```
|
2021-01-29 23:27:39 +00:00
|
|
|
gmi-web --lang en $(find . -name \*.gmi)
|
2021-01-29 22:32:30 +00:00
|
|
|
```
|
2021-01-28 17:56:02 +00:00
|
|
|
|
2021-01-29 23:59:12 +00:00
|
|
|
To use *--config* you will need a .json file with the flags you want to be
|
|
|
|
included.
|
|
|
|
|
|
|
|
```
|
|
|
|
{
|
|
|
|
"language": "en",
|
|
|
|
"foreground": "#137752",
|
|
|
|
"background": "#F4F4F4"
|
|
|
|
}
|
|
|
|
```
|
|
|
|
|
|
|
|
Then give the path to *gmi-web* --config.
|
|
|
|
|
|
|
|
```
|
|
|
|
gmi-web --config /path/to/my.json $(find . -name \*.gmi)
|
|
|
|
```
|
|
|
|
|
|
|
|
|
2021-01-29 19:55:24 +00:00
|
|
|
# SEE ALSO
|
2021-01-28 17:56:02 +00:00
|
|
|
|
2021-01-29 19:55:24 +00:00
|
|
|
*gmi.css*(5)
|
2021-01-28 17:56:02 +00:00
|
|
|
|
2021-01-28 06:09:49 +00:00
|
|
|
# AUTHORS
|
|
|
|
|
|
|
|
Maintained by Talon Poole <code@talon.computer>. Up-to-date sources can be
|
|
|
|
found at https://codeberg.org/talon/gmi-web
|
2021-01-28 17:56:02 +00:00
|
|
|
|
|
|
|
# COPYRIGHT
|
|
|
|
This is free and unencumbered software released into the public domain.
|
|
|
|
|
|
|
|
Anyone is free to copy, modify, publish, use, compile, sell, or
|
|
|
|
distribute this software, either in source code form or as a compiled
|
|
|
|
binary, for any purpose, commercial or non-commercial, and by any
|
|
|
|
means.
|
|
|
|
|
|
|
|
In jurisdictions that recognize copyright laws, the author or authors
|
|
|
|
of this software dedicate any and all copyright interest in the
|
|
|
|
software to the public domain. We make this dedication for the benefit
|
|
|
|
of the public at large and to the detriment of our heirs and
|
|
|
|
successors. We intend this dedication to be an overt act of
|
|
|
|
relinquishment in perpetuity of all present and future rights to this
|
|
|
|
software under copyright law.
|
|
|
|
|
|
|
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
|
|
|
|
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
|
|
|
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
|
|
|
|
IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
|
|
|
|
OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
|
|
|
|
ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
|
|
|
|
OTHER DEALINGS IN THE SOFTWARE.
|
|
|
|
|
|
|
|
For more information, please refer to <http://unlicense.org/>
|