Add minimum setup for the Ukrainian translation

* Add `uk` entry to the languages config (disabled for now)
* Add the Ukrainian translation of the homepage
* Add `404 Not Found` page and redirect all `/uk/*` URLs to it
* Make the build/serve commands output i18n warnings
* Add configuration files for English and Ukrainian languages,
  including site parameters and navigation menus
* Move global repository configuration URLs to config files
* Add `latest_stable_version` parameter to the `config.yaml` file
* Add NPM command to serve with debug logs

Signed-off-by: Jay Vercellone <[email protected]>
Co-authored-by: Andrii Holovin <[email protected]>

Author: jverce

config/_default/config.yaml

@@ -0,0 +1,105 @@
+---
+baseURL: https://etcd.io
+enableRobotsTxt: true
+
+module:
+  replacements: 'github.com/FortAwesome/Font-Awesome -> ., github.com/twbs/bootstrap -> .'
+  imports:
+    - path: docsy
+
+themesDir: "node_modules" # docsy is installed via npm
+
+# Will give values to .Lastmod etc.
+enableGitInfo: true
+
+# Language settings
+contentDir: content/en
+defaultContentLanguage: en
+defaultContentLanguageInSubdir: false
+languageCode: en-us
+googleAnalytics: G-VF9H3EHMDK
+
+# Useful when translating.
+enableMissingTranslationPlaceholders: true
+
+disableKinds: [taxonomy, term]
+
+# Highlighting config
+pygmentsCodeFences: true
+pygmentsUseClasses: false
+# Use the new Chroma Go highlighter in Hugo.
+#pygmentsOptions = "linenos=table"
+# See https://help.farbox.com/pygments.html
+pygmentsStyle: fruity # "tango"
+
+# Image processing configuration.
+imaging:
+  resampleFilter: CatmullRom
+  quality: 75
+  anchor: smart
+
+markup:
+  goldmark:
+    renderer:
+      unsafe: true
+    extensions:
+      typographer:
+        enDash: '--'
+  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
+
+params:
+
+  # Enable Algolia DocSearch
+  algolia_docsearch: false
+
+  # Enable Lunr.js offline search
+  offlineSearch: true
+
+  # Enable syntax highlighting and copy buttons on code blocks with Prism
+  prism_syntax_highlighting: false
+
+  latest_stable_version: v3.5
+
+  # User interface configuration
+  ui:
+    sidebar_menu_compact: true
+    sidebar_search_disable: true
+    navbar_logo: true
+    footer_about_enable: false
+    navbar_translucent_over_cover_disable: true
+
+    # 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
+
+  # [params.logos]
+  hero: >-
+    https://raw.githubusercontent.com/cncf/artwork/master/projects/etcd/horizontal/white/etcd-horizontal-white.png
+
+  # Repository configuration (URLs for in-page links to opening issues and suggesting changes)
+  github_repo: https://github.com/etcd-io/website
+  github_branch: main
+
+  # An optional link to a related project repo. For example, the sibling repository where your product code lives.
+  github_project_repo: https://github.com/etcd-io/etcd
+
+mediaTypes:
+  text/netlify: {}
+
+outputFormats:
+  REDIRECTS:
+    mediaType: text/netlify
+    baseName: _redirects
+    notAlternative: true
+
+outputs:
+  home: [HTML, REDIRECTS, RSS]
+

config.yaml renamed to config/_default/language.en.yaml

@@ -1,70 +1,12 @@
----
-baseURL: https://etcd.io
-enableRobotsTxt: true
-
-module:
-  replacements: 'github.com/FortAwesome/Font-Awesome -> ., github.com/twbs/bootstrap -> .'
-  imports:
-    - path: docsy
-
-themesDir: "node_modules" # docsy is installed via npm
-
-# Will give values to .Lastmod etc.
-enableGitInfo: true
-
-# Language settings
+title: etcd
+languageName: English (en)
 contentDir: content/en
-defaultContentLanguage: en
-defaultContentLanguageInSubdir: false
-languageCode: en-us
-googleAnalytics: G-VF9H3EHMDK
-
-# Useful when translating.
-enableMissingTranslationPlaceholders: true
-
-disableKinds: [taxonomy, term]
-
-# Highlighting config
-pygmentsCodeFences: true
-pygmentsUseClasses: false
-# Use the new Chroma Go highlighter in Hugo.
-#pygmentsOptions = "linenos=table"
-# See https://help.farbox.com/pygments.html
-pygmentsStyle: fruity # "tango"
-
-# Image processing configuration.
-imaging:
-  resampleFilter: CatmullRom
-  quality: 75
-  anchor: smart
-
-languages:
-  en:
-    title: etcd
-    languageName: English
-    contentDir: content/en
-    weight: 1
-    params:
-      description: >-
-        A distributed, reliable key-value store for the most critical data of a
-        distributed system
-
-markup:
-  goldmark:
-    renderer:
-      unsafe: true
-    extensions:
-      typographer:
-        enDash: '--'
-  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
-
+weight: 1
 params:
+  description: >-
+    A distributed, reliable key-value store for the most critical data of a
+    distributed system
+
   copyright:
     from_year: 2013
     authors: |
@@ -78,34 +20,14 @@ params:
           <a href="https://github.com/etcd-io/website/blob/main/LICENSE" target="_blank" rel="noopener">License</a>
         </div>
       </div>
