Re: Z shell introductory guide source

[Clinton Bunch <cdb_zsh@xxxxxxxxxxx>]

BTW, just realized in my previous e-mail, I forgot to say thanks for 
your work on improving the roff file html output.

On 10/9/2024 08:32, Clinton Bunch wrote:
> On 10/9/2024 08:14, Jun. T wrote:
> > The patch below has two objectives:
> >
> > For intro.html:
> > Almost same as my previous patch. Use conditional ".if \n[HTML]"
> > so that the same ms file can be used for both pdf and html.
> > I don't know why we need different macros for html and pdf.
> >
> > For intro.pdf:
> > Use -mspdf instead of -ms, and .XN instead of .XS/.XE. This adds an
> > Index to the pdf that can be accessed via the side panel (side bar)
> > of PDF viewers (evince, Preview.app, etc.).
> > -no-kill-null-pages is to retain blank pages after the cover page
> > and before the TOC; these are useful only for those who actually
> > print the pdf to double-sided papers.
> >
> > I will push this if no one has found a better ms->html converter than
> > groff -ms -Thtml.
> > # Manpage of grohtml(1) (groff's html driver) says, in the Bugs section,
> > # "grohtml is still beta code." It may improve in the future, hopefully.
> I have a first-cut at a post-processor for intro.html (I was unable to 
> find anything better than grohtml)  The results of the current version 
> can be seen at https://zsh.clintonbunch.name/Intro/intro-new.html
>
> I also looked for an HTML to PDF converter that could maintain 
> internal links, but didn't come across anything, with an eye to 
> possibly changing the format of record of the guide.