Zsh Mailing List Archive
Messages sorted by: Reverse Date, Date, Thread, Author

Re: Z shell introductory guide source



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.





Messages sorted by: Reverse Date, Date, Thread, Author