Issue #272 Add tagging support

layouts/_default/content.html

@@ -1,17 +1,18 @@
 <div class="td-content">
-	<h1>{{ .Title }}</h1>
-    {{ with .Params.description }}<div class="lead">{{ . | markdownify }}</div>{{ end }}
-	{{ if (and (not .Params.hide_readingtime) (.Site.Params.ui.readingtime.enable)) }}
-        {{ partial "reading-time.html" . }}
+  {{ partial "article_meta.html" . }}
+  <h1>{{ .Title }}</h1>
+  {{ with .Params.description }}<div class="lead">{{ . | markdownify }}</div>{{ end }}
+    {{ if (and (not .Params.hide_readingtime) (.Site.Params.ui.readingtime.enable)) }}
+      {{ partial "reading-time.html" . }}
     {{ end }}       
-	{{ .Content }}
-	{{ if (and (not .Params.hide_feedback) (.Site.Params.ui.feedback.enable) (.Site.GoogleAnalytics)) }}
-		{{ partial "feedback.html" .Site.Params.ui.feedback }}
-		<br />
-	{{ end }}
-	{{ if (.Site.Params.DisqusShortname) }}
-		<br />
-		{{ partial "disqus-comment.html" . }}
-	{{ end }}
-	<div class="text-muted mt-5 pt-3 border-top">{{ partial "page-meta-lastmod.html" . }}</div>
+  {{ .Content }}
+  {{ if (and (not .Params.hide_feedback) (.Site.Params.ui.feedback.enable) (.Site.GoogleAnalytics)) }}
+    {{ partial "feedback.html" .Site.Params.ui.feedback }}
+    <br />
+  {{ end }}
+  {{ if (.Site.Params.DisqusShortname) }}
+    <br />
+    {{ partial "disqus-comment.html" . }}
+  {{ end }}
+  <div class="text-muted mt-5 pt-3 border-top">{{ partial "page-meta-lastmod.html" . }}</div>
 </div>

layouts/_default/taxonomy.html

@@ -0,0 +1,8 @@
+{{ define "main" }}
+  <section>
+    {{ range .Pages }}
+    {{ partial "summary.html" . }}
+    {{ end }}
+</section>
+{{ end }}
+

layouts/_default/terms.html

@@ -0,0 +1,13 @@
+{{ define "main" }}
+<section>
+  <header>
+  <h4>List of article {{ .Section }}</h4>
+  </header>
+</section>
+  {{ range $key, $value := .Data.Terms }}
+  {{ $postCount := len $value.Pages  }}
+  <a href="{{ "/" | relLangURL }}{{ $.Data.Plural | urlize }}/{{ $key | urlize }}">
+  <h5>{{ $key }} : 
+  <span class="badge badge-light">{{ $postCount }}</span></h5></a>
+  {{ end }}
+{{ end }}

layouts/partials/article_meta.html

@@ -0,0 +1,3 @@
+<header class="article-meta clearfix">
+  {{ partial "article_tags.html" . }}
+</header>

layouts/partials/article_tags.html

@@ -0,0 +1,7 @@
+{{ with (.GetTerms "tags")}}
+<div class="article-tags">
+    {{ range . }}
+    <span class="badge badge-light"><a class="article-tags-link" href="{{ .Permalink }}">{{ .Name }}</a></span>
+    {{ end }}
+</div>
+{{end}}

layouts/partials/summary.html

@@ -0,0 +1,12 @@
+<div class="pageinfo pageinfo-primary">
+  <div class = 'summary'>
+    <div class = 'summary_header'>
+      <h3 class = 'post_link'>
+        <a href='{{ .Permalink }}'>{{ .Title  }}</a>
+      </h3>
+      {{ partial "article_meta.html" . }}
+    </div>
+    <p class = 'summary_section'>{{ .Summary | truncate 320 }}</p>
+    <a href='{{ .Permalink }}' class='excerpt_more button'>Read More</a>
+    </div>
+</div>

layouts/partials/tags.html

