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

Re: Modernizing Documentation format?



On 8/21/2025 09:06, Peter Aronoff wrote:
On 8/21/2025 06:12, Marc Chantreux wrote:
also: installing the whole python thing just to fix typos could be a
bit boring.
This is tangential, but Pandoc may be helpful here. It can translate to
and from RST and produce various output formats (HTML, pdf, etc.).

Yes, then you would have to install Pandoc, but I think that’s easier to
do than installing Python, Sphinx, etc. (Pandoc is a single binary.)

But you have the choice.  My experience is that most linux systems come with python installed, and other UNIX has a native package for it.  Sphinx is very flexible in it's output styling. I haven't seen how easy Pandoc's HTML is to integrate into a web site design.  Though IIRC, its PDF output involves a TeX install. (So does sphinx's default but rst2pdf plugin does not.)  pip install -r requirements.txt takes care of installing the python modules and scripts


At this point nothing but yodl can translate YODL.  And we're maintaining the Texinfo output.  The maintainer abandoned it several years ago.


https://pandoc.org and https://pandoc.org/installing.html






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