New approach to extracting publication data and filtering/searching it #17

Merged

jsheunis merged 1 commit from pubs into main

2026-04-13 08:55:14 +00:00

jsheunis commented

2026-04-13 08:54:20 +00:00

Member

This commit introduces the process for individual publication term page generation, which includes a new jinja template and workflow. Since publications is a taxonomy, the workflow renders the term page at content/publications/<pub-pid>/_index.md. For the same reason, the (more) correct html template to use would be publications/taxonomy.html instead of publications/list.html (which is actually the fallback), hence the replacement.

Since, individual publication metadata are included in each individual term page front matter, the taxonomy page has been updated to grab that metadata instead of reading the json object from data/publications.json. This also allows the associated workflow to be dropped.

A new publication-item partial is introduced to allow better control over the rendering of individual items in the publication list on the taxonomy page. This intentionally shifts the rendering that was previously done in JS code to Hugo templating. Because hugo only runs the rendering on app build, the searching/filtering approach had to be changed so that all publications are rendered by default and required items are hidden depending on the filtering options selected or search terms entered. This is done in updated JS code, by assigning display: none when applicable. Other JS additions include:

adding a count of filtered items
a new 'Clear all' button for clearing filters
allowing Topic pills to be clicked in order to add filter options

TODO: customize the publications term page template for improved individual publication display.

This commit introduces the process for individual publication term page generation, which includes a new jinja template and workflow. Since `publications` is a taxonomy, the workflow renders the term page at `content/publications/<pub-pid>/_index.md`. For the same reason, the (more) correct html template to use would be `publications/taxonomy.html` instead of `publications/list.html` (which is actually the fallback), hence the replacement. Since, individual publication metadata are included in each individual term page front matter, the taxonomy page has been updated to grab that metadata instead of reading the json object from `data/publications.json`. This also allows the associated workflow to be dropped. A new `publication-item` partial is introduced to allow better control over the rendering of individual items in the publication list on the taxonomy page. This intentionally shifts the rendering that was previously done in JS code to Hugo templating. Because hugo only runs the rendering on app build, the searching/filtering approach had to be changed so that all publications are rendered by default and required items are hidden depending on the filtering options selected or search terms entered. This is done in updated JS code, by assigning `display: none` when applicable. Other JS additions include: - adding a count of filtered items - a new 'Clear all' button for clearing filters - allowing Topic pills to be clicked in order to add filter options TODO: customize the publications term page template for improved individual publication display.

jsheunis added 1 commit

2026-04-13 08:54:20 +00:00

New approach to extracting publication data and filtering/searching it

Deploy on webserver / Build site and deploy on success (push) Failing after 1s

Details

066c879dfe

This commit introduces the process for individual publication term page
generation, which includes a new jinja template and workflow. Since
'publications' is a taxonomy, the workflow renders the term page at
'content/publications/pub-pid/_index.md'. For the same reason, the
(more) correct html template to use would be 'publications/taxonomy.html'
instead of 'publications/list.html' (which is actually the fallback),
hence the replacement.

Since, individual publication metadata are included in each individual
term page front matter, the taxonomy page has been updated to grab that
metadata instead of reading the json object from 'data/publications.json'.
This also allows the associated workflow to be dropped.

A new 'publication-item' partial is introduced to allow better control
over the rendering of individual items in the publication list on the
taxonomy page. This intentionally shifts the rendering that was previously
done in JS code to Hugo templating. Because hugo only runs the rendering
on app build, the searching/filtering approach had to be changed so that
all publications are rendered by default and required items are hidden
depending on the filtering options selected or search terms entered.
This is done in updated JS code, by assigning 'display: none' when
applicable. Other JS additions include:
- adding a count of filtered items
- a new 'Clear all' button for clearing filters
- allowing Topic pills to be clicked in order to add filter options

TODO: customize the publications term page template for improved individual
publication display.