From 0bc26e3a935035a38781c20b9b744a3de357f77c Mon Sep 17 00:00:00 2001
From: Paolo Mainardi <paolo.mainardi@sparkfabrik.com>
Date: Fri, 17 Jan 2025 00:40:12 +0000
Subject: [PATCH] feat: custom head title (#950)
---
layouts/_default/baseof.html | 3 -
docs/configurations.md | 60 +++++++++++++++--------------
2 files changed, 32 insertions(+), 31 deletions(-)
diff --git a/docs/configurations.md b/docs/configurations.md
index 50af129..c6397ed 100644
--- a/docs/configurations.md
+++ b/docs/configurations.md
@@ -126,35 +126,37 @@
These are all the parameters used by `hugo-coder` theme.
-| Name | Type | Required | Description | Default | Example |
-| ----------------------------- | ------ | -------- | ------------------------------------------------ | -------------------------------- | ------------------------------------------------ |
-| author | string | Yes | Author name. | | `"John Doe"` |
-| info | string | Yes | An headline, job title or similar. | | `"Full Stack Developer"` |
-| description | string | Yes | Description of the site. | | `"John Doe's personal website"` |
-| keywords | string | Yes | Site keywords. | | `"blog,developer,personal"` |
-| avatarURL | string | No | Photo of the author. | | `"images/avatar.jpg"` |
-| gravatar | string | No | Gravatar photo of the author | | `"john.doe@example.com"` |
-| fediverseCreator | string | No | The author's fediverse handle. | | `"@johndoe@example.com"` |
-| faviconSVG | string | No | Custom path to a SCG favicon. | `"/img/favicon.svg"` | `"/img/favicon.svg"` |
-| favicon_32 | string | No | Custom path to a 32x32 favicon. | `"/img/favicon-32x32.png"` | `"/img/favicon-32x32.png"` |
-| favicon_16 | string | No | Custom path to a 16x16 favicon. | `"/img/favicon-16x16.png"` | `"/img/favicon-16x16.png"` |
-| touchIcon | string | No | Custom path to an apple-touch-icon | `"/images/apple-touch-icon.png"` | `"/images/apple-touch-icon.png"` |
-| mask_icon | string | No | Custom path to a mask-icon | `"/images/safari-pinned-tab.svg"` | `"/images/safari-pinned-tab.svg"` |
-| mask_icon_color | string | No | Custom color for mask-icon color | `"#5bbad5"` | `"#5bbad5"` |
-| since | string | No | Date shown in the footer before now year | | `"2020"` |
-| maxSeeAlsoItems | number | No | Series see also post count | `5` | `10` |
-| commit | string | No | Show the last git commit in the footer | | `"https://github.com/luizdepra/hugo-coder/tree/"`|
-| rtl | bool | No | Enable the Right To Left mode. | `false` | `true` or `false` |
-| math | bool | No | Enable MathJax Module and add JS into your site. | `false` | `true` or `false` |
-| katex | bool | No | Enable KaTeX for all content types. | `false` | `true` or `false` |
-| colorScheme | string | No | Specify light/dark colorscheme | `"auto"` | `"auto"` or `"light"` or `"dark"` |
-| hideColorSchemeToggle | bool | No | If true, hides the color scheme toggle | `false` | `true` or `false` |
-| customCSS | list | No | Add extra CSS files to the website. | [] | `["css/extra-style.css"]` |
-| customSCSS | list | No | Add extra SCSS files to the website. | [] | `["scss/extra-style.scss"]` |
-| customJS | list | No | Add extra JS files to the website. | [] | `["js/extra-script.js"]` |
-| customRemoteJS | list | No | Add extra remote JS files to the website. | [] | `["https://www.example.com/file.js"]` |
-| enableTwemoji | bool | No | Adds support for Twemoji | `false` | `true` or `false` |
-| disableDefaultJsScripts | bool | No | If true, disables default js scripts (coder.js) | `false` | `true` or `false` |
+| Name | Type | Required | Description | Default | Example |
+| ----------------------- | ------ | -------- | ------------------------------------------------------------------------ | --------------------------------- | ------------------------------------------------- |
+| author | string | Yes | Author name. | | `"John Doe"` |
+| info | string | Yes | An headline, job title or similar. | | `"Full Stack Developer"` |
+| description | string | Yes | Description of the site. | | `"John Doe's personal website"` |
+| keywords | string | Yes | Site keywords. | | `"blog,developer,personal"` |
+| avatarURL | string | No | Photo of the author. | | `"images/avatar.jpg"` |
+| gravatar | string | No | Gravatar photo of the author | | `"john.doe@example.com"` |
+| fediverseCreator | string | No | The author's fediverse handle. | | `"@johndoe@example.com"` |
+| faviconSVG | string | No | Custom path to a SCG favicon. | `"/img/favicon.svg"` | `"/img/favicon.svg"` |
+| favicon_32 | string | No | Custom path to a 32x32 favicon. | `"/img/favicon-32x32.png"` | `"/img/favicon-32x32.png"` |
+| favicon_16 | string | No | Custom path to a 16x16 favicon. | `"/img/favicon-16x16.png"` | `"/img/favicon-16x16.png"` |
+| touchIcon | string | No | Custom path to an apple-touch-icon | `"/images/apple-touch-icon.png"` | `"/images/apple-touch-icon.png"` |
+| mask_icon | string | No | Custom path to a mask-icon | `"/images/safari-pinned-tab.svg"` | `"/images/safari-pinned-tab.svg"` |
+| mask_icon_color | string | No | Custom color for mask-icon color | `"#5bbad5"` | `"#5bbad5"` |
+| since | string | No | Date shown in the footer before now year | | `"2020"` |
+| maxSeeAlsoItems | number | No | Series see also post count | `5` | `10` |
+| commit | string | No | Show the last git commit in the footer | | `"https://github.com/luizdepra/hugo-coder/tree/"` |
+| rtl | bool | No | Enable the Right To Left mode. | `false` | `true` or `false` |
+| math | bool | No | Enable MathJax Module and add JS into your site. | `false` | `true` or `false` |
+| katex | bool | No | Enable KaTeX for all content types. | `false` | `true` or `false` |
+| colorScheme | string | No | Specify light/dark colorscheme | `"auto"` | `"auto"` or `"light"` or `"dark"` |
+| hideColorSchemeToggle | bool | No | If true, hides the color scheme toggle | `false` | `true` or `false` |
+| customCSS | list | No | Add extra CSS files to the website. | [] | `["css/extra-style.css"]` |
+| customSCSS | list | No | Add extra SCSS files to the website. | [] | `["scss/extra-style.scss"]` |
+| customJS | list | No | Add extra JS files to the website. | [] | `["js/extra-script.js"]` |
+| customRemoteJS | list | No | Add extra remote JS files to the website. | [] | `["https://www.example.com/file.js"]` |
+| enableTwemoji | bool | No | Adds support for Twemoji | `false` | `true` or `false` |
+| disableDefaultJsScripts | bool | No | If true, disables default js scripts (coder.js) | `false` | `true` or `false` |
+| HeadTitle | string | No | When configured, it overrides the `<title>` tag with the provided string | "" | `"My custom title"` |
+
### Social Icons Configuration
diff --git a/layouts/_default/baseof.html b/layouts/_default/baseof.html
index 5ced05c..15b574c 100644
--- a/layouts/_default/baseof.html
+++ b/layouts/_default/baseof.html
@@ -2,7 +2,7 @@
<html lang="{{ .Site.Language.Lang }}">
<head>
- <title>{{ block "title" . }}{{ .Site.Title }}{{ end }}</title>
+ <title>{{ block "title" . }}{{ .Site.Params.HeadTitle | default .Site.Title }}{{ end }}</title>
{{ partial "head.html" . }}
</head>
@@ -134,5 +134,4 @@
{{- partial "body/extensions" . -}}
</body>
-
</html>
--
Gitblit v1.10.0