Converting a LinkTitle (or a Title) to the default Slug

support
1

Is there a string function that will give me the default slug from the taxonomy term (I would rather not declare the slug in my front-matter). I am currently using (what appears to me) a rather expensive round-about way to get each taxonomy slug like this:

{{ range $term, $value := .Data.Terms }}
  {{ with index $value 0 }}
    {{ $slug := (index (where $.Pages "LinkTitle" .LinkTitle) 0).RelPermalink }}
    // Use $slug after stripping a possible trailing filename here
  {{- end }}
{{- end

I did try .LinkTitle | urlize and while that removes obvious inappropriate characters like “:”, it does not work with Unicode characters in the title.

2

What’s the objective?

3

I have a script that updates an Algolia index and is triggered by a Git Webhook. This script reads an “index.json” generated by a template. I need to add a field in items of that index that will tell me the path of each taxonomy term so I can visit and get the individual articles of that taxonomy term.

My apologies if that explanation was inadequate (not a native English speaker). I would happy to answer any further queries you might have.

I was hoping that the steps would be (1) replace spaces by hyphens (2) lowercase everything and (3) remove special characters. So in the eventt that such a pre-defined function does not exist, just the complete list of special characters to remove/replace would be a solution that I would be happy with

4

path or URL?

5

The file path. So I can traverse the files in the folder where all files corresponding to the taxonomy term are generated.

6

I’m sorry. I still don’t understand. It seems like you’re asking for the relative permalink.

7

Don’t be :slight_smile: Indeed, I did fetch .PermaLink but that is because .Permalink in the loop over .Data.Terms (see original post) returns the folder name relative to the public folder inside each iteration. So in thsi happy circumstance .Permalink and the path are identical.

8

To illustrate with an example: If my Taxonomy term is “Bruce: Willis” - Under which folder can I find all articles tagged by “Bruce: Willis” - It turns out to be actors/bruce-willis As you can see, the code in my original post does give me the correct answer. But my concern is that I am jumping through two hoops to get it. And my question was is there a simple function call (or a predictrable manual transformation that will convert “Bruce: Willis” into “bruce-willis”.

For a loooong time, I mistakenly did a simple (.RelPermalink | urlize) which did what I wanted until GĂ©rard Depardieu turned up :slight_smile: and the folder name was incorrectly returned as g%C3%A9rard-depardieu by urlize. Just an example.

9

Typically “files corresponding to the taxonomy term” are published in the section corresponding to their content type (e.g., public/articles/article-1/index.html).

The colon (:) is not allowed. See this tips and tricks topic, which is not yet included in our documentation:
https://discourse.gohugo.io/t/limit-use-of-punctuation-within-taxonomy-terms/48638

You cannot currently transform “g%C3%A9rard-depardieu” to “gérard-depardieu”. I had to do this recently in #14094, and was able to use Go’s url.PathUnescape function. But we don’t have a Hugo equivalent yet. See:
https://github.com/gohugoio/hugo/issues/14209

EDIT 2025-12-12T08:55:06-08:00: We added urls.PathEscape and urls.PathUnescape in v0.153.0.

10

Thanks!! That explains what was happening in my case. Your link to the partial to validate taxonomy terms will be a huge help going forward.

1 Like
11

This topic was automatically closed 2 days after the last reply. New replies are no longer allowed.