Build client docs (knative#4623)

* build kn docs

* navigation tweaks

* link to github version of kn docs

* removing unneeded envvar

* removing go

* style

Author: psschwei

config/nav.yml

@@ -223,6 +223,7 @@ nav:
       - API:
         - Serving: reference/api/serving-api.md
         - Eventing: reference/api/eventing-api.md
+      - Client: reference/client/README.md
       - Concepts:
         - Duck types: reference/concepts/duck-typing.md
     - "Community":

docs/reference/client/README.md

@@ -0,0 +1,3 @@
+# Knative Client Reference
+
+See the [`kn` documentation]({{ clientdocs() }}){target=_blank} in Github.

hack/build.sh

@@ -70,9 +70,7 @@ fi
 # TODO copy templates, stylesheets, etc. into blog directory
 cp -r overrides blog/
 cp -r docs/images docs/stylesheets blog/docs/
-cd blog/
-mkdocs build -f mkdocs.yml -d ../site/blog
-cd -
+pushd blog; mkdocs build -f mkdocs.yml -d "$SITE/blog"; popd
 
 # Handle Cookie consent
 cp -r cookie-consent/js site/

hack/macros.py

@@ -43,3 +43,17 @@ def artifact(repo, file, org="knative"):
                     file=file,
                     version=version,
                     org=org)
+
+    @env.macro
+    def clientdocs():
+        """Generates a link to the client docs for the current release version.
+
+        When the version in the KNATIVE_VERSION environment variable is
+        empty this links to the main branch, otherwise it links to the
+        matching release in Github.
+        """
+        version = os.environ.get("KNATIVE_VERSION")
+        if version is None:
+            return 'https://github.com/knative/client/blob/main/docs/cmd/kn.md'
+
+        return 'https://github.com/knative/client/blob/release-{version}/docs/cmd/kn.md'.format(version=version)

netlify.toml

@@ -5,7 +5,6 @@
   publish = "site"
 
 [build.environment]
-  HUGO_VERSION = "0.83.1"
   NODE_VERSION= "14"
   PYTHON_VERSION = "3.8"