Merge pull request #52591 from Caesarsage/add-latest-api-ref

feat: add dynamic latest API redirects via Hugo templating

Author: k8s-ci-robot

.gitignore

@@ -38,3 +38,6 @@ nohup.out
 # Generated files when building with make container-build
 .config/
 .npm/
+
+# Local Netlify folder
+.netlify

hugo.toml

@@ -81,7 +81,7 @@ blog = "/:section/:year/:month/:day/:slug/"
 
 # Be explicit about the output formats. We (currently) only want an RSS feed for the home page.
 [outputs]
-home = [ "HTML", "RSS", "HEADERS" ]
+home = [ "HTML", "RSS", "HEADERS", "REDIRECTS"]
 page = [ "HTML"]
 section = [ "HTML", "print" ]
 
@@ -101,6 +101,13 @@ baseName = "_headers"
 isPlainText = true
 notAlternative = true
 
+# _redirects file output (uses the template at layouts/index.redirects)
+[outputFormats.REDIRECTS]
+mediatype = "text/netlify"
+baseName = "_redirects"
+isPlainText = true
+notAlternative = true
+
 # Image processing configuration.
 [imaging]
 resampleFilter = "CatmullRom" # cSpell:disable-line

layouts/index.redirects

@@ -0,0 +1,15 @@
+{{- $latest := or .Site.Params.latest (errorf "missing .Site.Params.latest") -}}
+
+###############################################
+# set server-side redirects in this file      #
+# see https://www.netlify.com/docs/redirects/ #
+# test at https://play.netlify.com/redirects  #
+###############################################
+
+# Dynamic latest API redirect - automatically points to current latest version
+/docs/reference/generated/kubernetes-api/latest/     /docs/reference/generated/kubernetes-api/{{ $latest }}/ 307
+/docs/reference/generated/kubernetes-api/latest/*   /docs/reference/generated/kubernetes-api/{{ $latest }}/:splat 307
+
+# Include all existing static redirects
+{{- $staticRedirects := readFile "static/_redirects.base" -}}
+{{ $staticRedirects }}

static/_redirects renamed to static/_redirects.base

@@ -4,6 +4,16 @@
 # test at https://play.netlify.com/redirects  #
 ###############################################
 
+# NOTE: This is the SOURCE FILE for static redirects.
+# 
+# How to add redirects:
+# - For STATIC redirects (fixed paths): Add them to THIS FILE
+# - For DYNAMIC redirects (using Hugo variables/logic): Edit layouts/index.redirects
+# 
+# The actual _redirects file is auto-generated by Hugo from layouts/index.redirects,
+# which combines dynamic redirects with the static redirects from this file.
+
+
 /concepts/containers/container-lifecycle-hooks/     /docs/concepts/containers/container-lifecycle-hooks/ 301
 /docs/     /docs/home/ 301!
 /bn/docs/     /bn/docs/home/ 301!