Configuration
You may specify options in hugo.toml (or hugo.yaml/hugo.json) of your site to make use of this theme’s features.
For an example of hugo.toml
, see hugo.toml in exampleSite.
Params
# Source Code repository section
description = "put your description"
github_repository = "https://github.com/thingsym/hugo-theme-techdoc"
version = "1.0.1"
# Documentation repository section
# documentation repository (set edit link to documentation repository)
github_doc_repository = "https://github.com/thingsym/hugo-theme-techdoc"
github_doc_repository_branch = "master"
github_doc_repository_path = ""
# Analytic section
google_analytics_id = "" # Your Google Analytics tracking id
tag_manager_container_id = "" # Your Google Tag Manager container id
google_site_verification = "" # Your Google Site Verification for Search Console
# Open Graph and Twitter Cards settings section
# Open Graph settings for each page are set on the front matter.
# See https://gohugo.io/templates/internal/#open-graph
# See https://gohugo.io/templates/internal/#twitter-cards
title = "Hugo Techdoc Theme"
images = ["images/og-image.png"] # Open graph images are placed in `static/images`
# Theme settings section
# Theme color
# See color value reference https://developer.mozilla.org/en-US/docs/Web/CSS/color
custom_font_color = ""
custom_background_color = ""
# Documentation Menu section
# Menu style settings
menu_style = "open-menu" # "open-menu" or "slide-menu" or "" blank is as no sidebar
# Date format
dateformat = "" # default "2 Jan 2006"
# See the format reference https://gohugo.io/functions/format/#hugo-date-and-time-templating-reference
# path name excluded from documentation menu
menu_exclusion = [
"archives",
"archive",
"blog",
"entry",
"post",
"posts",
]
# Algolia site search section
# See https://www.algolia.com/doc/
algolia_search_enable = true
algolia_indexName = "hugo-demo-techdoc"
algolia_appId = "7W4SAN4PLK"
algolia_apiKey = "cbf12a63ff72d9c5dc0c10c195cf9128" # Search-Only API Key
description
The document summary
default: put your description
github_repository
URL of source code repository
default: https://github.com/thingsym/hugo-theme-techdoc
version
The version of source code
default: 1.0.1
github_doc_repository
URL of documentation repository for editing
default: https://github.com/thingsym/hugo-theme-techdoc
github_doc_repository_path
content directory path (when including the content directory in the repository)
default: ""
google_analytics_id
ID of Google Analytics
default: ""
tag_manager_container_id
Container ID of Google Tag Manager
default: ""
google_site_verification
Content value in meta tag google-site-verification
for Google Search Console
<meta name="google-site-verification" content="e7-viorjjfiihHIoowh8KLiowhbs" />
default: ""
title
default open graph title for open graph
default: "Hugo Techdoc Theme"
images
default open graph image for open graph
Open graph images are placed in static/images
.
default: ["images/og-image.png"]
custom_font_color
Header font color
See color value reference https://developer.mozilla.org/en-US/docs/Web/CSS/color
default: ""
custom_background_color
Header background color
See color value reference https://developer.mozilla.org/en-US/docs/Web/CSS/color
default: ""
menu_style
Documentation Menu style, Open Menu or Slide Menu
default: open-menu
value: open-menu
| slide-menu
dateformat
default: ""
as 2 Jan 2006
menu_exclusion
Path name excluded from documentation menu
By default, we exclude commonly used folder names in blogs.
default: [ "archives", "archive", "blog", "entry", "post", "posts" ]
algolia_search_enable
Enable Algolia search
default: true
value: true
| false
algolia_indexName
Algolia index name
default: hugo-demo-techdoc
algolia_appId
Application id
default: 7W4SAN4PLK
algolia_apiKey
Search-Only API Key
default: cbf12a63ff72d9c5dc0c10c195cf9128