hugo-theme-relearn/configuration/sitemanagement/outputformats/index.md
2024-12-31 17:03:38 +00:00

2.1 KiB

The Relearn theme by default comes with templates for HTML and RSS for each page.

In addition you can configure the below formats.

If this is not enough, learn how to create your own output formats.

Print Support

Enable print support to print entire chapters or the whole site. Add the print output format to your home, section, and page in hugo.toml:

{{< multiconfig file=hugo >}} [outputs] home = ['html', 'rss', 'print'] section = ['html', 'rss', 'print'] page = ['html', 'rss', 'print'] {{< /multiconfig >}}

By default this adds a printer icon in the topbar but can be deactived. Clicking it switches to print preview, showing the page and its visible subpages in a printer-friendly format. Use your browser's print function to print or save as PDF.

The URL won't be configured ugly for Hugo's URL handling, even with uglyURLs=true in hugo.toml. This is because each mime type can only have one suffix.

If you don't like the URLs, you can reconfigure outputFormats.print in your hugo.toml to something other than the default of:

{{< multiconfig file=hugo >}} [outputFormats] [outputFormats.print] name= 'print' baseName = 'index.print' isHTML = true mediaType = 'text/html' permalinkable = false noUgly = true {{< /multiconfig >}}

Markdown Support

Enable support to show the Markdown source of a page . Add the markdown output format to your home, section, and page in hugo.toml:

{{< multiconfig file=hugo >}} [outputs] home = ['html', 'rss', 'markdown'] section = ['html', 'rss', 'markdown'] page = ['html', 'rss', 'markdown'] {{< /multiconfig >}}

By default this adds a Markdown icon in the topbar but can be deactived. Clicking it switches to the Markdown source of the page.

The markdown output format configuration is provided by Hugo.