-  description: >-
-    A distributed, reliable key-value store for the most critical data of a
-    distributed system
-
-    # Repository configuration (URLs for in-page links to opening issues and suggesting changes)
-  github_repo: https://github.com/etcd-io/website
-  github_branch: main
-
-  # An optional link to a related project repo. For example, the sibling repository where your product code lives.
-  github_project_repo: https://github.com/etcd-io/etcd
-
-  # Enable Algolia DocSearch
-  algolia_docsearch: false
-
-  # Enable Lunr.js offline search
-  offlineSearch: true
-
-  # Enable syntax highlighting and copy buttons on code blocks with Prism
-  prism_syntax_highlighting: false
 
   # Versions
 
   # 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
-  latest_stable_version: v3.5
-  version:
 
+  version:
     deprecation_warning: >-
       This version of etcd is no longer supported. For the latest version, please see the [latest stable version](/docs/latest/).
   versions:
@@ -132,12 +54,6 @@ params:
 
   # User interface configuration
   ui:
-    sidebar_menu_compact: true
-    sidebar_search_disable: true
-    navbar_logo: true
-    footer_about_enable: false
-    navbar_translucent_over_cover_disable: true
-
     # 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,
@@ -154,12 +70,6 @@ params:
         href="https://github.com/etcd-io/website/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
-
   # Footer Links
   links:
     # End user relevant links. These will show up on left side of footer and in the community page if you have one.
@@ -181,31 +91,3 @@ params:
       - name: Etcd.io on GitHub
         url: https://github.com/etcd-io/website
         icon: fab fa-github
-  # [params.logos]
-  hero: >-
-    https://raw.githubusercontent.com/cncf/artwork/master/projects/etcd/horizontal/white/etcd-horizontal-white.png
-
-mediaTypes:
-  text/netlify: {}
-
-outputFormats:
-  REDIRECTS:
-    mediaType: text/netlify
-    baseName: _redirects
-    notAlternative: true
-
-outputs:
-  home: [HTML, REDIRECTS, RSS]
-
-# Site menu (partial -- also see pages with 'menu' in front matter)
-menu:
-  main:
-    - name: Docs
-      url: /docs/latest/
-      weight: -10
-    - name: Blog
-      pageref: /blog/
-    - name: Install
-      url: /docs/latest/install/
-    - name: Play
-      url: http://play.etcd.io/play

config/_default/language.uk.yaml

@@ -0,0 +1,64 @@
+title: etcd
+languageName: Українська (uk)
+contentDir: content/uk
+weight: 2
+disabled: true
+params:
+  description: >-
+    Розподілене, надійне сховище ключ-значення для найважливіших даних розподіленої системи
+
+  copyright:
+    from_year: 2013
+    authors: |
+      Автори etcd
+      <div class="row text-center text-white small">
+        <div class="col-12 text-center py-2 order-sm-2">
+          <a href="https://www.linuxfoundation.org/terms" target="_blank" rel="noopener">Умови</a> |
+          <a href="https://www.linuxfoundation.org/privacy" target="_blank" rel="noopener">Конфіденційність</a> |
+          <a href="https://www.linuxfoundation.org/trademark-usage" target="_blank" rel="noopener">Товарні знаки</a> |
+          <a href="https://github.com/etcd-io/website/blob/main/LICENSE" target="_blank" rel="noopener">Ліцензія</a>
+        </div>
+      </div>
+
+  version_menu: Версії
+
+  version:
+    deprecation_warning: >-
+      Ця версія etcd більше не підтримується. Останню версію див. у [остання
+      стабільна версія](/docs/latest/).
+  versions:
+    - version: v3.5
+      url: /uk/docs/v3.5/
+
+  ui:
+    feedback:
+      'yes': >-
+        Раді чути! Будь ласка, <a
+        href="https://github.com/etcd-io/website/issues/new">
+        повідомте нам, як ми можемо зробити краще</a>.
+      'no': >-
+        Дуже шкода це чути. Будь ласка, <a
+        href="https://github.com/etcd-io/website/issues/new">
+        повідомте нам, як ми можемо зробити краще</a>.
+
+  # Footer Links
+  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: Google Group
+        url: https://groups.google.com/g/etcd-dev
+        icon: fab fa-google
+      - name: Twitter
+        url: https://twitter.com/etcdio
+        icon: fab fa-twitter
+      - name: Github Discussions
+        url: https://github.com/etcd-io/etcd/discussions
+        icon: fab fa-github
+    # Developer relevant links. These will show up on right side of footer and in the community page if you have one.
+    developer:
+      - name: Etcd на GitHub
+        url: https://github.com/etcd-io/etcd
+        icon: fab fa-github-square
+      - name: Сайт Etcd.io на GitHub
+        url: https://github.com/etcd-io/website
+        icon: fab fa-github

config/_default/navigation/menus.en.yaml

@@ -0,0 +1,11 @@
+# Site menu (partial -- also see pages with 'menu' in front matter)
+main:
+  - name: Docs
+    url: /docs/latest/
+    weight: -10
+  - name: Blog
+    pageref: /blog/
+  - name: Install
+    url: /docs/latest/install/
+  - name: Play
+    url: http://play.etcd.io/play

config/_default/navigation/menus.uk.yaml

@@ -0,0 +1,11 @@
+# Site menu (partial -- also see pages with 'menu' in front matter)
+main:
+  - name: Документація
+    url: /docs/latest/
+    weight: -10
+  - name: Блог
+    pageref: /blog/
+  - name: Встановлення
+    url: /docs/latest/install/
+  - name: Спробувати
+    url: http://play.etcd.io/play

content/en/_index.html

@@ -14,7 +14,7 @@
 ---
 
 {{< blocks/cover image_anchor="top" height="min" color="primary" >}}
-<img src="etcd-horizontal-white.png" class="site-logo" />
+<img src="/etcd-horizontal-white.png" class="site-logo" />
 <h2 class="mt-4">
   A distributed, reliable key-value store for the most critical data of a distributed system
 </h2>