Listing content by Taxonomy doesn't work #272

q5sys · 2020-05-08T16:49:28Z

Hoping you can point me in the right direction.
I've got Docsy installed and its working great.
I wanted to add tagging into it, so I've edited my config.toml to add

[taxonomies]
tags = "tags"

and I then removed disableKinds = ["taxonomy", "taxonomyTerm"]

Ive written my tags partial, and added the partial to content.html.
When I add the taxonomy to the front matter of a markdown file, the tags render properly.

However when I click one, I expect to get the list of all taxonomies in the typical way that Hugo does that, however all I ever get is a blank page.
I'm trying to track down what in Docsy would be causing this, and the only thing I can come up with is that list.html has been changed.
Would that be it, or is there something else in Docsy which would break Hugo from being able to display the list of taxonomies? From my understanding that's a built in feature of Hugo, and I've never had any problems using it before.
Thanks!

The text was updated successfully, but these errors were encountered:

LisaFC · 2020-05-12T11:12:18Z

Hmm, that's strange. It might need its own list.html layout to display the results. I'll take a look.

What version of Hugo are you using, as I think there's some newish Taxonomy stuff in recent versions.

q5sys · 2020-05-12T15:06:33Z

I'm currently using 0.69 and I've tested on 0.66 and 0.68 with the same results. I have yet to try out the newer 0.70 from last week. I've got some time later this week to try a few other things, so I'll report back if I figure anything else out.

q5sys · 2020-06-16T14:10:18Z

Sorry for the delay in responding, life has been busy.
I've finally gotten the time to test this the other day with the newest 0.72 extended release. but I'm still getting a blank page. I'm guessing it has to be something with the list.html file as mentioned before. At the bottom I'll append the list.html i've used before, but its not working with Docsy, it may be a simple issue, but i'm not seeing it.

Here's everything I've done with the default Docsy example site in this testing:

I edited config.toml and removed disableKinds = ["taxonomy", "taxonomyTerm"] and added:

[taxonomies]
products = "products"

I added {{ partial "article_meta.html" . }}
as line 2 of ./docsy/layouts/_default/content.html

created ./docsy/layouts/partials/article_meta.html

<header class="article-meta clearfix">
  {{ partial "article_tags.html" . }}
</header>

I created ./docsy/layouts/partials/article_tags.html

{{ if isset .Params "products" }}
{{ if not (eq (len .Params.products) 0) }}
<div class="article-products">
  <span></span>
  {{ range .Params.products }}
  <a class="article-products-link" href="{{ $.Site.BaseURL }}/products/{{ . | urlize }}">{{ . }}</a>
  {{ end }}
</div>
{{ end }}
{{ end }}

Then in an article I add something like products: ["k8s"] to the frontmatter.
When I run hugo, the tag shows up at the top of the article and it is clickable, if I click it I'm taking to the proper taxonomies page, but it will be blank. My expectation, and what I've gotten with other Hugo themes is that I get a list of all articles with that Taxonomy tag. However for a documentation site, Docsy is the best theme I've come across so Docsy is what I want to use.

My functioning list.html on other hugo sites:

{{ partial "head.html" . }}
<body>
  <header>
    {{ partial "header.html" . }}
  </header>
  <div id="container">
    <div id="main">
      {{ range .Data.Pages.GroupByDate "2006-01" }}
      <h2 id="{{ .Key }}">{{ .Key }}</h2>
      {{ range .Pages }}
      {{ partial "article.html" . }}
      {{ end }}
      {{ end }}
    </div>
    {{ partial "sidebar.html" . }}
  </div>
  <footer>{{ partial "footer.html" . }}</footer>
  {{ partial "after_footer.html" .}}
</body>
</html>

nlundquist · 2020-08-05T00:44:52Z

This is due to Docsy not defining any appropriate template for a single taxonomy or a taxonomy listing, e.g of the templates listed at the following:
https://gohugo.io/templates/lookup-order/#examples-layout-lookup-for-taxonomy-pages

the only one defined by docsy is layouts/_default/list.html which is simply:

{{ define "main" }}
{{ with .Content }}
{{ . }}
{{ end }}
{{ end }}

Since taxonomy pages do not have defined .Content, they render blank.

Adding implementations of layouts/_default/tag.html & layouts/_default/tag.terms.html will result in better output.

LisaFC · 2020-08-05T10:33:57Z

Ahhhh, thanks for that. I'll have a play around with adding those templates and see if I can get it working.

q5sys · 2020-08-11T14:48:09Z

Interesting, none of the Hugo sites I've used before have a tag.html or tag.terms.html defined. Actually none of them have had anything special in any way that I can figure out which allows the taxonomies to work, but maybe I'm missing something obvious.
https://github.com/chipzoller/hugo-clarity
https://github.com/colorchestra/smol
https://github.com/huyb1991/hugo-lamp
https://github.com/coderzh/hugo-pacman-theme

q5sys · 2020-08-13T14:30:24Z

Ok, so I managed to get this working, but right now its raw and ugly so it doesn't fit into the rest of the nice docsy themeing I'll work on cleaning it up and then file a PR. Or If I cant manage to get the themeing cleaned up, I'll just push it to a fork and let you pull what you need.

