Skip to content

chore: modernize site and fix issues - #482

Merged
henryiii merged 1 commit into
mainfrom
chore/modernize
Oct 24, 2026
Merged

henryiii merged 1 commit into
mainfrom
chore/modernize

Conversation

@henryiii

Copy link
Copy Markdown
Member

🤖 AI text below 🤖

Cleanup and fixes found while checking the site.

Fixes

  • _includes/head.html was an old copy of the theme file. It printed a second <title> on every page and did not load the 0.12 nav styles (head-nav stylesheet and nav activation). It is now based on the just-the-docs 0.12 file and keeps the light/dark scheme switch. The JS fallback for browsers without prefers-color-scheme is removed.
  • Web manifest icon paths pointed to / instead of /assets/, and the name was empty.
  • FAQ "Getting in touch" link was broken.
  • http:// links changed to https://; CHEP 2019 now points to Indico, because its site is http only.
  • PR workflow used steps.pages.outputs.base_path without a pages step.

Cleanup

  • Removed the default "Welcome to Jekyll" post and jekyll-feed (the feed would be empty).
  • Removed obsolete browserconfig.xml, mstile-150x150.png, safari-pinned-tab.svg, a duplicate assets/favicon.ico, the unused Google Analytics block, and the X-UA-Compatible tag.
  • README.md, Rakefile and LICENSE are no longer copied into _site.
  • Removed boilerplate in Gemfile and _config.yml.

Updates

  • New rake check task (internal links only), now run in PR CI. rake test still checks external links.
  • Ruby 3.4 in CI and Read the Docs (matches the lockfile); Read the Docs on ubuntu-24.04.
  • README build steps updated.

I checked the local build with jekyll serve: every linked asset and page returns 200. I did not do a visual check in a browser.

- Rebase head.html on just-the-docs 0.12 (fixes duplicate <title>, adds
  nav activation styles)
- Fix web manifest icon paths, FAQ link, and http links
- Remove default Jekyll post, jekyll-feed, and obsolete icon files
- Add `rake check` for internal links and run it in PR CI
- Bump Ruby to 3.4 in CI and Read the Docs
- Update README

Assisted-by: ClaudeCode:claude-opus-5-5

@eduardo-rodrigues eduardo-rodrigues left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Better and simpler is always better :-). You're the expert here, I 100% trust you.

It all looks good from a little browse of the site preview.

@henryiii
henryiii merged commit 7dcb6ed into main Oct 24, 2026
3 checks passed
@henryiii
henryiii deleted the chore/modernize branch October 24, 2026 13:45
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.

2 participants