Skip to content

Migrate peterkir.github.io to just-the-docs Jekyll theme with dark/light toggle, build footer, and archived PDFs#1

Merged
peterkir merged 2 commits intomasterfrom
copilot/update-page-with-just-the-docs-template
Apr 2, 2026
Merged

Migrate peterkir.github.io to just-the-docs Jekyll theme with dark/light toggle, build footer, and archived PDFs#1
peterkir merged 2 commits intomasterfrom
copilot/update-page-with-just-the-docs-template

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Apr 1, 2026

Static Bootstrap/HTML site converted to Jekyll with just-the-docs v0.12.0. Adds runtime light/dark mode switching, a build-stamped footer, and PDF presentations stored directly in the repo.

Jekyll setup

  • Gemfile + _config.yml with just-the-docs 0.12.0; search, sidebar nav, aux GitHub link enabled
  • Three content pages: index.md (home), talks.md (all conference talks), development.md (OSGi repos + debugging tools)
  • Old root index.html redirect removed; Jekyll generates index.html from index.md

Light/dark mode toggle

  • _includes/head_custom.html — inline script runs before paint to read localStorage / prefers-color-scheme and set data-theme on <html>, preventing FOUC
  • _includes/header_custom.html — 🌙/☀️ toggle button persists preference in localStorage
  • assets/css/dark-mode.css — CSS custom properties (--dk-*) defined on :root (light defaults), overridden under html[data-theme="dark"] and @media (prefers-color-scheme: dark) { html:not([data-theme="light"]) }, applied to all key just-the-docs selectors (sidebar, nav, code, tables, search, footer)

Build footer (SHA + timestamp)

  • .github/workflows/deploy.yml generates _data/build_info.yml at build time before jekyll build:
    echo "sha: \"$GITHUB_SHA\"" > _data/build_info.yml
    echo "datetime: \"$(date -u '+%Y-%m-%d %H:%M:%S UTC')\"" >> _data/build_info.yml
  • _includes/footer_custom.html renders the SHA as a link to the commit on GitHub

PDF storage (assets/pdfs/)

File Source
EpicSplit_EclipsePDE_Bndtools_ECE2014.pdf Already in repo
Building_Nano_Services_with_OSGi_Declarative_Services_ECE2016.pdf Downloaded from peterkir/ece2016 gh-pages branch
JumpstartIoTinJavaWithOSGienRoute_JFS2016.pdf Downloaded from peterkir/jfs2016

Link audit

  • ✅ GitHub repos (ece2014, ece2016, example.bnd.rcp), ECE2014 YouTube video, ECE2016/JFS2016 interactive slides — all reachable
  • ⚠️ ECE2017 PDF (eclipsecon.org/europe2017) — domain gone; PDF not archived, noted with callout in talks.md
  • ⚠️ ECE2008 slides (eclipsecon.org/summiteurope2008) — 2008 conference site offline, noted with callout

Copilot AI and others added 2 commits March 31, 2026 15:13
…ter, talks/dev pages, and deploy workflow

Agent-Logs-Url: https://github.com/peterkir/peterkir.github.io/sessions/fa0a9455-d0b8-403d-8807-0bf5228dd1d3

Co-authored-by: peterkir <250545+peterkir@users.noreply.github.com>
@peterkir peterkir marked this pull request as ready for review April 2, 2026 04:39
@peterkir peterkir merged commit 18dff00 into master Apr 2, 2026
1 of 2 checks passed
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