site: Advanced website navigation

site/config.yaml

@@ -1,7 +1,9 @@
+title: "Krew – kubectl plugin manager"
 baseURL: "https://krew.sigs.k8s.io/"
 languageCode: "en-us"
-title: "Krew – kubectl plugin manager"
-
+disableKinds:
+- taxonomy
+- taxonomyTerm
 markup:
-    highlight:
-      style: dracula
+  highlight:
+    style: dracula

site/content/_index.md

@@ -0,0 +1,22 @@
+---
+title: Home
+---
+
+## Krew: plugin manager for kubectl
+
+Krew helps you discover [kubectl plugins][kpl], install and manage them on your
+machine.
+
+It is similar to package managers like apt, brew or dnf. Krew works acrosss all
+major platforms and [over 80 kubectl][list] plugins are currently available on
+Krew.
+
+- For **kubectl users**: Krew helps you discover and install kubectl plugins,
+  and keep them up to date.
+
+- For **kubectl plugin developers**: Krew helps you package and distribute your
+  plugins on multiple platforms easily and makes them discoverable through a
+  centralized plugin repository.
+
+[kpl]: https://kubernetes.io/docs/tasks/extend-kubectl/kubectl-plugins/
+[list]: http://sigs.k8s.io/krew-index/plugins.md

site/content/docs/_index.md

@@ -1,3 +1,4 @@
 ---
-title: Krew
+title: Documentation
+slug: docs
 ---

site/content/docs/developer-guide/_index.md

@@ -2,3 +2,6 @@
 title: Developer Guide
 weight: 300
 ---
+
+This guide is for `kubectl` plugin developers looking to distribute their
+plugins with Krew.

site/content/docs/developer-guide/release/submitting-to-krew.md

@@ -13,7 +13,7 @@ existing plugins.
 1. Familiarize yourself with [Krew plugin naming guide]({{< ref "../develop/naming-guide.md" >}}).
 1. Read the [plugin development best practices]({{< ref
    "../develop/best-practices.md" >}}).
