Skip to content

Conversation

@stumbo
Copy link
Owner

@stumbo stumbo commented Nov 3, 2025

No description provided.

stumbo and others added 4 commits November 1, 2025 23:18
* Initial attempt to create individual pages for the Bibliography entries.
1. The "main" Bibliography page is not (yet) modified to reference these.
2. This fails when hugo tries to render the html for the generated .md files.

The error from Hugo (it reports 4 then seems to hang):
ERROR render of "/home/matt/Interlisp/Interlisp.github.io/content/en/history/bibliography/2LJ5ITDD.md" failed: "/home/matt/.cache/hugo_cache/modules/filecache/modules/pkg/mod/github.com/google/[email protected]/layouts/docs/single.html:2:3": execute of template failed: template: docs/single.html:2:3: executing "main" at <.Render>: error calling Render: failed to execute template content.html: "/home/matt/.cache/hugo_cache/modules/filecache/modules/pkg/mod/github.com/google/[email protected]/layouts/_default/content.html:10:4": execute of template failed: template: content.html:10:4: executing "content.html" at <.Content>: error calling Content: "/home/matt/Interlisp/Interlisp.github.io/content/en/history/bibliography/2LJ5ITDD.md:8:1": failed to render shortcode "bibItem": failed to process shortcode: "/home/matt/Interlisp/Interlisp.github.io/layouts/shortcodes/bibItem.html:168:23": execute of template failed: template: _shortcodes/bibitem.html:168:23: executing "_shortcodes/bibitem.html" at <.params.bibItem>: can't evaluate field params in type *hugolib.ShortcodeWithPage

* Improved, but still work in progress.
This now creates the files but has some difficulties.
The main Bibliography page hasn't been changed.

* Update github action to set bibSplit.pl executable

* Publications Page -- work in progress

* WIP

* WIP

* Bibliography WIP

Crude listing generated in /pulications folder.

* Initial implementation of list of all bibliography entries

Primitive first pass.  Provides a chronological list of all
bibliography entires providing titles, authors, date and an
abbreviated start of the abstract (limted to 24 words). In
addition, a link is enclosed that goes to the markdown file
that represents the bibliography entry.

Currently, there is nothing implemented to show the contents of
the md file.

There is no bibliography css implemented to format the list items.

This provides an initial proof of concept.  A simple framework that
can be extended and styled to get us where we want to go.

* Initial implementation of list of all bibliography entries

Primitive first pass.  Provides a chronological list of all
bibliography entires providing titles, authors, date and an
abbreviated start of the abstract (limted to 24 words). In
addition, a link is enclosed that goes to the markdown file
that represents the bibliography entry.

Currently, there is nothing implemented to show the contents of
the md file.

There is no bibliography css implemented to format the list items.

This provides an initial proof of concept.  A simple framework that
can be extended and styled to get us where we want to go.

* Updates to bibliography page

The bibliography md files are build using the update_bibliography.sh
script.  bib-fns.jq provides functions to reformat the Zotero JSON.
bibSplit.pl creates the md file and a data file containing the JSON
for each page.  Future work will remove the JSON data files once all the
content is encompassed in the md file.

Added new document type bibliography to generate the list of
bibliography entries.  layouts/bibliography/list.html provides this
functionality.  It also currently includes some light css to format the
output.  The css will eventually be moved into a standalone file within
the Hugo ecosystem.

Removed the original publication type and its associated files in
layouts.

Removed some HugoBlox files.  They were left over from an early attempt
to create a bibliography using HugoBlox as a template.

Updated gh-pages.yml, the GHA, to cache the md pages and JSON files.
Rewrote the caching to make it more efficient and easier to follow.

* Update bibliography entry to link to Zotero

The Read Me link now points to the Zotero entry for
each item.

* Add missing edits.

* Update Zotero link wording and open in new tab

* Fixed a few Hugo syntax errors.
Changed the de-html & re-html encoding to remove unnecessary encoding of html entities.
bibSplit.pl errors go to STDERR
update_bibliography.sh redirects those errors to bibSplit.err file.

I cannot find Hugo documentation showing why _ in truncated abstract renders as ellipsis.

* Updates to author tags

Authors are now stored as a list of strings in the YAML, one author per
line in the list.

Previously all the authors were consolidated into a single string.

* Start of building out individual bibliography pages
                                                         Create baseof.html - framework for bibliography screen          single.html - layout of individual entry                                                                   Updated list.html - with baseof, <br>s added at beginning of file are no                                          longer needed.                                                                                                    Updated bibSplit.pl specify each page as a bibliography page.

* Continued work on creating individual entries.

Build out parsing of json to get needed items
and putting the items into the generated pages.

* Finish individual bibliography entry creation

Individual bibliography entries are created for
all document types.  Customized the entries shown
based on Zotero entries.  Added url, left placeholder
for citation.

Updated list of bibliography entries to link to
individual entries.

* Taxonomy initial work.  Still WIP

* Some edge case cleanups.
A hack for bulleted list in Abstracts.
Some rearranging for consistency between the list and single views.
Other tweaks for my preferences.

* Taxonomy support for filtering bibliographical entries

Add bibliographical support for item_type (the type of
bibliographic entry) and author.

Provide support for filtering bibliographic list by both
types of tags.

* Turn off saving of the 00-rawItems.json and tags.json files.

* Added command line processing to avoid needing to edit the file while debugging changes.
Included usage information.
The previous behavior (no command line options) is unchanged.
(No modification to invocation required.)

* Remove storing of individual .json files and unused files.

Clean out some old files js & scss from earlier bibliography work.

* Cleanup versions in go.sum

* Remove cite placeholder.

---------

Co-authored-by: Matt Heffron <[email protected]>
* Fix taxonomy_terms_cloud.html to produce All Authors page

---------

Co-authored-by: Matt Heffron <[email protected]>
…roperly removed, display dates as originally set in Zotero.
@stumbo stumbo merged commit 08c343c into main Nov 3, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants