hugo-theme-relearn/exampleSite/content/configuration/customization/partials/index.en.md

+++
description = "Modifying partials to your needs"
title = "Partials"
weight = 1
+++

## Usable Partials

You can call other partials from `themes/hugo-relearn-themes/` besides those in `themes/hugo-relearn-themes/layouts/partials/_relearn`. However, using partials not mentioned as customizable below might make future updates more challenging.

## Customizable Partials

The Relearn theme allows you to customize various parts of the theme by overriding partials. This makes the theme highly configurable.

A good rule to follow: The less code a partial contains, the easier it will be to update the theme in the future.

Here's a list of partials you can safely override:

- `layouts/partials/content.html`: The main content of a page. Override this to display additonal page metadata.

- `layouts/partials/content-header.html`: The header above the title. By default, it shows tags, but you can change this.

- `layouts/partials/content-footer.html`: The footer below the content. By default, it shows author info, modification dates, and categories. You can customize this.

- `layouts/partials/custom-header.html`: For adding custom CSS. Remember to include the `style` HTML tag.

- `layouts/partials/custom-footer.html`: For adding custom JavaScript. Remember to include the `script` HTML tag.

- `layouts/partials/favicon.html`: The favicon. You should definitely customize this.

- `layouts/partials/heading.html`: the page's title headings

- `layouts/partials/heading-pre.html`: Add content before the page's title headings. Remember to consider the `headingPre` front matter.

- `layouts/partials/heading-post.html`: Add content after the page's title headings. Remember to consider the `headingPost` front matter.

- `layouts/partials/logo.html`: The logo in the top left corner. You should customize this.

- `layouts/partials/menu-pre.html`: Add content before menu items. Remember to consider the `menuPre` front matter.

- `layouts/partials/menu-post.html`: Add content after menu items. Remember to consider the `menuPost` front matter.

- `layouts/partials/menu-footer.html`: The footer of the left menu.

You can override other partials from `themes/hugo-relearn-themes/`, but be careful as this might make future updates more difficult.
docs: first draft chapter 2 #567 2024-09-29 21:48:56 +00:00			`+++`
			`description = "Modifying partials to your needs"`
			`title = "Partials"`
docs: honing #567 2024-10-06 14:45:11 +00:00			`weight = 1`
docs: first draft chapter 2 #567 2024-09-29 21:48:56 +00:00			`+++`

docs: crosslinking chapter 2 #567 2024-10-12 08:52:54 +00:00			`## Usable Partials`

			You can call other partials from `themes/hugo-relearn-themes/` besides those in `themes/hugo-relearn-themes/layouts/partials/_relearn`. However, using partials not mentioned as customizable below might make future updates more challenging.

docs: first draft chapter 2 #567 2024-09-29 21:48:56 +00:00			`## Customizable Partials`

docs: review #567 2024-10-07 13:30:53 +00:00			`The Relearn theme allows you to customize various parts of the theme by overriding partials. This makes the theme highly configurable.`
docs: first draft chapter 2 #567 2024-09-29 21:48:56 +00:00
docs: review #567 2024-10-07 13:30:53 +00:00			`A good rule to follow: The less code a partial contains, the easier it will be to update the theme in the future.`
docs: first draft chapter 2 #567 2024-09-29 21:48:56 +00:00
docs: review #567 2024-10-07 13:30:53 +00:00			`Here's a list of partials you can safely override:`
docs: first draft chapter 2 #567 2024-09-29 21:48:56 +00:00
docs: review #567 2024-10-07 13:30:53 +00:00			- `layouts/partials/content.html`: The main content of a page. Override this to display additonal page metadata.
docs: first draft chapter 2 #567 2024-09-29 21:48:56 +00:00
docs: review #567 2024-10-07 13:30:53 +00:00			- `layouts/partials/content-header.html`: The header above the title. By default, it shows tags, but you can change this.
docs: first draft chapter 2 #567 2024-09-29 21:48:56 +00:00
docs: review #567 2024-10-07 13:30:53 +00:00			- `layouts/partials/content-footer.html`: The footer below the content. By default, it shows author info, modification dates, and categories. You can customize this.
docs: first draft chapter 2 #567 2024-09-29 21:48:56 +00:00
docs: review #567 2024-10-07 13:30:53 +00:00			- `layouts/partials/custom-header.html`: For adding custom CSS. Remember to include the `style` HTML tag.
docs: first draft chapter 2 #567 2024-09-29 21:48:56 +00:00
docs: review #567 2024-10-07 13:30:53 +00:00			- `layouts/partials/custom-footer.html`: For adding custom JavaScript. Remember to include the `script` HTML tag.
docs: first draft chapter 2 #567 2024-09-29 21:48:56 +00:00
docs: review #567 2024-10-07 13:30:53 +00:00			- `layouts/partials/favicon.html`: The favicon. You should definitely customize this.
docs: first draft chapter 2 #567 2024-09-29 21:48:56 +00:00
docs: review #567 2024-10-07 13:30:53 +00:00			- `layouts/partials/heading.html`: the page's title headings
docs: first draft chapter 2 #567 2024-09-29 21:48:56 +00:00
docs: review #567 2024-10-07 13:30:53 +00:00			- `layouts/partials/heading-pre.html`: Add content before the page's title headings. Remember to consider the `headingPre` front matter.
docs: first draft chapter 2 #567 2024-09-29 21:48:56 +00:00
docs: review #567 2024-10-07 13:30:53 +00:00			- `layouts/partials/heading-post.html`: Add content after the page's title headings. Remember to consider the `headingPost` front matter.
docs: first draft chapter 2 #567 2024-09-29 21:48:56 +00:00
docs: review #567 2024-10-07 13:30:53 +00:00			- `layouts/partials/logo.html`: The logo in the top left corner. You should customize this.
docs: first draft chapter 2 #567 2024-09-29 21:48:56 +00:00
docs: review #567 2024-10-07 13:30:53 +00:00			- `layouts/partials/menu-pre.html`: Add content before menu items. Remember to consider the `menuPre` front matter.
docs: first draft chapter 2 #567 2024-09-29 21:48:56 +00:00
docs: review #567 2024-10-07 13:30:53 +00:00			- `layouts/partials/menu-post.html`: Add content after menu items. Remember to consider the `menuPost` front matter.
docs: first draft chapter 2 #567 2024-09-29 21:48:56 +00:00
docs: review #567 2024-10-07 13:30:53 +00:00			- `layouts/partials/menu-footer.html`: The footer of the left menu.
docs: first draft chapter 2 #567 2024-09-29 21:48:56 +00:00
docs: review #567 2024-10-07 13:30:53 +00:00			You can override other partials from `themes/hugo-relearn-themes/`, but be careful as this might make future updates more difficult.