{what you love} ∩ {what the world needs} ∩ {what you can be paid for} ∩ {what you are good at}Prerequisites
This article assumes you know about…
the Go Template language, which is also known as Go HTML,
the slice data structure,
and the set-theoretic intersection (∩) operator. For example, the Japanese concept Ikigai is the following intersection.
This intersection can be represented by the following Venn diagram.
Syntax
In a nutshell, the syntax of
Hugo’s intersect function
is this:
intersect SLICE1 SLICE2
Or, in a pipeline, this:
SLICE2 | intersect SLICE1
💡 | The order of
the
slice that
results
from this
intersection
is the order of
|
To learn more about this function, see…
and the example below.
Example
In Infinite Ink’s Hugo project, I tag an article by including something like this in the front matter of the article:
tags: - content - gohugo - mathematics - tech - yaml - secret
Note that
the
value of
this
tags[2]
key
is
a
slice.
To hide Infinite Ink’s secret[3] tags from the public, I do these two steps.
In the Hugo project’s
config.yaml,[4] I create the following user-definedlistablePortalssite-wide parameter.params: listablePortals: - activism-hacktivism - asciidoc - backup-sync - business-economics-money - cheatsheet - cli - covid - emoji - forked - git - git-bash - gohugo - golang - intellij - iusethis - joplin - longform - markdown - mathematics - mathjax - messaging - meta - nix-nux - privacy-security - productivity - qutebrowser - tech - tumblelog - twitter - unicode - utf-8 - vim - vscode - webdev - windows - words - zeitgeist
Note that the value of this
listablePortalskey is a slice.
In the relevant Hugo layout file, I include this Go Template code:
{{ $tags := .Params.tags }} {{ $portals := intersect site.Params.listablePortals $tags }} {{ range $portals }} <a href="/portal/{{- . -}}/">#{{- . -}}</a>  {{ end }}
For this article, this intersection code produces this:
More examples of results of this intersection code is in each tumblelogged item in the Elsewhere Links News section of Infinite Ink’s ChangeLog.
See also
For more about Hugo, see Infinite Ink’s…
A Way to Compare Hugo’s Markup Languages (featuring inline footnotes)
Configuring Security in Hugo (featuring settings needed to use Asciidoctor and Pandoc)
🔗 Linkified Section Headings in Hugo-Generated Web Pages (featuring Markdown and AsciiDoc examples)
Variable and Parameter Names in Hugo (featuring camelCase🐫 and snake_case🐍)
Hugo Tutorial: Bundleless, Themeless, & Gitless Introduction to the Hugo SSG
Hugo’s Markup Languages: AsciiDoc, HTML, Markdown,
Org-mode, Pandoc, and reStructuredTextHugo’s
.RenderStringMethod (featuring AsciiDoc admonitions in Markdown and Go HTML)
2. This
tags front-matter key is one of Hugo’s default taxonomies. To learn about this, see gohugo.io/content-management/taxonomies/ and www.ii.com/hugo-tutorial/#_taxonomies.3. An Infinite Ink secret tag, for example
yaml, is one that has not been turned into a portal. Most secret tags will eventually be portalized.🤞