hugo: display command aliases

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>

content/engine/reference/commandline/container_exec.md

@@ -1,6 +1,7 @@
 ---
 datafolder: engine-cli
 datafile: docker_container_exec
+linkTitle: docker exec
 title: docker container exec
 aliases:
 - /edge/engine/reference/commandline/container_exec/

content/engine/reference/commandline/container_ls.md

@@ -1,6 +1,7 @@
 ---
 datafolder: engine-cli
 datafile: docker_container_ls
+linkTitle: docker ps
 title: docker container ls
 aliases:
 - /edge/engine/reference/commandline/container_ls/

content/engine/reference/commandline/container_run.md

@@ -1,6 +1,7 @@
 ---
 datafolder: engine-cli
 datafile: docker_container_run
+linkTitle: docker run
 title: docker container run
 aliases:
 - /edge/engine/reference/commandline/container_rm/

content/engine/reference/commandline/image_build.md

@@ -1,6 +1,7 @@
 ---
 datafolder: engine-cli
 datafile: docker_image_build
+linkTitle: docker build
 title: docker image build
 aliases:
 - /edge/engine/reference/commandline/image_build/

content/engine/reference/commandline/image_ls.md

@@ -1,6 +1,7 @@
 ---
 datafolder: engine-cli
 datafile: docker_image_ls
+linkTitle: docker images
 title: docker image ls
 aliases:
 - /edge/engine/reference/commandline/image_ls/

content/engine/reference/commandline/image_pull.md

@@ -1,6 +1,7 @@
 ---
 datafolder: engine-cli
 datafile: docker_image_pull
+linkTitle: docker pull
 title: docker image pull
 aliases:
 - /edge/engine/reference/commandline/image_pull/

content/engine/reference/commandline/image_push.md

@@ -1,6 +1,7 @@
 ---
 datafolder: engine-cli
 datafile: docker_image_push
+linkTitle: docker push
 title: docker image push
 aliases:
 - /edge/engine/reference/commandline/image_push/

content/engine/reference/commandline/system_info.md

@@ -1,6 +1,7 @@
 ---
 datafolder: engine-cli
 datafile: docker_system_info
+linkTitle: docker info
 title: docker system info
 aliases:
 - /edge/engine/reference/commandline/system_info/

layouts/_default/cli.html

@@ -13,8 +13,16 @@
   {{ .Scratch.Set "subheadings" slice }}
   {{ partial "breadcrumbs.html" . }}
   <article class="DocSearch-content prose max-w-none dark:prose-invert">
-    {{ with .Title }}
+    {{ if ne .LinkTitle .Title }}
-    <h1 class="scroll-mt-36">{{ . }}</h1>
+    {{/*
+      we use linkTitle for surfacing popular aliases like "docker run"
+      if linkTitle is set, use both alias and canonical cmd as title
+    */}}
+    <h1 class="scroll-mt-36">{{ .LinkTitle }}<span
+      class="text-gray-light dark:text-gray-dark"> ({{ .Title }})</span>
+    </h1>
+    {{ else }}
+    <h1 class="scroll-mt-36">{{ .Title }}</h1>
     {{ end }}
     {{ $data.short | .RenderString (dict "display" "block") }}
     {{ if $data.deprecated }}
@@ -57,6 +65,17 @@
       {{ $.Scratch.Add "headings" $heading }}
       {{ highlight (strings.Replace . "\t" "") "console" }}
     {{ end }}
+    {{ with $data.aliases }}
+      {{ $heading := dict "level" 2 "text" "Aliases" }}
+      {{ partial "heading.html" $heading }}
+      {{ $aliases := strings.Split . ", " }}
+      <p>The following commands are equivalent and redirect here:</p>
+      <ul>
+      {{ range $aliases }}
+        <li><code>{{ . }}</code></li>
+      {{ end }}
+      </ul>
+    {{ end }}
     {{ with $data.long }}
       {{ $heading := dict "level" 2 "text" "Description" }}
       {{ partial "heading.html" $heading }}