Skip to content

Commit

Permalink
v0.9.1 metadata stuff
Browse files Browse the repository at this point in the history
  • Loading branch information
apjanke committed Apr 9, 2020
1 parent ad45a52 commit 79b2401
Show file tree
Hide file tree
Showing 3 changed files with 18 additions and 11 deletions.
5 changes: 3 additions & 2 deletions CHANGES
Original file line number Diff line number Diff line change
@@ -1,9 +1,10 @@
Ronn-NG CHANGES
===============

Version <TBD>
-------------
Version 0.9.1 (2020 Apr 09)
---------------------------

* Fix underlining issue (https://github.com/apjanke/ronn-ng/pull/41)

Version 0.9.0 (2019 Dec 21)
---------------------------
Expand Down
22 changes: 14 additions & 8 deletions man/ronn.1
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
.\" generated with Ronn-NG/v0.9.1
.\" http://github.com/apjanke/ronn-ng/tree/0.9.1
.TH "RONN" "1" "December 2019" "Ronn-NG 0.9.1" "Ronn Manual"
.TH "RONN" "1" "January 2020" "Ronn-NG 0.9.1" "Ronn Manual"
.SH "NAME"
\fBronn\fR \- convert markdown files to manpages
.SH "SYNOPSIS"
Expand All @@ -13,6 +13,8 @@
\fBronn\fR \fB\-\-pipe\fR \fIfile\fR
.br
\fBronn\fR < \fIfile\fR
.br
\fBronn\fR \fB\-E\fR|\fB\-\-encoding\fR \fIencoding\fR \|\.\|\.\|\.
.SH "DESCRIPTION"
\fBRonn\fR converts textfiles to standard roff\-formatted Unix manpages or HTML\. ronn\-format(7) is based on markdown(7) but includes additional rules and syntax geared toward authoring manuals\.
.P
Expand All @@ -24,13 +26,15 @@ With no \fIfile\fR arguments, \fBronn\fR acts as simple filter\. Ronn source tex
.SH "FILES"
The \fBronn\fR command expects input to be valid ronn\-format(7) text\. Source files are typically named \fIname\fR\.\fIsection\fR\.ronn (e\.g\., \fBexample\.1\.ronn\fR)\. The \fIname\fR and \fIsection\fR should match the name and section defined in the \fIfile\fR\'s heading\.
.P
Source files must be in UTF\-8 encoding, or the encoding specified by the \fB\-E\fR/\fB\-\-encoding\fR option, regardless of the locale that \fBronn\fR is running under\.
.P
When building roff or HTML output files, destination filenames are determined by taking the basename of the input \fIfile\fR and adding the appropriate file extension (or removing the file extension in the case of roff output)\. For example, executing \fBronn example\.1\.ronn\fR generates \fBexample\.1\fR with roff output and \fBexample\.1\.html\fR with HTML output\.
.SH "OPTIONS"
These options control whether output is written to file(s), standard output, or directly to a man pager\.
.IP "\[ci]" 4
\fB\-m\fR, \fB\-\-man\fR: Don\'t generate files, display \fIfile\fRs as if man(1) were invoked on the roff output file\. This simulates default man behavior by piping the roff output through groff(1) and the paging program specified by the \fBMANPAGER\fR environment variable\.
.IP "\[ci]" 4
\fB\-S\fR, \fB\-\-server\fR: Don\'t generate files, start an HTTP server at \fI\%http://localhost:1207/\fR and serve dynamically generated HTML for the set of input \fIfile\fRs\. A file named \fIexample\.2\.ronn\fR is served as \fI/example\.2\.html\fR\. There\'s also an index page at the root with links to each \fIfile\fR\.
\fB\-S\fR, \fB\-\-server\fR: Don\'t generate files, start an HTTP server at \fIhttp://localhost:1207/\fR and serve dynamically generated HTML for the set of input \fIfile\fRs\. A file named \fIexample\.2\.ronn\fR is served as \fI/example\.2\.html\fR\. There\'s also an index page at the root with links to each \fIfile\fR\.
.IP
The server respects the \fB\-\-style\fR and document attribute options (\fB\-\-manual\fR, \fB\-\-date\fR, etc\.)\. These same options can be varied at request time by giving them as query parameters: \fB?manual=FOO&style=dark,toc\fR
.IP
Expand All @@ -41,6 +45,8 @@ The server respects the \fB\-\-style\fR and document attribute options (\fB\-\-m
\fB\-\-pipe\fR: Don\'t generate files, write generated output to standard output\. This is the default behavior when ronn source text is piped in on standard input and no \fIfile\fR arguments are provided\.
.IP "\[ci]" 4
\fB\-o\fR=\fIdirectory\fR, \fB\-\-output\-dir\fR=\fIdirectory\fR: Write generated files to the specified directory instead of the default location\.
.IP "\[ci]" 4
\fB\-E\fR=\fIencoding\fR, \fB\-\-encoding\fR=<encoding: Specify the encoding that input files are in\. Default is UTF\-8, regardless of user\'s locale settings\. Input sent to STDIN is always treated as UTF\-8, regardless of whether \fB\-E\fR is passed\.
.IP "" 0
.P
Format options control the files \fBronn\fR generates, or the output format when the \fB\-\-pipe\fR argument is specified\. When no format options are given, both \fB\-\-roff\fR and \fB\-\-html\fR are assumed\.
Expand All @@ -54,7 +60,7 @@ Generate output in HTML format\.
\fB\-f\fR, \fB\-\-fragment\fR
Generate output in HTML format but only the document fragment, not the header, title, or footer\.
.P
Document attributes displayed in the header and footer areas of generated content are specified with these options\. (These values may also be set via the \fI\%#ENVIRONMENT\fR\.)
Document attributes displayed in the header and footer areas of generated content are specified with these options\. (These values may also be set via the \fIENVIRONMENT\fR\.)
.TP
\fB\-\-manual\fR=\fImanual\fR
The name of the manual this man page belongs to; \fImanual\fR is prominently displayed top\-center in the header area\.
Expand All @@ -70,11 +76,11 @@ HTML output can be customized through the use of CSS stylesheets:
\fB\-\-style\fR=\fImodule\fR[,\fImodule\fR]\|\.\|\.\|\.
The list of CSS stylesheets to apply to the document\. Multiple \fImodule\fR arguments may be specified, but must be separated by commas or spaces\.
.IP
When \fImodule\fR is a simple word, search for files named \fImodule\fR\fB\.css\fR in all directories listed in the \fI\%#ENVIRONMENT\fR environment variable, and then search internal styles\.
When \fImodule\fR is a simple word, search for files named \fImodule\fR\fB\.css\fR in all directories listed in the \fI\fBRONN_STYLE\fR\fR environment variable, and then search internal styles\.
.IP
When \fImodule\fR includes a \fI/\fR character, use it as the full path to a stylesheet file\.
.IP
Internal styles are \fIman\fR (included by default), \fItoc\fR, and \fI80c\fR\. See \fI\%#STYLES\fR for descriptions of features added by each module\.
Internal styles are \fIman\fR (included by default), \fItoc\fR, and \fI80c\fR\. See \fISTYLES\fR for descriptions of features added by each module\.
.P
Miscellaneous options:
.TP
Expand Down Expand Up @@ -143,7 +149,7 @@ The heading and footing, respectively\.
\fB\.man\-title\fR
The main \fB<h1>\fR element\. Hidden by default unless the manual has no \fIname\fR or \fIsection\fR attributes\.
.P
See the builtin style sources \fI\%http://github\.com/apjanke/ronn\-ng/tree/master/lib/ronn/template\fR for examples\.
See the builtin style sources \fIhttp://github\.com/apjanke/ronn\-ng/tree/master/lib/ronn/template\fR for examples\.
.SH "EXAMPLES"
Build roff and HTML output files and view the roff manpage using man(1):
.IP "" 4
Expand Down Expand Up @@ -189,7 +195,7 @@ $ ronn \-\-man hello\.1\.ronn
.fi
.IP "" 0
.P
Serve HTML manpages at \fI\%http://localhost:1207/\fR for all \fB*\.ronn\fR files under a \fBman/\fR directory:
Serve HTML manpages at \fIhttp://localhost:1207/\fR for all \fB*\.ronn\fR files under a \fBman/\fR directory:
.IP "" 4
.nf
$ ronn \-\-server man/*\.ronn
Expand All @@ -216,6 +222,6 @@ The paging program used for man pages\. This is typically set to something like
\fBPAGER\fR
Used instead of \fBMANPAGER\fR when \fBMANPAGER\fR is not defined\.
.SH "COPYRIGHT"
Ronn\-NG is Copyright (C) 2009 Ryan Tomayko \fI\%http://tomayko\.com/about\fR and (C) 2018 Andrew Janke \fI\%https://apjanke\.net\fR
Ronn\-NG is Copyright (C) 2009 Ryan Tomayko \fIhttp://tomayko\.com/about\fR and (C) 2018 Andrew Janke \fIhttps://apjanke\.net\fR
.SH "SEE ALSO"
groff(1), man(1), pandoc(1), manpages(5), markdown(7), roff(7), ronn\-format(7)
2 changes: 1 addition & 1 deletion ronn-ng.gemspec
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
Gem::Specification.new do |s|
s.name = 'ronn-ng'
s.version = '0.9.1'
s.date = '2020-01-29'
s.date = '2020-04-09'

s.summary = 'Builds man pages from Markdown'
s.description = 'Ronn-NG builds manuals in HTML and Unix man page format from Markdown.'
Expand Down

0 comments on commit 79b2401

Please sign in to comment.