Re: (off topic?) Docbook? Re: manlint?

[John Gardner]

>
> Got a “this debug view expired” response.


Ugh. Try https://codepen.io/alhadis/full/WNwWrOP instead; I was trying to
omit that stupid toolbar at the top…



> I don’t suppose that’s a straight conversion…


Nope, not at all. It's a hand-written portrayal of what I consider to be a
"perfect" rendition of a man page in HTML.

On Mon, 28 Sep 2020 at 12:29, Larry Kollar <kollar@windstream.net> wrote:

>
> John Gardner <gardnerjohng@gmail.com> wrote:
>
> > Ironically, modern HTML isn't too dissimilar to nroff(1) output.
>
> True. Upon seeing HTML for the first time (around 1986 if IIRC) I was
> struck
> by the similarities between it and the -mm macros.
>
> > … instead of trying to preserve fonts, colours, margins and columns when
> > generating an HTML version of a Roff file, forget about such details in
> > favour of a separate (hand-written) stylesheet. It doesn't take much CSS
> to
> > establish the look-and-feel of the equivalent PDF output: Here's how I'd
> > render mandoc(1)'s manual page in HTML (without actually using mandoc…
> > sorry Ingo ;-))
> >
> >
> >   - Document content
> >   <
> https://github.com/Alhadis/Stylesheets/blob/efd0e965f0d45839ba0505a7db6dcb7ce17b616e/complete/manpage/example.html
> >
>
> I don’t suppose that’s a straight conversion… if it is, you’ve pretty much
> implemented what James was talking about.
>
> >   - Stylesheet
> >   <
> https://github.com/Alhadis/Stylesheets/blob/efd0e965f0d45839ba0505a7db6dcb7ce17b616e/complete/manpage/manpage.css
> >
> >
> > Here's how it all looks <
> https://cdpn.io/alhadis/debug/WNwWrOP/bYAdyXEXeXGk>.
>
> Got a “this debug view expired” response. One of the nice things about
> running
> a static website out of S3, you don’t get that kind of garbage. :-P
>
> — Larry
>
>
>