hextra icon indicating copy to clipboard operation
hextra copied to clipboard

Tags support for docs

Open ianchov opened this issue 1 year ago • 5 comments

Hi,

Great theme. Will you add tag support for docs?

Thanks

ianchov avatar Sep 26 '23 18:09 ianchov

Thanks for the suggestion. Tags are planned for Hextra's future roadmap. Could you elaborate on how you envision using tags in docs, perhaps with examples?

imfing avatar Sep 26 '23 18:09 imfing

Hey thanks for the fast response. I want to use tags in a book type content (aka docs structure)

ianchov avatar Sep 26 '23 18:09 ianchov

I'm going to add specific kind of tags support: A way to automatically link docs pages to relevant blog posts:

  1. I'll set tags in docs via cascade in the Hugo config.
  2. In blog posts, I'll manually add tags when I write them.
  3. My template coding will use the .Related function in docs to link to these blog posts with matching tags.

dogweather avatar Apr 15 '24 22:04 dogweather

A way to automatically link docs pages to relevant blog posts:

  1. I'll set tags in docs via cascade in the Hugo config.

Could you give some examples?

imfing avatar Apr 15 '24 23:04 imfing

Could you give some examples?

Sure. I have docs hierarchies for different programming languages. I create these pages with a headless CMS. So, instead of changing the markdown documents, I could do this:

cascade:
- _target:
    path: "python/**"
  tags:
  - python

(Now that I write that out, I dislike how redundant it is. Hugo might have some way match slug and tag. Or maybe I would change my CMS to output tags in the frontmatter.)

dogweather avatar Apr 16 '24 00:04 dogweather