generated from google/docsy-example
-
Notifications
You must be signed in to change notification settings - Fork 5
/
hugo.yaml
executable file
·195 lines (156 loc) · 6.58 KB
/
hugo.yaml
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
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
baseURL: https://example.docsy.dev
title: KRS
# cSpell:ignore goldmark github hugo readingtime docsy subdir lastmod pygments linenos catmullrom norsk gu
# Language settings
contentDir: content/en
defaultContentLanguage: en
defaultContentLanguageInSubdir: false
# Useful when translating.
enableMissingTranslationPlaceholders: true
enableRobotsTXT: true
# Will give values to .Lastmod etc.
enableGitInfo: true
# Comment out to enable taxonomies in Docsy
# disableKinds: [taxonomy, taxonomyTerm]
# You can add your own taxonomies
taxonomies:
tag: tags
category: categories
# Highlighting config
pygmentsCodeFences: true
pygmentsUseClasses: false
# Use the new Chroma Go highlighter in Hugo.
pygmentsUseClassic: false
# pygmentsOptions: "linenos=table"
# See https://help.farbox.com/pygments.html
pygmentsStyle: tango
# Configure how URLs look like per section.
permalinks:
blog: /:section/:year/:month/:day/:slug/
# Image processing configuration.
imaging:
resampleFilter: CatmullRom
quality: 75
anchor: smart
# Language configuration
languages:
en:
languageName: English
title: KRS
params:
description: A KRS Docs site
custom_css: [css/custom.css]
# cSpell:enable
markup:
goldmark:
parser:
attribute:
block: true
renderer:
unsafe: true
highlight:
# See a complete list of available styles at https://xyproto.github.io/splash/docs/all.html
style: tango
# Uncomment if you want your chosen highlight style used for code blocks without a specified language
# guessSyntax: true
# Everything below this are Site Params
# Comment out if you don't want the "print entire section" link enabled.
outputs:
section: [HTML, print, RSS]
params:
taxonomy:
# set taxonomyCloud = [] to hide taxonomy clouds
taxonomyCloud: [tags, categories]
# If used, must have same length as taxonomyCloud
taxonomyCloudTitle: [Tag Cloud, Categories]
# set taxonomyPageHeader = [] to hide taxonomies on the page headers
taxonomyPageHeader: [tags, categories]
privacy_policy: https://policies.google.com/privacy
# First one is picked as the Twitter card image if not set on page.
# images: [images/project-illustration.png]
# Menu title if your navbar has a versions selector to access old versions of your site.
# This menu appears only if you have at least one [params.versions] set.
version_menu: Releases
# Flag used in the "version-banner" partial to decide whether to display a
# banner on every page indicating that this is an archived version of the docs.
# Set this flag to "true" if you want to display the banner.
archived_version: false
# The version number for the version of the docs represented in this doc set.
# Used in the "version-banner" partial to display a version number for the
# current doc set.
version: 0.0
# A link to latest version of the docs. Used in the "version-banner" partial to
# point people to the main doc site.
url_latest_version: https://example.com
# Repository configuration (URLs for in-page links to opening issues and suggesting changes)
github_repo: https://github.com/kubetoolsca
# An optional link to a related project repo. For example, the sibling repository where your product code lives.
github_project_repo: https://github.com/google/docsy
# Specify a value here if your content directory is not in your repo's root directory
# github_subdir: ""
# Uncomment this if your GitHub repo does not have "main" as the default branch,
# or specify a new value if you want to reference another branch in your GitHub links
github_branch: main
# Google Custom Search Engine ID. Remove or comment out to disable search.
# gcs_engine_id: d72aa9b2712488cc3
# Enable Lunr.js offline search
offlineSearch: false
# Enable syntax highlighting and copy buttons on code blocks with Prism
prism_syntax_highlighting: false
copyright:
authors: Kubetools Technologies
from_year: 2024
# User interface configuration
ui:
# Set to true to disable breadcrumb navigation.
breadcrumb_disable: false
# Set to false if you don't want to display a logo (/assets/icons/logo.svg) in the top navbar
navbar_logo: true
# Set to true if you don't want the top navbar to be translucent when over a `block/cover`, like on the homepage.
navbar_translucent_over_cover_disable: false
# Enable to show the side bar menu in its compact state.
sidebar_menu_compact: false
# Set to true to hide the sidebar search box (the top nav search box will still be displayed if search is enabled)
sidebar_search_disable: false
# Adds a H2 section titled "Feedback" to the bottom of each doc. The responses are sent to Google Analytics as events.
# This feature depends on [services.googleAnalytics] and will be disabled if "services.googleAnalytics.id" is not set.
# If you want this feature, but occasionally need to remove the "Feedback" section from a single page,
# add "hide_feedback: true" to the page's front matter.
feedback:
enable: true
# The responses that the user sees after clicking "yes" (the page was helpful) or "no" (the page was not helpful).
'yes': >-
Glad to hear it! Please <a href="https://github.com/USERNAME/REPOSITORY/issues/new">tell us how we can improve</a>.
'no': >-
Sorry to hear that. Please <a href="https://github.com/USERNAME/REPOSITORY/issues/new">tell us how we can improve</a>.
# Adds a reading time to the top of each doc.
# If you want this feature, but occasionally need to remove the Reading time from a single page,
# add "hide_readingtime: true" to the page's front matter
readingtime:
enable: false
links:
# End user relevant links. These will show up on left side of footer and in the community page if you have one.
user:
- name: Twitter
url: https://x.com/kubetools
icon: fab fa-twitter
desc: Follow us on Twitter to get the latest news!
# Developer relevant links. These will show up on right side of footer and in the community page if you have one.
developer:
- name: GitHub
url: https://github.com/kubetoolsca/krs
icon: fab fa-github
desc: Development takes place here!
- name: Slack
url: https://www.launchpass.com/kubetoolsio
icon: fab fa-slack
desc: Chat with other project developers
module:
# Uncomment the next line to build and serve using local docsy clone declared in the named Hugo workspace:
# workspace: docsy.work
hugoVersion:
extended: true
min: 0.110.0
imports:
- path: github.com/google/docsy
disable: false