Challenge10k · Before deployment

Jekyll Scripterix Website - Expansion

03 October 2025 15 h 20 h total
Czysty kod

15 hours of iteration: portfolio redesign, archive experiments, content translations, logbook updates, and deployment documentation.

Focus area
Jekyll + i18n + design + checklist
Mood
Deep focus
Tags
jekyll i18n liquid automation archive portfolio

Longest session this month - continuing the build of the Jekyll Scripterix architecture

🧭 Portfolio portal refinement (2h)

  • Updated hero headings: “Portfolio” (EN) and “Selected Portfolio Projects” (PL)
  • Reorganized sections – project cards above case studies, accordion with logbook and timeline
  • Simplified stats (_data/stats.json) and aligned labels across languages
  • Removed duplicate styles to prep the layout for future filtering

🕹️ UX experiments in the archive (3h)

  • Implemented a horizontal timeline slider (buttons, scroll snapping, keyboard support)
  • Tested an informational modal with sessionStorage persistence
  • Decided to roll back the slider → returned to a simple grid plus CSS/JS refactor
  • Lesson learned: keep things minimal until the full UX project is ready

🌐 Content parity and translations (1h)

  • Added the English version of the post-6-start-wyzwanie entry (kept translation_id intact)
  • Reviewed every post – demoted initial headings to ##, no layout conflicts
  • Updated logbook heading styles (**...**### ...)

📓 Logbook + documentation (0.5h)

  • Wrote this logbook entry and revisited earlier sections
  • Updated _drafts/README-einstein.md (markdown formatting)
  • Organized assets inside _data and _works

🚀 QA & build pipeline (0.5h)

  • Ran bundle exec jekyll build after each iteration
  • Checked for Liquid/Markdown errors – clean reports
  • Captured notes for upcoming CI (GitHub Actions + screenshot generator)

Results

  • Portfolio ready for filter expansion with consistent copy
  • Archive cleared of temporary experiments; insights preserved
  • Complete translation pairs for recent posts plus typography cleanup
  • Logbook and documentation refreshed (Einstein guide)

Update architecture

Jekyll Site (2025-10-07)
├── _includes/portfolio-page.html   # card layout, case studies accordion
├── _posts/2024-10-12-*.md          # EN/PL posts with translation_id
├── _logbook/2025-10-07-*.md        # current Challenge10k session
├── _data/stats.json                # portfolio hero data
├── assets/js/portfolio-filter.js   # fetch + card rendering logic
└── archive/index.markdown          # timeline, search, UX experiments

Takeaways

  1. UX experiments need staging—slider/toast work best on a separate branch.
  2. Consistent translation_id speeds up EN/PL pairing and statistics.
  3. Markdown lint keeps documents tidy (headings, lists, code fences).
  4. Simple bundle exec jekyll build as a smoke test catches regressions fast.
  5. Documentation (README) must grow with the architecture or context gets lost.

Metrics

  • Build time: 0.8 s (average after refactors)
  • _site size: ~86 KB of assets after style cleanup
  • Logbook entries: 5 (PL) / 5 (EN) with current translation_id
  • Portfolio works: 5 active cards (shared EN/PL)

Next: Automate GitHub Actions (build + deploy) and add a thumbnail generator for projects.