Skip to content

Comments

Bs17 hugo docsy update#322

Draft
stumbo wants to merge 24 commits intomainfrom
bs17_hugo_docsy_update
Draft

Bs17 hugo docsy update#322
stumbo wants to merge 24 commits intomainfrom
bs17_hugo_docsy_update

Conversation

@stumbo
Copy link
Member

@stumbo stumbo commented Feb 22, 2026

Needs the readme updated. But getting close to complete.

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.
@stumbo stumbo self-assigned this Feb 22, 2026
@pamoroso
Copy link
Member

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.

Copy link
Member

@masinter masinter left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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

@hjellinek
Copy link
Contributor

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
Copy link
Contributor

hjellinek commented Feb 22, 2026

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:

screenshot_1174

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

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

@pamoroso
Copy link
Member

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:

medley-logo

Removed the feedback buttons and the footer stating when the page
was last updated and the associated commit.
@stumbo stumbo force-pushed the bs17_hugo_docsy_update branch from 5abde22 to d275681 Compare February 23, 2026 12:47
@stumbo
Copy link
Member Author

stumbo commented Feb 23, 2026

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
Copy link
Member Author

stumbo commented Feb 23, 2026

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:
medley-logo

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:
medley-logo

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

@stumbo
Copy link
Member Author

stumbo commented Feb 23, 2026

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.

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.

4 participants