-1. Develop a [plugin manifest](../plugin-manifest.md).
+1. Develop a [plugin manifest]({{< ref "../plugin-manifest.md" >}})
 1. Make sure your plugin’s source code is available as open source.
 1. Adopt an open source license, and add it to your plugin archive file.
 1. Tag a git release with a [semantic

site/content/docs/user-guide/_index.md

@@ -2,3 +2,5 @@
 title: User Guide
 weight: 200
 ---
+
+Learn how to use Krew to its full extent.

site/content/docs/user-guide/quickstart.md

@@ -5,12 +5,14 @@ weight: 100
 ---
 
 Krew helps you discover and install [`kubectl` plugins][kpl] on your machine.
+
 There are [a lot of][list] `kubectl` plugins you can install and use to enhance
 your Kubernetes experience.
 
-Let's get started.
+Let's get started:
+
+1. [Install and set up]({{<ref "setup/install.md">}}) Krew on your machine.
 
-1. [Install and set up]({{<ref "setup/install.md">}}) Krew.
 1. Download the plugin list:
 
     ```sh
@@ -21,16 +23,14 @@ Let's get started.
 
     ```sh
     {{<prompt>}}kubectl krew search
-    {{<output>}}
-NAME                            DESCRIPTION                                         INSTALLED
+    {{<output>}}NAME                            DESCRIPTION                                         INSTALLED
 access-matrix                   Show an RBAC access matrix for server resources     no
 advise-psp                      Suggests PodSecurityPolicies for cluster.           no
 auth-proxy                      Authentication proxy to a pod or service            no
-bulk-action                     Do bulk actions on Kubernetes resources.            no
-ca-cert                         Print the PEM CA certificate of the current clu...  no{{</output>}}
+[...]{{</output>}}
     ```
 
-1. Install a plugin:
+1. Choose a plugin from the list and install it:
 
     ```sh
     {{<prompt>}}kubectl krew install access-matrix

site/content/docs/user-guide/search.md

@@ -26,12 +26,9 @@ advise-psp       Suggests PodSecurityPolicies for cluster.           no
 auth-proxy       Authentication proxy to a pod or service            no
 bulk-action      Do bulk actions on Kubernetes resources.            no
 ca-cert          Print the PEM CA certificate of the current clu...  no
-capture          Triggers a Sysdig capture to troubleshoot the r...  no
-change-ns        View or change the current namespace via kubectl.   no
-cluster-group    Exec commands across a group of contexts.           no
-config-cleanup   Automatically clean up your kubeconfig              no
 ...{{</output>}}
 ```
+
 You can specify search keywords as arguments:
 
 ```sh

site/layouts/404.html

@@ -0,0 +1,11 @@
+{{ partial "header.html" . }}
+
+<h1 class="display-3 text-danger">Not found</h1>
+
+<p class="lead">
+    Sorry, this URL cannot be found. Maybe it’s moved.
+</p>
+
+<a href=" {{ "/" }}  " class="btn btn-lg btn-primary">&larr; Home</a>
+
+{{ partial "footer.html" }}

site/layouts/docs/section.html

@@ -0,0 +1,22 @@
+{{ $isDocsHome := (eq .Slug "docs") }}
+{{ partial "header.html" . }}
+<article>
+    <h1>
+        {{ if $isDocsHome }}
+            Documentation
+        {{else}}
+            {{ .Title}}
+        {{end}}
+    </h1>
+
+    {{ with .Content }}
+        <aside class="lead">{{.}}</aside>
+    {{ end }}
+
+    {{ partial "toc.html" . }}
+
+    {{ if not $isDocsHome }}
+        {{ partial "backbutton.html" .}}
+    {{ end }}
+</article>
+{{ partial "footer.html" }}

site/layouts/docs/single.html

@@ -1,5 +1,5 @@
 {{ partial "header.html" . }}
-    <article>
+    <article class="py-lg-3">
         <h1>{{.Title}}</h1>
         {{ with .Content }}
             {{.}}
@@ -8,8 +8,5 @@ <h1>{{.Title}}</h1>
         {{ end }}
     </article>
 
-    <p>
-        <a href="{{ "/" | relURL }}" rel="home">
-        &larr; Table of Contents</a>
-    </p>
+{{ partial "backbutton.html" .}}
 {{ partial "footer.html" }}

site/layouts/index.html

@@ -1,7 +1,14 @@
 {{ partial "header.html" . }}
 
+<article>
+    {{.Content}}
 
-    <h1 class="display-4">Documentation</h1>
-    {{ partial "toc.html" (.Site.GetPage "section" "docs") }}
+    <a href="{{ "/docs/user-guide/quickstart" | relURL }} " class="btn btn-primary text-nowrap">Quickstart</a>
+
+    <a href="{{ "/docs/user-guide" | relURL }} " class="btn btn-light text-nowrap">User Guide</a>
+
+    <a href="{{ "/docs/developer-guide" | relURL }} " class="btn btn-light text-nowrap">Developer Guide</a>
+
+</article>
 
 {{ partial "footer.html" }}

site/layouts/partials/backbutton.html

@@ -0,0 +1,21 @@
+{{ $docsHome := "/docs" }}
+{{ $userGuide := "/docs/user-guide" }}
+{{ $devGuide := "/docs/developer-guide" }}
+
+{{ $isUserGuide := .Parent.IsDescendant (.Site.GetPage "section" $userGuide) }}
+{{ $isDevGuide := .Parent.IsDescendant (.Site.GetPage "section" $devGuide) }}
+
+{{ $parent := "" }}
+{{ if $isUserGuide }}
+    {{ $parent = $userGuide }}
+{{ else if $isDevGuide }}
+    {{ $parent = $devGuide }}
+{{ else }}
+    {{ $parent = $docsHome }}
+{{ end }}
+
+{{ $parent := .Site.GetPage "section" $parent }}
+
+<a href="{{  $parent.RelPermalink}}" class="btn btn-link btn-sm rounded">
+    &larr; {{ $parent.Title }}
+</a>

site/layouts/partials/footer.html

@@ -4,9 +4,11 @@
             <small>
                 &copy; {{ now.Format "2006"}} The Kubernetes Authors.
                 Krew documentation is distributed under
-                <a href='https://creativecommons.org/licenses/by/4.0/' class='text-muted'>CC-BY-4.0</a>.
+                <a target="_blank" href='https://creativecommons.org/licenses/by/4.0/' class='text-muted'>CC-BY-4.0</a>.<br/>
+                Krew is a Kubernetes <a href="https://github.com/kubernetes/community/blob/master/sig-cli/README.md#cli-special-interest-group" target="_blank">SIG CLI</a> project.
             </small>
         </footer>
-    </div>
+        </div>
+    </div><!-- .container -->
 </body>
 </html>

site/layouts/partials/header.html

@@ -3,13 +3,28 @@
 <head>
     <meta charset="utf-8">
     <meta http-equiv="content-type" content="text/html; charset=utf-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0, max-scale=1.0, min-scale=1.0">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0">
 
-    <title>{{.Title}}</title>
+    <title>
+        {{ if .IsHome }}
+            {{ .Site.Title }}
+        {{ else }}
+            {{ .Title }} &#183 Krew
+        {{ end }}
+
+    </title>
     <link rel="stylesheet" href="https://stackpath.bootstrapcdn.com/bootstrap/4.4.1/css/bootstrap.min.css" integrity="sha384-Vkoo8x4CGsO3+Hhxv8T/Q5PaXtkKtu6ug5TOeNV6gBiFeWPGFN9MuhOf23Q9Ifjh" crossorigin="anonymous">
     <link rel="stylesheet" href="{{"/css/style.css" | relURL}}" />
+    <script src="https://code.jquery.com/jquery-3.4.1.slim.min.js" integrity="sha384-J6qa4849blE2+poT4WnyKhv5vZF5SrPo0iEjwBvKU7imGFAV0wwj1yYfoRSJoZ+n" crossorigin="anonymous"></script>
+    <script src="https://stackpath.bootstrapcdn.com/bootstrap/4.4.1/js/bootstrap.min.js" integrity="sha384-wfSDF2E50Y2D1uUdj0O3uMBJnjuUD4Ih7YwaYd1iqfktj0Uod8GCExl3Og8ifwB6" crossorigin="anonymous"></script>
 </head>
 
 <body>
-    <div class="container shadow-lg col-xl-6 rounded py-md-4 px-md-5 my-md-5">
-        <a href="{{"/" | relURL }}"><img src="{{ "/krew-logo.svg" }}" height="100vw"/></a>
+
+    <div class="container shadow-lg rounded
+        col-12 col-lg-8 col-xl-6
+        my-0 my-md-5
+        p-0">
+        {{ partial "navbar.html" . }}
+
+        <div class="py-md-4 pl-2 px-md-5">

site/layouts/partials/navbar.html

@@ -0,0 +1,29 @@
+<nav class="navbar navbar-expand-md navbar-light bg-light">
+    <a class="navbar-brand" href="{{"/" | relURL }}">
+        <img src="{{ "/img/krew-logo.svg" }}" height="40vw"/>
+    </a>
+
+    <button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbarNavAltMarkup" aria-controls="navbarNavAltMarkup" aria-expanded="false" aria-label="Toggle navigation">
+        <span class="navbar-toggler-icon"></span>
+    </button>
+    <div class="collapse navbar-collapse" id="navbarNavAltMarkup">
+        <div class="navbar-nav">
+          <a class="nav-item nav-link {{if .IsHome}}active{{end}}" href="{{"/"|relURL}}">
+            Home
+            {{if .IsHome}}<span class="sr-only">(current)</span>{{end}}
+        </a>
+
+        {{ $isQuickstart := (eq .Slug "quickstart") }}
+        {{ $isDocs := (and (eq .Section "docs") (ne .Slug "quickstart")) }}
+
+        <a class="nav-item nav-link {{if $isQuickstart}}active{{end}}" href="{{ "/docs/user-guide/quickstart/" | relURL}}">
+            Quickstart
+            {{if $isQuickstart}}<span class="sr-only">(current)</span>{{end}}
+        </a>
+        <a class="nav-item nav-link {{if $isDocs}}active{{end}}" href="{{ "/docs/" | relURL}}">
+            Documentation
+            {{if $isDocs}}<span class="sr-only">(current)</span>{{end}}
+        </a>
+        <a class="nav-item nav-link" href="https://sigs.k8s.io/krew">GitHub</a>
+    </div>
+</nav>

site/static/css/style.css

@@ -1,3 +1,7 @@
+div.top-level-container {
+    max-width: 840px;
+}
+
 blockquote {
     margin-left: 12px;
     color: #555;
@@ -7,7 +11,7 @@ blockquote {
 }
 
 article h1, article h2, article h3, article h4 {
-    font-weight: 200;
+    font-weight: 300;
 }
 
 pre {
@@ -30,3 +34,7 @@ pre {
 pre .cmdoutput {
     color: #aaa;
 }
+
+.lead {
+    letter-spacing: -1px;
+}

site/static/img/krew-logo.svg

@@ -0,0 +1 @@
+../../../assets/logo/horizontal/color/krew-horizontal-color.svg