Config Files

Config Folder Structure

Keep in mind the underscore on the _default folder. You have to have all of these files, otherwise the theme doesn’t work.

root
β”œβ”€β”€ config
β”‚   β”œβ”€β”€ _default
β”‚   β”‚   β”œβ”€β”€ config.toml
β”‚   β”‚   β”œβ”€β”€ languages.toml
β”‚   β”‚   β”œβ”€β”€ menus.en.toml
β”‚   β”‚   β”œβ”€β”€ params.toml

Config Files

 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
baseURL = "http://example.org/" # The URL of your site.
title = "Hugo Zzo Theme" # Title of your site
theme = "zzo" # Name of Zzo theme folder in `themes/`.

defaultContentLanguage = "en" # Default language to use (if you setup multilingual)
defaultContentLanguageInSubdir = true # baseURL/en/, baseURL/kr/ ...
hasCJKLanguage = true # Set `true` for Chinese/Japanese/Korean languages.

copyright = "Β©{year}, All Rights Reserved" # copyright symbol: $copy; current year: {year}
timeout = 10000
enableEmoji = true
paginate = 13 # Number of items per page in paginated lists.
rssLimit = 100

googleAnalytics = ""

disableKinds = ["taxonomyTerm"]

[markup]
  [markup.goldmark]
    [markup.goldmark.renderer]
      hardWraps = true
      unsafe = true
      xHTML = true
  [markup.highlight]
    codeFences = true
    lineNos = true
    lineNumbersInTable = true
    noClasses = false
  [markup.tableOfContents]
    endLevel = 4
    ordered = false
    startLevel = 2

[outputs]
  home = ["HTML", "RSS", "SearchIndex"]

[outputFormats]
  [outputFormats.SearchIndex]
    mediaType = "application/json"
    baseName = "index"
    isPlainText = true
    notAlternative = true
    
[taxonomies]
  tag = "tags"
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
[en]
  title = "Z Themes Documentation"
  languageName = "English"
  weight = 1
  languagedir = "ltr"
  contentdir = "content/en"
  
[ko]
  title = "Z Themes Documentation"
  languageName = "ν•œκ΅­μ–΄"
  weight = 2
  languagedir = "ltr"
  contentdir = "content/en"
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
[[main]]
  identifier = "Zzo"
  name = "Zzo theme"
  url = "zzo"
  weight = 1

[[main]]
  identifier = "Zdoc"
  name = "Zdoc theme"
  url = "zdoc"
  weight = 2

[[main]]
  identifier = "Blog"
  name = "Blog"
  url = "blog"
  weight = 3
...
 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
logo = true
logoText = "Z Themes"
logoType = "short" # long, short
description = "The Zzo theme documentation site."
editBaseURL = "https://github.com/zzossig/zzoDocs/blob/master/content"
themeOptions = ["light", "dark"]

useFaviconGenerator = true # https://www.favicon-generator.org/

wideViewAsDefault = true

enableWideBlogSwitch = true
enableTocSwitch = true
enableLandingBackground = true
enableSearch = true
enableSearchHighlight = true
enableLangChange = true
enableDarkMode = true
enableBreadcrumb = true
enableBlogBreadcrumb = true
enableEditBtn = true
enableToc = true
enableMenu = true
enableNavbar = true
enableFooter = true
showPoweredBy = true

paginateWindow = 1
taxoPaginate = 13
taxoGroupByDate = "2006" # "2006-01": group by month, "2006": group by year

github = "https://github.com/zzossig/hugo-theme-zzo"

enableComment = false
[utterances]       # https://utteranc.es/
  owner = "zzossig"              # Your GitHub ID
  repo = "zzoDocs"               # The repo to store comments