md2html: Add ability to select tool, always create toc, improve pandoc

linux-system-roles / auto-maintenance

Linux system roles wide automated repo maintenance

MIT License

25 stars 15 forks source link

md2html: Add ability to select tool, always create toc, improve pandoc #290

Closed spetrosi closed 1 year ago

spetrosi commented 1 year ago

You can now provide set md2html_tool to kramdown or pandoc to use a specific tool
Toc is always created both on pandoc and kramdown
Pandoc converts directly to html using a template

richm commented 1 year ago

Can you provide an example of what this looks like?

spetrosi commented 1 year ago

Archive with mssql README previews for kramdown, pandoc-old, and pandoc-new that this PR introduces. READMEs.zip

spetrosi commented 1 year ago

Last time I built kramdown without toc, here is with toc READMEs.zip

richm commented 1 year ago

hmm - I don't like the pandoc-new - it only uses the middle third of the screen - very wide margins - I like the old style where there are no side margins

spetrosi commented 1 year ago

hmm - I don't like the pandoc-new - it only uses the middle third of the screen - very wide margins - I like the old style where there are no side margins

This can be fixed by removing -width:980px; from the template. I guess it'd be better to copy the template to auto-maintenance.

spetrosi commented 1 year ago

md2html will soon be obsolete after I remove it from spec. Instead, tox env should be used for convention, see https://github.com/linux-system-roles/tox-lsr/pull/133