mirror of
https://github.com/McShelby/hugo-theme-relearn.git
synced 2025-01-19 11:20:24 +00:00
51 lines
2.1 KiB
Markdown
51 lines
2.1 KiB
Markdown
|
|
||
|
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](configuration/customization/outputformats).
|
||
|
|
||
|
## 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](authoring/frontmatter/topbar/#print-button). Clicking it switches to print preview, showing the page and its [visible subpages](configuration/content/hidden) in a printer-friendly format. Use your browser's print function to print or save as PDF.
|
||
|
|
||
|
The URL won't be [configured ugly](https://gohugo.io/templates/output-formats/#configure-output-formats) for [Hugo's URL handling](https://gohugo.io/content-management/urls/#ugly-urls), 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](authoring/frontmatter/topbar/#markdown-button). Clicking it switches to the Markdown source of the page.
|
||
|
|
||
|
The `markdown` output format configuration is [provided by Hugo](https://gohugo.io/templates/output-formats/#output-format-definitions).
|
||
|
|