hugo-theme-relearn/exampleSite/content/configuration/customization/outputformats/_index.en.md
2024-10-12 19:28:32 +02:00

1.6 KiB

+++ categories = ["explanation", "howto"] description = "Adding Custom Output Formats" title = "Output Formats" weight = 6 +++

In addition to the output formats coming with the theme, you can create your own output formats.

Starting from Scratch

If you want to add a new output format called myformat that outputs HTML and you want to build everything yourself without using the theme's components:

  1. Create a file layouts/_default/baseof.myformat.html
  2. Implement all the necessary code in this file

Using the Theme's Structure

If you want to keep the general framework and only change specific parts, you can override these files:

  • layouts/_default/views/article.html: Controls how a page's content and title are displayed
  • layouts/_default/views/body.html: Determines the page body structure
  • layouts/_default/views/menu.html: Defines the sidebar menu layout
  • layouts/_default/views/storeOutputFormat.html: Stores the output format name for use in the framework

For a real-world example, check out the print output format implementations