Added Tags to Docs Pages

Author: Jan Palma

exampleSite/content/docs/getting-started.md

@@ -1,6 +1,9 @@
 ---
 title: Getting Started
 weight: 1
+tags:
+  - Docs
+  - Guide
 next: /docs/guide
 prev: /docs
 ---

exampleSite/content/docs/guide/configuration.md

@@ -1,6 +1,8 @@
 ---
 title: Configuration
 weight: 2
+tags:
+  - Config
 ---
 
 Hugo reads its configuration from `hugo.yaml` in the root of your Hugo site.

exampleSite/hugo.yaml

@@ -167,6 +167,9 @@ params:
     article:
       displayPagination: true
 
+  docs:
+    displayTags: true
+
   highlight:
     copy:
       enable: true

exampleSite/hugo_stats.json

@@ -2,6 +2,7 @@
   "htmlElements": {
     "tags": [
       "a",
+      "annotation",
       "article",
       "aside",
       "blockquote",
@@ -34,13 +35,31 @@
       "li",
       "link",
       "main",
+      "math",
       "meta",
+      "mfrac",
+      "mi",
+      "mn",
+      "mo",
+      "mover",
+      "mpadded",
+      "mphantom",
+      "mrow",
+      "mstyle",
+      "msub",
+      "msubsup",
+      "msup",
+      "mtable",
+      "mtd",
+      "mtext",
+      "mtr",
       "nav",
       "ol",
       "p",
       "path",
       "pre",
       "script",
+      "semantics",
       "span",
       "strong",
       "style",
@@ -64,14 +83,21 @@
       "[counter-reset:step]",
       "[hyphens:auto]",
       "[word-break:break-word]",
+      "base",
       "chroma",
+      "col-align-l",
+      "col-align-r",
       "content",
       "copy-icon",
       "dataframe",
+      "delimcenter",
+      "delimsizing",
       "filename",
+      "fix",
       "footnote-backref",
       "footnote-ref",
       "footnotes",
+      "frac-line",
       "hamburger-menu",
       "hextra-badge",
       "hextra-card",
@@ -92,12 +118,16 @@
       "hextra-jupyter-code-cell",
       "hextra-jupyter-code-cell-outputs",
       "hextra-jupyter-code-cell-outputs-container",
+      "hextra-max-footer-width",
+      "hextra-max-navbar-width",
+      "hextra-max-page-width",
       "hextra-pdf",
       "hextra-scrollbar",
       "hextra-sidebar-collapsible-button",
       "hextra-tabs-panel",
       "hextra-tabs-toggle",
       "hextra-toc",
+      "hide-tail",
       "highlight",
       "hx:-mb-0.5",
       "hx:-ml-2",
@@ -391,6 +421,7 @@
       "hx:ltr:rotate-180",
       "hx:ltr:text-right",
       "hx:m-[11px]",
+      "hx:max-h-(--menu-height)",
       "hx:max-h-64",
       "hx:max-h-[calc(100vh-var(--navbar-height)-env(safe-area-inset-bottom))]",
       "hx:max-h-[min(calc(50vh-11rem-env(safe-area-inset-bottom)),400px)]",
@@ -404,7 +435,6 @@
       "hx:max-w-[90rem]",
       "hx:max-w-[min(calc(100vw-2rem),calc(100%+20rem))]",
       "hx:max-w-none",
-      "hx:max-w-screen-xl",
       "hx:max-xl:hidden",
       "hx:mb-10",
       "hx:mb-12",
@@ -578,6 +608,7 @@
       "hx:text-indigo-900",
       "hx:text-left",
       "hx:text-lg",
+      "hx:text-none",
       "hx:text-orange-800",
       "hx:text-primary-800",
       "hx:text-red-900",
@@ -618,25 +649,66 @@
       "hx:z-20",
       "hx:z-[-1]",
       "icon",
+      "inner",
+      "katex",
+      "katex-display",
+      "katex-html",
+      "katex-mathml",
       "language-options",
       "language-switcher",
+      "large-op",
       "lntable",
       "lntd",
+      "mathbf",
+      "mathnormal",
+      "mathrm",
+      "mbin",
+      "mclose",
       "mermaid",
+      "mfrac",
+      "minner",
+      "mop",
+      "mopen",
+      "mord",
+      "mrel",
+      "mspace",
+      "msupsub",
+      "mtable",
+      "mtight",
       "nav-container",
       "nav-container-blur",
       "next-error-h1",
       "not-prose",
+      "nulldelimiter",
+      "op-symbol",
       "open",
+      "pstrut",
+      "reset-size3",
+      "reset-size6",
+      "rlap",
       "search-input",
       "search-results",
       "search-wrapper",
       "sidebar-active-item",
       "sidebar-container",
+      "size1",
+      "size3",
+      "sizing",
       "steps",
+      "strut",
       "subheading-anchor",
       "success-icon",
-      "theme-toggle"
+      "svg-align",
+      "text",
+      "textrm",
+      "theme-toggle",
+      "vlist",
+      "vlist-r",
+      "vlist-s",
+      "vlist-t",
+      "vlist-t2",
+      "x-arrow",
+      "x-arrow-pad"
     ],
     "ids": null
   }

