Bs17 hugo docsy update by stumbo · Pull Request #322 · Interlisp/Interlisp.github.io

stumbo · 2026-02-22T00:10:38Z

~~Needs the readme updated. But getting close to complete.~~

README.md file updated.

Pickup minor bug fixes, security updates, etc.

Dark mode - we used custom colors and will need to rethink that prior to implementing dark mode.

Move directory structure to match docsy preferred naming.

Fix image-gallery to reflect new location.

Cleanup image-gallery shortcode to use page resources.

Fixes issue with image placement on home page and brings css in line with Docsy standards.

- Remove unused parts of cover.html, simplify where possible. - Remove unused shortcodes.

Moved favicons to a standard location, regenerated them all from the logoWindows.svg file. Revised favicon.html to serve up the appropriate icon. .svg and .ico are preferred formats.

pamoroso · 2026-02-22T11:34:04Z

The new site works well in Firefox and Chrome on Linux and Android but I've notice a few issues.

With the dark theme the color of text in code blocks is nearly invisible because of the low contrast with the background. See for example here.

Also, when the window width on the desktop is short and I click > a few times to view the rest of items of the top menu, clicking < does nothing.

Finally, the Medley logo is missing from the annual report pages.

masinter

perused the sources but didn't test.
but LGTM.

hjellinek · 2026-02-22T22:22:51Z

I see dangling text/an open paren at the head of https://github.com/Interlisp/Interlisp.github.io/blob/main/content/en/history/bibliography/_index.md, which is not yet a file included in this PR.

