Configure external helpers via output formats

[florisdf]

Hi,

The support of pandoc adds many options to possible output formats for Hugo. However, it is now limited to html output. I guess an incredible amount of flexibility would be added when external helpers, like pandoc, can be configured via the output formats configuration, e.g.

[mediaTypes]
  [mediaTypes."text/tex"]
    suffixes = ["tex"]
    
[outputFormats]
  [outputFormats.TeX]
    mediaType = "text/tex"
    helper = "pandoc"
    helperArgs = ["-t latex"]

This would make for a hassle-free way to generate PDF versions of web pages.

Or is this beyond the scope of Hugo?

[bep]

So your general idea is great. We should definitively connect the "content renderer" (let us worry about the terms (as used in the config struct) later, but the "helper" is not great).

• We currently have a one-to-many from output format to "content renderer", using the extension to detect ad => asciidoc etc. We may need a way to express that here as well.
• Currently we use always render with a layout (using the output format as one of the lookup keys); in your example I assume you don't want that. So we could add a noLayout flag, meaning just write .Content to disk.

Also, I'm not sure we can/would want to allow passing on arbitrary flags to helpers. We have no way to support everything and it has a lot of unknowns in the security department (pandoc may have a -exec flag for what I know).

@kaushalmodi @regisphilibert and gang may chime in with their view on this topic.

[regisphilibert]

I'll go even though I might be missing something.

Not sure how this would work?

In the given example will Hugo load the pandoc Go Module itself? If so, how shall we install it? npm?
If so can't we already have hugo publish the file as is (template file: .Content) and let webpack handle the PDF conversion or else?

[bep]

@regis Hugo already supports Pandoc.

[florisdf]

@bep It might be an idea to use the suffix of the destination file to determine the output format for the renderer? In my example, since the destination has suffix ".tex", hugo can use pandoc as it supports TeX output. Eventually, one could specifically configure the renderer in the config file if the default doesn't suit.

Also, I think the current approach of determining the renderer based on the suffix of the content file conflicts with the idea of separating "form" and "content". Determining the renderer/output format based on the output file makes more sense, in my opinion, supposing that all renderers support a similar markdown dialect.

Finally, I think a layout file is still useful for other output formats apart from html. For LaTeX, it could contain something like

\documentclass[12pt, a4]{article}
\usepackage[utf8]{inputenc}
 
\title{ {{ .Title }} }
\date{ {{ .Date }} }

\begin{document}
{{ .Content }}
\end{document}

This would then be saved in a file like layouts/_default/single.tex so the hugo lookup rules would be just the way they are now.