summaryrefslogtreecommitdiffstats
path: root/docs/config.toml
diff options
context:
space:
mode:
Diffstat (limited to 'docs/config.toml')
-rw-r--r--docs/config.toml300
1 files changed, 193 insertions, 107 deletions
diff --git a/docs/config.toml b/docs/config.toml
index 075576e18..aafb6aa00 100644
--- a/docs/config.toml
+++ b/docs/config.toml
@@ -1,13 +1,21 @@
+baseURL = "https://gohugo.io/"
+paginate = 100
+defaultContentLanguage = "en"
+enableEmoji = true
+# Set the unicode character used for the "return" link in page footnotes.
+footnotereturnlinkcontents = "↩"
+languageCode = "en-us"
+metaDataFormat = "yaml"
title = "Hugo: A Fast and Flexible Website Generator"
-baseurl = "http://gohugo.io/"
-MetaDataFormat = "yaml"
+theme = "gohugoioTheme"
+
+googleAnalytics = "UA-7131036-4"
+
pluralizeListTitles = false
+
# We do redirects via Netlify's _redirects file, generated by Hugo (see "outputs" below).
disableAliases = true
-[blackfriday]
- plainIDAnchors = true
-
[outputs]
home = [ "HTML", "RSS", "REDIR" ]
@@ -23,113 +31,191 @@ baseName = "_redirects"
isPlainText = true
notAlternative = true
+
+[social]
+twitter = "GoHugoIO"
+
+#CUSTOM PARAMS
[params]
- description = "Documentation of Hugo, a fast and flexible static site generator built with love by spf13, bep and friends in Go"
- author = "Steve Francia (spf13) and friends"
- release = "0.26-DEV"
+ description = "The world’s fastest framework for building websites"
+ ## Used for views in rendered HTML (i.e., rather than using the .Hugo variable)
+ release = "Hugo-Next"
+ ## Setting this to true will add a "noindex" to *EVERY* page on the site
+ removefromexternalsearch = false
+ ## Gh repo for site footer (include trailing slash)
+ ghrepo = "https://github.com/gohugoio/hugoDocs/"
+ ### Edit content repo (set to automatically enter "edit" mode; this is good for "improve this page" links)
+ ghdocsrepo = "https://github.com/gohugoio/hugoDocs/tree/master/docs"
+ ## Gitter URL
+ gitter = "https://gitter.im/spf13/hugo"
+ ## Discuss Forum URL
+ forum = "https://discourse.gohugo.io/"
+ ## Google Tag Manager
+ gtmid = ""
+ # First one is picked as the Twitter card image if not set on page.
+ images = ["images/gohugoio-card.png"]
+
+ flex_box_interior_classes = "flex-auto w-100 w-40-l mr3 mb3 bg-white ba b--moon-gray nested-copy-line-height"
+
+ #sidebar_direction = "sidebar_left"
+
+# MARKDOWN
+## Configuration for BlackFriday markdown parser: https://github.com/russross/blackfriday
+[blackfriday]
+ plainIDAnchors = true
+ hrefTargetBlank = true
+ angledQuotes = false
+ latexDashes = true
+
+## As of v0.20, all content files include a default "categories" value that's the same as the section. This was a cheap future-proofing method and should/could be changed accordingly.
[taxonomies]
- tag = "tags"
- group = "groups"
-
-[[menu.main]]
- name = "Download Hugo"
- pre = "<i class='fa fa-download'></i>"
- url = "https://github.com/gohugoio/hugo/releases"
- weight = -200
-[[menu.main]]
- name = "Site Showcase"
- pre = "<i class='fa fa-cubes'></i>"
- url = "/showcase/"
- weight = -180
-[[menu.main]]
- name = "Theme Showcase"
- pre = "<i class='fa fa-puzzle-piece'></i>"
- url = "http://themes.gohugo.io"
- weight = -170
-[[menu.main]]
- name = "Press & Articles"
- pre = "<i class='fa fa-bullhorn'></i>"
- url = "/community/press/"
- weight = -160
-[[menu.main]]
- name = "Discuss Hugo"
- pre = "<i class='fa fa-comments'></i>"
- url = "https://discourse.gohugo.io/"
- weight = -150
-[[menu.main]]
- name = "About Hugo"
- identifier = "about"
- pre = "<i class='fa fa-heart'></i>"
- weight = -110
-[[menu.main]]
- name = "Release Notes"
- url = "/release-notes/"
- pre = "<i class='fa fa-newspaper-o'></i>"
- weight = -111
-[[menu.main]]
- name = "Getting Started"
- identifier = "getting started"
- pre = "<i class='fa fa-road'></i>"
- weight = -100
-[[menu.main]]
- name = "Content"
- identifier = "content"
- pre = "<i class='fa fa-file-text'></i>"
- weight = -90
-[[menu.main]]
+ category = "categories"
+
+# High level items
+
+[[menu.docs]]
+ name = "About Hugo"
+ weight = 1
+ identifier = "about"
+ url = "/about/"
+
+[[menu.docs]]
+ name = "Getting Started"
+ weight = 5
+ identifier = "getting-started"
+ url = "/getting-started/"
+
+
+[[menu.docs]]
+ name = "Themes"
+ weight = 15
+ identifier = "themes"
+ post = "break"
+ url = "/themes/"
+
+# Core Menus
+
+[[menu.docs]]
+ name = "Content Management"
+ weight = 20
+ identifier = "content-management"
+ post = "expanded"
+ url = "/content-management/"
+
+[[menu.docs]]
+ name = "Templates"
+ weight = 25
+ identifier = "templates"
+
+ url = "/templates/"
+
+[[menu.docs]]
+ name = "Functions"
+ weight = 30
+ identifier = "functions"
+ url = "/functions/"
+
+[[menu.docs]]
+ name = "Variables"
+ weight = 35
+ identifier = "variables"
+ url = "/variables/"
+
+[[menu.docs]]
+ name = "CLI"
+ weight = 40
+ post = "break"
+ identifier = "commands"
+ url = "/commands/"
+
+
+
+# LOW LEVEL ITEMS
+
+
+[[menu.docs]]
+ name = "Troubleshooting"
+ weight = 60
+ identifier = "troubleshooting"
+ url = "/troubleshooting/"
+
+[[menu.docs]]
+ name = "Tools"
+ weight = 70
+ identifier = "tools"
+ url = "/tools/"
+
+[[menu.docs]]
+ name = "Hosting & Deployment"
+ weight = 80
+ identifier = "hosting-and-deployment"
+ url = "/hosting-and-deployment/"
+
+[[menu.docs]]
+ name = "Contribute"
+ weight = 100
+ post = "break"
+ identifier = "contribute"
+ url = "/contribute/"
+
+#[[menu.docs]]
+# name = "Tags"
+# weight = 120
+# identifier = "tags"
+# url = "/tags/"
+
+
+# [[menu.docs]]
+# name = "Categories"
+# weight = 140
+# identifier = "categories"
+# url = "/categories/"
+
+######## QUICKLINKS
+
+ [[menu.quicklinks]]
+ name = "Fundamentals"
+ weight = 1
+ identifier = "fundamentals"
+ url = "/tags/fundamentals/"
+
+
+
+
+######## GLOBAL ITEMS TO BE SHARED WITH THE HUGO SITES
+
+[[menu.global]]
+ name = "News"
+ weight = 1
+ identifier = "news"
+ url = "/news/"
+
+ [[menu.global]]
+ name = "Docs"
+ weight = 5
+ identifier = "docs"
+ url = "/documentation/"
+
+ [[menu.global]]
name = "Themes"
+ weight = 10
identifier = "themes"
- pre = "<i class='fa fa-desktop'></i>"
- weight = -85
-[[menu.main]]
- parent = "themes"
- name = "Theme Showcase"
- url = "http://themes.gohugo.io"
- weight = -170
-[[menu.main]]
- name = "Templates"
- identifier = "layout"
- pre = "<i class='fa fa-columns'></i>"
- weight = -80
-[[menu.main]]
- name = "Taxonomies"
- identifier = "taxonomy"
- pre = "<i class='fa fa-tags'></i>"
- weight = -70
-[[menu.main]]
- name = "Extras"
- identifier = "extras"
- pre = "<i class='fa fa-gift'></i>"
- weight = -60
-[[menu.main]]
+ url = "https://themes.gohugo.io/"
+
+ # Anything with a weight > 100 gets an external icon
+ [[menu.global]]
name = "Community"
+ weight = 150
+ icon = true
identifier = "community"
- pre = "<i class='fa fa-group'></i>"
- weight = -50
-[[menu.main]]
- parent = "community"
- name = "Discussion Forum"
+ post = "external"
url = "https://discourse.gohugo.io/"
- weight = 150
-[[menu.main]]
- name = "Tutorials"
- identifier = "tutorials"
- pre = "<i class='fa fa-book'></i>"
- weight = -40
-[[menu.main]]
- name = "Troubleshooting"
- identifier = "troubleshooting"
- pre = "<i class='fa fa-wrench'></i>"
- weight = -30
-[[menu.main]]
- name = "Tools"
- url = "/tools/"
- pre = "<i class='fa fa-cogs'></i>"
- weight = -25
-[[menu.main]]
- name = "Hugo Cmd Reference"
- identifier = "commands"
- pre = "<i class='fa fa-space-shuttle'></i>"
- weight = -20
- url = "/commands/"
+
+
+ [[menu.global]]
+ name = "GitHub"
+ weight = 200
+ identifier = "github"
+ post = "external"
+ url = "https://github.com/gohugoio/hugo"
generated by cgit v1.2.3 (git 2.25.1) at 2024-07-01 09:22:24 +0000