@@ -0,0 +1,14 @@
+<hr>
+{{ if isset .Site.Taxonomies "tags" }}
+{{ if not (eq (len .Site.Taxonomies.tags) 0) }}
+<div class="tagslist">
+    <p class="asidetitle">{{ .Site.Params.Strings.Tags | default "Tag Cloud" }}</p>
+    <ul class="clearfix">
+        {{ range $name, $items := .Site.Taxonomies.tags }}
+        <li><a href="{{ .Page.Permalink }}" title="{{ $name }}">{{ .Page.Title }}<sup>{{ len $items }}</sup></a></li>
+        {{ end }}
+    </ul>
+</div>
+{{ end }}
+{{ end }}
+<hr>

layouts/partials/toc.html

@@ -5,4 +5,5 @@
 {{ . }}
 {{ end }}
 {{ end }}
-{{ end }}
+<!-- {{ partial "tags.html" . }} -->
+{{ end }}

netlify.toml

@@ -8,6 +8,6 @@
 
 # "production" environment specific build settings
 [build.environment]
-  HUGO_VERSION = "0.76.5"
+  HUGO_VERSION = "0.79.0"
   HUGO_THEME = "repo"
   HUGO_ENV = "production"

userguide/config.toml

@@ -16,7 +16,8 @@ defaultContentLanguageInSubdir = false
 # Useful when translating.
 enableMissingTranslationPlaceholders = true
 
-disableKinds = ["taxonomy", "taxonomyTerm"]
+[taxonomies]
+tags = "tags"
 
 # Highlighting config
 pygmentsCodeFences = true

userguide/content/en/docs/Best practices/site-guidance.md

@@ -39,3 +39,22 @@ find and automatically link to your file named `filename.md`.
 Note, however, that `ref` and `relref` links don't work with `_index` or `index` files (for example, this site's [content landing page](/docs/adding-content/)): you'll need to use regular Markdown links to section landing or other index pages. Specify these links relative to the site's root URL, for example: `/docs/adding-content/`.
 
 [Learn more about linking](/docs/adding-content/content/#working-with-links). 
+
+## Tagging
+
+An example of Tagging on a live site can be seen at the [TrueNAS Docs Site](https://www.truenas.com/docs/hub/).
+
+Tagging is enabled on articles, but can be disabled by adding the line: `disableKinds = ["taxonomy", "taxonomyTerm"]` in config.toml.  
+To add tags to an article, add a 'tags:' line to the front matter on each article.
+Example: `tags: ["tag1"]` 
+Multiple tags can be added separated by commas: `tags: ["tag1","tag2","tag3"]`
+
+This will enable a list that will show ever article with that tag when someone clicks on it.
+
+<img src="/images/tag-demo-2.PNG" width='700px'>
+<br>
+
+A Tag Cloud is available that will display all tags and numbers of each tag in the right sidebar.  To enable the tag cloud, uncomment line 8 of toc.html in the partials subdirectory.
+
+<img src="/images/tag-demo-1.PNG" width='700px'>
+<br>

userguide/content/en/docs/Examples/_index.md

@@ -1,8 +1,10 @@
 ---
 title: "Examples"
 weight: 8
+tags: ["examples"]
 description: >
   Some examples of Docsy in action!
+
 ---
 
 One of the best ways to see what Docsy can do, and learn how to configure a site with it, is to see some real projects. In addition to our provided Docsy Example Project, there are several live sites already using the theme. Please add your own examples once you've got a production site up and running with Docsy!
@@ -20,6 +22,7 @@ Example sites that have low to no customization:
 | https://googlecontainertools.github.io/kpt/ | https://github.com/GoogleContainerTools/kpt/tree/master/docs | 
 | [Navidrome Music Server](https://www.navidrome.org) | https://github.com/navidrome/website | 
 | https://docs.agilebase.co.uk/ | https://github.com/okohll/abdocs | 
+| [TrueNAS Docs](https://docs.truenas.com/) | https://github.com/freenas/documentation |
 
 ## Customized Docsy examples