(This bibliography is kept in sync with our [Zotero](https://www.zotero.org/) collection [Library](https://www.zotero.org/groups/2914042/interlisp/library).

I've never liked having two Zotero links in the sentence. Please change it to

We generate this from our [Zotero collection library](https://www.zotero.org/groups/2914042/interlisp/library).

Thanks.

hjellinek · 2026-02-22T22:29:55Z

Another "while you're in there":

I thought we'd agreed to eliminate the Feedback item on our pages, since no one looks at the Google Analytics data it feeds (if I remember correctly) and it's visually intrusive.

I propose eliminating it, or, if people still want it for some reason, making it much smaller.

See for instance the In Memoriam page, where it's more prominent than the prominent people:

Move logo from html <img/> to Hugo figure shortcode. This fixes the issues with the base url.

pamoroso · 2026-02-23T08:57:49Z

After commit 052122d the Medley logo in the annual reports is not fixed on the staging site.

pamoroso · 2026-02-23T12:17:15Z

At commit 5e15bd0 the Medley logo does show up on the 2025 annual report but the page also downloads the file U_65Ft2C.html: U_65Ft2C.html

The 2024 report shows a left brace { at the left of the Medley logo:

Removed the feedback buttons and the footer stating when the page was last updated and the associated commit.

stumbo · 2026-02-23T12:53:25Z

Another "while you're in there":

I thought we'd agreed to eliminate the Feedback item on our pages, since no one looks at the Google Analytics data it feeds (if I remember correctly) and it's visually intrusive.

I propose eliminating it, or, if people still want it for some reason, making it much smaller.

I'm fine with eliminating it. I don't think we have ever gotten feedback from it. I've made the appropriate updates to the params.yaml file.

I also disabled the git commit information that was appearing at the bottom of the page. It might be useful for a developer, but serves no useful purpose to users of the site.

stumbo · 2026-02-23T12:54:40Z

At commit 5e15bd0 the Medley logo does show up on the 2025 annual report but the page also downloads the file U_65Ft2C.html: U_65Ft2C.html

The 2024 report shows a left brace { at the left of the Medley logo:

Thanks for the eagle eyes. I missed the extra left brace when editing. I think it should all be correct.

stumbo · 2026-02-23T13:01:28Z

With the dark theme the color of text in code blocks is nearly invisible because of the low contrast with the background. See for example here.With the dark theme the color of text in code blocks is nearly invisible because of the low contrast with the background. See for example here.

This is a problem because the font color is custom. It matches our navbar color and the primary color on the home page. I can break that logic when dark mode is enabled and use a different font color. It's not at the top of my to-do list right now. If we feel this is a major flaw, we can disable dark mode and resolve this later.

masinter

disable dark mode and resolve this later.

i'd rather have no dark mode than illegible dark mode

pamoroso

The issues are now fixed except as noted.

hjellinek · 2026-02-23T22:38:03Z

I based a new branch on this one with the change I proposed above. It's #323. I'd appreciate it if you @stumbo merged it into this PR.

* Update in-memoriam.md Corrected grammar. Signed-off-by: Herb Jellinek <jellinek@newscenter.com> * Fix broken links to obituaries (#321) Replace the broken links to the obituaries of Warren Teitelman and Daniel Bobrow with the corresponding links to the Wayback Machine captures. Signed-off-by: Paolo Amoroso <info@paoloamoroso.com> * This is the change I requested [here](#322 (comment)). --------- Signed-off-by: Herb Jellinek <jellinek@newscenter.com> Signed-off-by: Paolo Amoroso <info@paoloamoroso.com> Co-authored-by: Paolo Amoroso <info@paoloamoroso.com>

stumbo · 2026-02-24T04:29:34Z

Also, when the window width on the desktop is short and I click > a few times to view the rest of items of the top menu, clicking < does nothing.

This appears to be a problem in Docsy. I can recreate on their website. I will open an issue with them.

I don't feel this is a showstopper. There still is a horizontal scrollbar that can be used and, quite frankly, this seems like a tails case. Something that should be fixed but isn't going to diminish the overall experience for the majority of our users..

I'm going to move the PR out of draft and will hold off on merging it until there is concurrence with my opinion.

stumbo · 2026-02-24T04:33:32Z

I based a new branch on this one with the change I proposed above. It's #323. I'd appreciate it if you @stumbo merged it into this PR.

Done

pamoroso · 2026-02-24T10:08:54Z

@stumbo Right, the scroll behavior of < is an edge case and there is a workaround, so we can proceed without a fix.

We need to update the primary font color for dark mode before enabling it. The current default color does not provide enough contrast with the dark background.

Reorganized and updated.

With the updated bibliography we no longer need to cache the bibliography.json or the individual json files used to create the final bibliography entries. They have been removed and the README updated to accurately reflect this portion of the build process.

This fixes a regression in earlier changes within this PR.

stumbo added 20 commits February 14, 2026 23:17

Update Hugo and Docsy to latest versions

bb09627

Pickup minor bug fixes, security updates, etc.

Update config to disable dark mode.

ccb195d

Dark mode - we used custom colors and will need to rethink that prior to implementing dark mode.

Upgrade to docsy 12.0.

fb2f168

Move directory structure to match docsy preferred naming.

Update UI feedback yaml to correspond to Hugo updates in 0.152.

fbe08c5

Update to Hugo 0.155.3 -- docsy 0.13 requires 0.152.2 or greater

26fc726

Push docsy to 0.14.2

5a49766

Start process of removing custom navbar.

026d823

Cleanup home page, moving to markdown, fixing issues with darkmode

17f3cc6

Enable dark mode for testing, cleanup of index.md

3ad4716

Fix darkmode enabled for experimenting

682c5c5

Move files from static to assets to align with Docsy conventions.

698f660

Fix image-gallery to reflect new location.

Move timeline photos from assets to timeline and treat as page assets.

eee422a

Cleanup image-gallery shortcode to use page resources.

Fix navbar colors, move navbar icon to assets. Fix button colors.

47a752f

Move custom.css information into _sytles_project.scss

63741df

Fixes issue with image placement on home page and brings css in line with Docsy standards.

Remove unused shortcodes, update cover.html shortcode

e3a854f

- Remove unused parts of cover.html, simplify where possible. - Remove unused shortcodes.

Remove references to custom.css. File is no longer used.

9be69b7

Update the partial, favicon.html, and the associated favicon files.

7b13424

Moved favicons to a standard location, regenerated them all from the logoWindows.svg file. Revised favicon.html to serve up the appropriate icon. .svg and .ico are preferred formats.

First attempt using css to provide two line search functionality.

8aa9813

Remove unused files

19ab6e9

Bold Title and Subtitle on home page. Current behavior of site.

89b48b1

stumbo requested review from MattHeffron, hjellinek, masinter and pamoroso February 22, 2026 00:10

stumbo self-assigned this Feb 22, 2026

masinter approved these changes Feb 22, 2026

View reviewed changes

Fix logo in annual reports.

052122d

Move logo from html <img/> to Hugo figure shortcode. This fixes the issues with the base url.

Revised logo code to correct for site BaseURL

5e15bd0

stumbo added 2 commits February 23, 2026 07:28

Fix minor type, extra left brace in shortcode call.

32fd6d1

Update params to remove feedback page and Git commit information

d275681

Removed the feedback buttons and the footer stating when the page was last updated and the associated commit.

stumbo force-pushed the bs17_hugo_docsy_update branch from 5abde22 to d275681 Compare February 23, 2026 12:47

masinter reviewed Feb 23, 2026

View reviewed changes

pamoroso approved these changes Feb 23, 2026

View reviewed changes

hjellinek added a commit that referenced this pull request Feb 23, 2026

This is the change I requested [here](#322 (comment)).

3d5af5b

stumbo marked this pull request as ready for review February 24, 2026 04:29

stumbo added 3 commits February 24, 2026 06:13

Turn off dark mode.

4cd003c

We need to update the primary font color for dark mode before enabling it. The current default color does not provide enough contrast with the dark background.

Updated README.md file

fb0def6

Reorganized and updated.

stumbo force-pushed the bs17_hugo_docsy_update branch from 8282656 to ab942c8 Compare February 25, 2026 13:15

Fix scss to show title on non-home pages.

5359dac

This fixes a regression in earlier changes within this PR.

Uh oh!

Comments

Conversation

stumbo commented Feb 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

pamoroso commented Feb 22, 2026

Uh oh!

masinter left a comment

Choose a reason for hiding this comment

Uh oh!

hjellinek commented Feb 22, 2026

Uh oh!

hjellinek commented Feb 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

pamoroso commented Feb 23, 2026

Uh oh!

pamoroso commented Feb 23, 2026

Uh oh!

stumbo commented Feb 23, 2026

Uh oh!

stumbo commented Feb 23, 2026

Uh oh!

stumbo commented Feb 23, 2026

Uh oh!

masinter left a comment

Choose a reason for hiding this comment

Uh oh!

pamoroso left a comment

Choose a reason for hiding this comment

Uh oh!

hjellinek commented Feb 23, 2026

Uh oh!

stumbo commented Feb 24, 2026

Uh oh!

stumbo commented Feb 24, 2026

Uh oh!

pamoroso commented Feb 24, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

stumbo commented Feb 22, 2026 •

edited

Loading

hjellinek commented Feb 22, 2026 •

edited

Loading