119 lines
3.5 KiB
Groff
119 lines
3.5 KiB
Groff
.\" Generated by scdoc 1.10.1
|
|
.\" Complete documentation for this program is not available as a GNU info page
|
|
.ie \n(.g .ds Aq \(aq
|
|
.el .ds Aq '
|
|
.nh
|
|
.ad l
|
|
.\" Begin generated content:
|
|
.TH "gmi-web" "1" "2021-02-12" "1.0.0-rc.2"
|
|
.P
|
|
.SH NAME
|
|
.P
|
|
gmi-web - a bridge between Gemini and HTML
|
|
.P
|
|
.SH SYNOPSIS
|
|
.P
|
|
\fBgmi-web\fR [--html|--body] <\fIOPTIONS\fR> < [\fIFILE\fR]
|
|
.P
|
|
\fBgmi-web\fR [--html|--body] <\fIOPTIONS\fR> [\fIFILES\fR]
|
|
.P
|
|
.SH DESCRIPTION
|
|
.P
|
|
Convert Gemtext to semantic HTML styled in a readable, predictable
|
|
and mobile-friendly fashion!
|
|
.P
|
|
.SH OPTIONS
|
|
.P
|
|
\fB--html\fR \fILANG\fR
|
|
.RS 4
|
|
Generate a full HTML5 document with the provided \fILANG\fR.
|
|
.P
|
|
\fBgmi-web\fR --html en < doc.gmi
|
|
.P
|
|
.RE
|
|
\fB--descriptions\fR
|
|
.RS 4
|
|
If this flag is set the first non-empty text line of each Gemini file will
|
|
be used for the description <meta> tag. This will be truncated to 200
|
|
characters using an ellipsis.
|
|
.P
|
|
.RE
|
|
\fB--author\fR
|
|
.RS 4
|
|
If provided this will be used for the author <meta> tag on every file.
|
|
.P
|
|
.RE
|
|
\fB--body\fR
|
|
.RS 4
|
|
Generate only the HTML for the lines of the Gemini document.
|
|
.P
|
|
\fBgmi-web\fR --body < doc.gmi
|
|
.P
|
|
.RE
|
|
\fB--css\fR \fIMODE\fR
|
|
.RS 4
|
|
By default this will be set to \fBgmi.css\fR. Choosing \fBbase\fR will use just what
|
|
is needed to fix issues with CSS 2.1's Normal Flow. Choosing \fBnone\fR will not
|
|
include any style information and inline elements will be wrapped in <p>.
|
|
.P
|
|
.RE
|
|
\fBgmi.css\fR
|
|
.RS 4
|
|
See --help or gmi.css(5) for the complete list of customizable styles.
|
|
.P
|
|
\fBgmi-web\fR --html en --foreground "#555555" --background "#9EEBCF" < doc.gmi
|
|
.P
|
|
.RE
|
|
\fB[--image|--audio|--video]\fR \fIEXENSIONS\fR
|
|
.RS 4
|
|
Include the provided \fIEXTENSIONS\fR as inline media according to the flag used.
|
|
You can provide multiple extensions per flag or multiple flags per extension.
|
|
.P
|
|
\fBgmi-web\fR --image jpg png --audio mp3 --html en < doc.gmi
|
|
.P
|
|
\fBgmi-web\fR --image jpg --image png --audio mp3 --html en < doc.gmi
|
|
.P
|
|
.RE
|
|
\fB--config\fR [\fIJSON\fR]
|
|
.RS 4
|
|
All the options documented here and by \fB--help\fR may be captured in a .json
|
|
file and passed to \fB--config\fR instead of as flags on the command-line.
|
|
.P
|
|
\fBgmi-web\fR --config web.json < doc.gmi
|
|
.P
|
|
.RE
|
|
.SH SEE ALSO
|
|
.P
|
|
\fBgmi.css\fR(5)
|
|
.P
|
|
.SH AUTHORS
|
|
.P
|
|
Maintained by Talon Poole <code@talon.computer>. Up-to-date sources can be
|
|
found at https://codeberg.org/talon/gmi-web
|
|
.P
|
|
.SH COPYRIGHT
|
|
This is free and unencumbered software released into the public domain.
|
|
.P
|
|
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.
|
|
.P
|
|
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.
|
|
.P
|
|
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.
|
|
.P
|
|
For more information, please refer to <http://unlicense.org/>
|