b-jsshapiro · 2020-10-08T20:52:38Z

I was planning to add this as well, so if you feel inclined to share your new template files I'd sure appreciate it.

@nlundquist: Does the list template get used for pages that generate subdirectory listings? I haven't been entirely happy with how that currently works in Docsy, but wasn't entirely sure which template to touch.

q5sys · 2020-10-08T23:09:07Z

@b-jsshapiro hopefully I can get time this weekend to finish up the PR, then you can see exactly how I have the template set up.

honzik20 · 2020-12-10T13:49:00Z

Ok, so I managed to get this working, but right now its raw and ugly so it doesn't fit into the rest of the nice docsy themeing I'll work on cleaning it up and then file a PR. Or If I cant manage to get the themeing cleaned up, I'll just push it to a fork and let you pull what you need.

@q5sys Can you tell me how you got it working? I'm still coming up with blank pages...

q5sys · 2020-12-12T15:15:24Z

@honzik20 all my work is here: https://github.com/q5sys/docsy
As mentioned in the PR I'd like to set a config param that could be used with an if statement in toc.html, to avoid someone having to edit the files to enable the tag cloud but I havent worked that out yet.

huehnerlady · 2021-05-28T10:55:33Z

Hi, I find this really interesting and would also like to use it. Is there any update on this? :)

narrenfrei · 2021-05-28T11:24:00Z

Hi @huehnerlady, yes I've started a new PR #554 which is ready to merge (since about 5-6 hours). I'm only waiting for some feedback (#554 (comment)) and some issues with the google-cla bot have to been solved ;-)

taxonomy support #272 #324 #539

narrenfrei mentioned this issue May 2, 2021

WIP - taxonomy support #272 #324 #539

Closed

narrenfrei mentioned this issue May 11, 2021

taxonomy support #272 #324 #539 #554

Merged

LisaFC added a commit that referenced this issue Jun 11, 2021

Merge pull request #554 from narrenfrei/dev-taxonomy-2

6e6061b

taxonomy support #272 #324 #539

This was referenced Aug 17, 2021

[Snyk] Security upgrade postcss-cli from 5.0.1 to 7.0.0 MaxMood96/docsy#1

Open

[Snyk] Security upgrade postcss-cli from 5.0.1 to 7.0.0 CF-GG/docsy#1

Open

This was referenced Sep 15, 2021

[Snyk] Security upgrade postcss-cli from 5.0.1 to 7.0.0 CF-GG/docsy#2

Open

[Snyk] Security upgrade postcss-cli from 5.0.1 to 7.0.0 MaxMood96/docsy#9

Open

snyk-bot mentioned this issue Oct 29, 2021

[Snyk] Security upgrade postcss-cli from 5.0.1 to 7.0.0 MaxMood96/docsy#22

Open

MaxMood96 mentioned this issue May 13, 2022

[Snyk] Security upgrade postcss-cli from 5.0.1 to 7.0.0 MaxMood96/docsy#68

Open

This was referenced Nov 27, 2023

[Snyk] Security upgrade postcss-cli from 5.0.1 to 7.0.0 MaxMood96/docsy#71

Open

[Snyk] Security upgrade postcss-cli from 5.0.1 to 7.0.0 CF-GG/docsy#5

Open

MaxMood96 mentioned this issue Dec 20, 2023

[Snyk] Security upgrade postcss-cli from 5.0.1 to 7.0.0 CF-GG/docsy#7

Open

This was referenced May 14, 2024

[Snyk] Security upgrade postcss-cli from 5.0.1 to 7.0.0 MaxMood96/docsy#73

Open

[Snyk] Security upgrade postcss-cli from 5.0.1 to 7.0.0 CF-GG/docsy#8

Open

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Listing content by Taxonomy doesn't work #272

Listing content by Taxonomy doesn't work #272

q5sys commented May 8, 2020

LisaFC commented May 12, 2020

q5sys commented May 12, 2020

q5sys commented Jun 16, 2020 •

edited

Loading

nlundquist commented Aug 5, 2020 •

edited

Loading

LisaFC commented Aug 5, 2020

q5sys commented Aug 11, 2020

q5sys commented Aug 13, 2020

b-jsshapiro commented Oct 8, 2020

q5sys commented Oct 8, 2020

honzik20 commented Dec 10, 2020

q5sys commented Dec 12, 2020

huehnerlady commented May 28, 2021

narrenfrei commented May 28, 2021

Listing content by Taxonomy doesn't work #272

Listing content by Taxonomy doesn't work #272

Comments

q5sys commented May 8, 2020

LisaFC commented May 12, 2020

q5sys commented May 12, 2020

q5sys commented Jun 16, 2020 • edited Loading

nlundquist commented Aug 5, 2020 • edited Loading

LisaFC commented Aug 5, 2020

q5sys commented Aug 11, 2020

q5sys commented Aug 13, 2020

b-jsshapiro commented Oct 8, 2020

q5sys commented Oct 8, 2020

honzik20 commented Dec 10, 2020

q5sys commented Dec 12, 2020

huehnerlady commented May 28, 2021

narrenfrei commented May 28, 2021

q5sys commented Jun 16, 2020 •

edited

Loading

nlundquist commented Aug 5, 2020 •

edited

Loading