layouts/_default/term.html

@@ -8,7 +8,7 @@
         {{ if .Title }}<h1 class="hx:text-center hx:mt-2 hx:text-4xl hx:font-bold hx:tracking-tight hx:text-slate-900 hx:dark:text-slate-100">{{ .Title }}</h1>{{ end }}
         <div class="hx:mb-16"></div>
         <div class="content">
-          {{ .Content }}
+           {{ .Content }}
         </div>
         <div>
           {{- range .Pages -}}
@@ -21,9 +21,16 @@ <h3>
                   title="{{ .LinkTitle }}"
                 >
                   {{ .Title }}
+                  {{ if eq .Section "docs" }}
+                    <span class="hx:text-none hx:inline-flex hx:gap-1 hx:items-center hx:rounded-full hx:px-2 hx:leading-6 hx:text-[.65rem] hx:border hx:text-gray-600 hx:bg-gray-100 hx:dark:bg-neutral-800 hx:dark:text-neutral-200 hx:border-gray-200 hx:dark:border-neutral-700 ">
+                      Docs
+                    </span>
+                  {{ end }}
                 </a>
+                {{ if .Date }}
+                   <p class="hx:opacity-50 hx:text-sm hx:leading-7">{{ partial "utils/format-date" .Date }}</p>
+                {{ end }}
               </h3>
-              <p class="hx:opacity-50 hx:text-sm hx:leading-7">{{ partial "utils/format-date" .Date }}</p>
             </div>
           {{- end -}}
         </div>

layouts/blog/list.html

@@ -14,7 +14,7 @@ <h3><a style="color: inherit; text-decoration: none;" class="hx:block hx:font-se
             {{- if site.Params.blog.list.displayTags -}}
               {{ with .Params.tags }}
                 <p class="hx:opacity-50 hx:text-sm hx:leading-7">
-                  {{- range . }}<a class="hx:inline-block hx:mr-2">#{{ . }}</a>{{ end -}}
+                  {{- range . }}<a class="hx:inline-block hx:mr-2" href='{{ "/tags/" | relLangURL }}{{ . | urlize }}'>#{{ . }}</a>{{ end -}}
                 </p>
               {{ end -}}
             {{- end -}}

layouts/docs/single.html

@@ -5,8 +5,16 @@
     <article class="hx:w-full hx:break-words hx:flex hx:min-h-[calc(100vh-var(--navbar-height))] hx:min-w-0 hx:justify-center hx:pb-8 hx:pr-[calc(env(safe-area-inset-right)-1.5rem)]">
       <main class="hx:w-full hx:min-w-0 hx:max-w-6xl hx:px-6 hx:pt-4 hx:md:px-12">
         {{ partial "breadcrumb.html" . }}
+        {{- if site.Params.docs.displayTags -}}
+          {{ with .Params.tags }}
+            <p class="hx:opacity-50 hx:text-sm hx:leading-7 hx:pt-4">
+              {{- range . }}<a class="hx:inline-block hx:mr-2" href='{{ "/tags/" | relLangURL }}{{ . | urlize }}'>#{{ . }}</a>{{ end -}}
+            </p>
+          {{ end -}}
+        {{- end -}}
         <div class="content">
           {{ if .Title }}<h1>{{ .Title }}</h1>{{ end }}
+          
           {{ .Content }}
         </div>
         {{ partial "components/last-updated.html" . }}