shithub: hugo

Info  •  Files  •  Log  •  Branches

docs: Add additional example for taxonomies listing

Add another example how to list taxonomies inline,
adding title (singular or plural) and commas between taxonomies.

See #2143

--- a/docs/content/taxonomies/displaying.md

+++ b/docs/content/taxonomies/displaying.md

@@ -1,7 +1,7 @@

 ---

 aliases:

 - /indexes/displaying/

-lastmod: 2015-05-22

+lastmod: 2016-05-13

 date: 2013-07-01

 linktitle: Displaying

 menu:

@@ -41,6 +41,19 @@

         <li><a href="tags/{{ . | urlize }}">{{ . }}</a> </li>

       {{ end }}

     </ul>

+

+If you want to list taxonomies inline, you will have to take

+care of optional plural ending in the title (if multiple taxonomies),

+as well as commas. Let's say we have a taxonomy "directors" such as

+`directors: [ "Joel Coen", "Ethan Coen" ]` in the TOML-format front matter.

+To list such taxonomy use the following:

+

+### Example

+

+    {{ if .Params.directors }}

+      <strong>Director{{ if gt (len .Params.directors) 1 }}s{{ end }}:</strong>

+      {{ range $index, $director := .Params.directors }}{{ if gt $index 0 }}, {{ end }}<a href="directors/{{ . | urlize }}">{{ . }}</a>{{ end }}

+    {{ end }}

 ## 2. Listing content with the same taxonomy term