Revise the Kubernetes website to use Docsy (#20874)

* Add Docsy, required packages and config

* Apply Docsy integration work to k8s website

This encompasses significant changes to the style system, layout files,
as well as changes to some of the static assets. To examine this work
and the iterations that were performed, the original repository can be
found at https://github.com/gearbox-built/kubernetes-hugo.git

* Address issues found in review

The styling and positioning of the header, footer, some shortcodes and
main container elements are improved. A new partial is added for
favicons. The sidebars, as well as inner table of contents, have been
altered for better positioning and rendering of content. Localization
has also been addressed.

* Enable announcements

The recent Black Lives Matter announcement surfaced issues which have
been addressed.

config.toml

@@ -1,6 +1,11 @@
 baseURL = "https://kubernetes.io"
 title = "Kubernetes"
 
+# Hugo allows theme composition (and inheritance). The precedence is from left to right.
+theme = ["docsy"]
+
+# Language settings
+contentDir = "content/en"
 defaultContentLanguage = "en"
 defaultContentLanguageInSubdir = false
 enableRobotsTXT = true
@@ -10,10 +15,17 @@ disableKinds = ["taxonomy", "taxonomyTerm"]
 
 ignoreFiles = [ "^OWNERS$", "README[-]+[a-z]*\\.md", "^node_modules$", "content/en/docs/doc-contributor-tools" ]
 
-contentDir = "content/en"
-
 timeout = 3000
 
+# 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 = "emacs"
+
 # Enable Git variables like commit, lastmod
 enableGitInfo = true
 
@@ -44,7 +56,7 @@ disableLanguages = ["hi", "no"]
     style = "emacs"
     tabWidth = 4
   [markup.tableOfContents]
-    endLevel = 2
+    endLevel = 3
     ordered = false
     startLevel = 2
 
@@ -76,7 +88,28 @@ baseName = "_headers"
 isPlainText = true
 notAlternative = true
 
+# Image processing configuration.
+[imaging]
+resampleFilter = "CatmullRom"
+quality = 75
+anchor = "smart"
+
+[services]
+[services.googleAnalytics]
+# Comment out the next line to disable GA tracking. Also disables the feature described in [params.ui.feedback].
+id = "UA-00000000-0"
+
 [params]
+copyright_k8s = "The Kubernetes Authors"
+copyright_linux =  "Copyright © 2020 The Linux Foundation ®."
+# 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 = "Versions"
 
 time_format_blog = "Monday, January 02, 2006"
 description = "Production-Grade Container Orchestration"
@@ -99,6 +132,20 @@ githubWebsiteRaw = "raw.githubusercontent.com/kubernetes/website"
 announcement = true
 announcement_bg = "#000000" #choose a dark color – text is white
 
+#Searching
+k8s_search = true
+
+#The following search parameters are specific to Docsy's implementation. Kubernetes implementes its own search-related partials and scripts.
+
+# Google Custom Search Engine ID. Remove or comment out to disable search.
+#gcs_engine_id = "011737558837375720776:fsdu1nryfng"
+
+# Enable Algolia DocSearch
+algolia_docsearch = false
+
+# Enable Lunr.js offline search
+offlineSearch = false
+
 [params.pushAssets]
 css = [
   "callouts",
@@ -145,6 +192,80 @@ githubbranch = "v1.14.10"
 docsbranch = "release-1.14"
 url = "https://v1-14.docs.kubernetes.io"
 
+# User interface configuration
+[params.ui]
+# Enable to show the side bar menu in its compact state.
+sidebar_menu_compact = false
+#  Set to true to disable breadcrumb navigation.
+breadcrumb_disable = 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
+#  Set to false if you don't want to display a logo (/assets/icons/logo.svg) in the top nav bar
+navbar_logo = true
+# Set to true to disable the About link in the site footer
+footer_about_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.
+[params.ui.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>.'
+
+[params.links]
+# End user relevant links. These will show up on left side of footer and in the community page if you have one.
+[[params.links.user]]
+	name = "User mailing list"
+	url = "https://discuss.kubernetes.io"
+	icon = "fa fa-envelope"
+  desc = "Discussion and help from your fellow users"
+  
+[[params.links.user]]
+	name = "Twitter"
+	url = "https://twitter.com/kubernetesio"
+	icon = "fab fa-twitter"
+  desc = "Follow us on Twitter to get the latest news!"
+
+[[params.links.user]]
+	name = "Calendar"
+	url = "https://calendar.google.com/calendar/embed?src=nt2tcnbtbied3l6gi2h29slvc0%40group.calendar.google.com"
+	icon = "fas fa-calendar-alt"
+  desc = "Google Calendar for Kubernetes"
+
+[[params.links.user]]
+	name = "Youtube"
+	url = "https://youtbue.com/kubernetescommunity"
+	icon = "fab fa-youtube"
+  desc = "Youtube community videos"
+
+# Developer relevant links. These will show up on right side of footer and in the community page if you have one.
+[[params.links.developer]]
+	name = "GitHub"
+	url = "https://github.com/kubernetes/kubernetes"
+	icon = "fab fa-github"
+  desc = "Development takes place here!"
+
+[[params.links.developer]]
+	name = "Slack"
+	url = "https://slack.k8s.io"
+	icon = "fab fa-slack"
+  desc = "Chat with other project developers"
+
+[[params.links.developer]]
+	name = "Contribute"
+	url = "https://git.k8s.io/community/contributors/guide"
+	icon = "fas fa-edit"
+  desc = "Contribute to the Kubernetes website"
+  
+[[params.links.developer]]
+	name = "Stack Overflow"
+	url = "https://stackoverflow.com/questions/tagged/kubernetes"
+	icon = "fab fa-stack-overflow"
+  desc = "Practical questions and curated answers"
+
 # Language definitions.
 
 [languages]