diff --git a/gmi-web.1.scd b/gmi-web.1.scd index c3a0c05..c460c88 100644 --- a/gmi-web.1.scd +++ b/gmi-web.1.scd @@ -1,4 +1,4 @@ -gmi-web(1) "1.0.0-rc.3" +gmi-web(1) # NAME @@ -8,7 +8,7 @@ gmi-web - A bridge between Gemini and HTML *gmi-web* _OPTIONS_ < _FILE_ -*gmi-web* _OPTIONS_ _FILES_ +*gmi-web* _OPTIONS_ _FILES.._ # DESCRIPTION @@ -18,7 +18,7 @@ fashion! # OPTIONS *--body* - Generate just the HTML for the lines of the Gemini document. + Generate just the HTML blocks for the lines of the Gemini document. *--html* _LANG_ Generate a full HTML5 document with the provided _LANG_. *--dir* can be used @@ -26,12 +26,12 @@ fashion! Use *--author* _NAME_ to set the author tag on every file. - Use *--descriptions* _LIMIT_ to apply the first non-empty text line of each - file as the description tag. _LIMIT_ will be used to truncate the text + Use *--descriptions* [_LIMIT_] to apply the first non-empty text line of each + file as the description tag. _LIMIT_ may be used to truncate the text with an ellipsis at that number of characters. -*--css* [_MODE_|_FILE_] - By default this will be set to *full* enabling a handful of customizable +*--css* _MODE_|_FILE_ + *--html* will default _MODE_ to *full* enabling a handful of font and color variables. See *--help* for the complete list. ``` @@ -40,20 +40,18 @@ gmi-web --html en \\ --background "#9EEBCF" < doc.gmi ``` - Choosing *core* will use just what is needed to fix vertical layout issues - with CSS 2.1's Normal Flow and inline elements. Choosing *none* will not - include any style information. + *--body* will default _MODE_ to *core* and use just what is needed to fix + CSS Normal Flow quirks. + + Pointing to a CSS _FILE_ will use those styles. This works with *--body* or + *--inline*. *--inline* will insert the declarations as "style" properties on their - respective tags. This is the sole behavior when using *--body* and can be - turned off by using --css *none*. When using --css *full* this feature is - unavailable. + respective blocks. This is the only behavior when using *--body*. - Pointing to a .css _FILE_ will use those styles and works with *--body* or - *--inline*. You may want to use *--schemes* to include the tag for - the light and dark schemes. + Choosing *none* will not include any style information. -*[--image|--audio|--video]* _EXTENSIONS_ +*--image|--audio|--video* _EXTENSIONS_ Include media extensions inline. You can provide multiple extensions per flag or multiple flags per extension.