Skip to content

Tier-0 V2.0 quick fixes: sitemap, robots.txt, LaTeX + nav#105

Merged
jonfroehlich merged 1 commit into
mainfrom
chore/tier0-quick-fixes
Jun 22, 2026
Merged

Tier-0 V2.0 quick fixes: sitemap, robots.txt, LaTeX + nav#105
jonfroehlich merged 1 commit into
mainfrom
chore/tier0-quick-fixes

Conversation

@jonfroehlich

Copy link
Copy Markdown
Member

Summary

Punch-list item B — the fast, mechanical, no-regret Tier-0 fixes toward V2.0. Independent of the Actions-deploy PR (#104).

Changes

  • jekyll-sitemap + robots.txt (helps Fix page indexing problems #72 indexing). Enabled the plugin in _config.yml (it ships with the github-pages gem and is whitelisted, so it works under both the legacy and Actions builds). Added a root robots.txt pointing at the generated sitemap.
  • LaTeX fix in advancedio/smoothing-input.md: a nested $>$ inside a $$…$$ block broke MathJax parsing. Replaced with a literal > to match the \text{if i = 1} case just above it.
  • Nav migration in esp32/esp32-ide.md: converted the old .btn "Back to" button to the standard card-style <nav class="lesson-nav">, matching every other esp32 lesson.

Verification

  • ✅ Clean bundle exec jekyll build (~20s).
  • _site/sitemap.xml generated with correct absolute URLs, e.g. https://makeabilitylab.github.io/physcomp/advancedio/accel.html (baseurl preserved).
  • _site/robots.txt published with the sitemap line.
  • esp32-ide.html now renders lesson-nav/nav-prev (no btn-outline).

Notes

  • robots.txt on a project page is served at /physcomp/robots.txt; crawlers only honor the authoritative one at the org root (makeabilitylab.github.io/robots.txt). The real indexing win here is the sitemap.xml, which is directly submittable to Google Search Console.
  • The nav migration script (scripts/update_lesson_nav.py) doesn't recognize this single "Back to" button form (and has a Windows-only cp1252 crash in its summary print). It did flag two other still-stale pages — communication/p5js-serial-io.md and cpx/capacitive-touch.md — out of scope here but worth a follow-up.

🤖 Generated with Claude Code

- Enable jekyll-sitemap (bundled with github-pages) so /sitemap.xml is
  generated for search indexing; add robots.txt pointing to it (#72).
- Fix malformed LaTeX in advancedio/smoothing-input.md: a nested `$>$`
  inside a $$...$$ block broke MathJax; use a literal `>` to match the
  `if i = 1` case above it.
- Migrate esp32/esp32-ide.md from the old .btn "Back to" button to the
  standard card-style <nav class="lesson-nav">, matching the other esp32
  lessons (the nav script doesn't recognize the single back-button form).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@jonfroehlich
jonfroehlich merged commit 818d4b9 into main Jun 22, 2026
@jonfroehlich
jonfroehlich deleted the chore/tier0-quick-fixes branch June 22, 2026 23:15
@jonfroehlich jonfroehlich mentioned this pull request Jun 24, 2026
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.

1 participant