blob: a6e370df4cef9d54a686f8a1bdb5ec09d41d7916 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
|
---
title: "Other Parameters"
date: "2024-10-08"
summary: "Other Parameters parameters"
description: "Other Parameters parameters"
toc: false
readTime: false
autonumber: true
math: false
showTags: false
---
Miscellaneous settings.
## Home Meta Description
You can specify the homepage meta description with the following parameter:
```toml
[params]
description = "Your description"
```
## Breadcrumbs
Show breadcrumbs on pages.
Example:
```toml
[params.breadcrumbs]
enabled = true
showCurrentPage = true
home = "~"
```
Set `enabled` to `false` if you want to hide breadcrumbs. By default, breadcrumbs are shown.
Set `showCurrentPage` to `false` to hide the last crumb, i.e, the current page.
`home` when set with a non-empty string, uses the latter as the first crumb instead of the string "Home".
## Comments
Enable comments on your posts using [Giscus](https://giscus.app/).
```toml
[params.giscus]
enable = false
repo = "your/repo"
repoid = "id"
category = "category"
categoryid = "categoryId"
mapping = "pathname"
theme = "preferred_color_scheme"
```
Tip: use `preferred_color_scheme` theme to have a consistent dark and light appearance.
You can decide to hide the comments section on certain pages, using the following parameter on the page itself:
```md
disableComment: true
```
## Umami
You can include [Umami](https://umami.is/) in your website as follows:
```toml
[params.umami]
enable = true
websiteId = "unique-website-id"
jsLocation = "http://example.org/umami.js"
```
## Favicons
The following favicons are included in the head of the website:
- `favicon.ico`
- `favicon-16x16.png`
- `favicon-32x32.png`
- `android-chrome-192x192.png`
- `apple-touch-icon.png`
You must override the existing one in your static folder.
You can also specify a subdirectory of /static if you prefer
using the following param:
```toml
[params]
faviconPath = 'your-path'
```
You can easily generate favicons using [this website](https://realfavicongenerator.net/) starting from your image.
[Here](https://github.com/tomfran/tomfran.github.io/tree/main/static) you can see an example of icons overriding default ones.
## Mermaid Diagrams
Mermaid diagrams are supported, just follow [this reference](https://gohugo.io/content-management/diagrams/#mermaid-diagrams) to use them. You can set Mermaid's light- and dark themes in your config; they switch with your blog's light/dark state. These are the defaults:
```toml
[params]
mermaidTheme = "default"
mermaidDarkTheme = "dark"
```
|
