Skip to content

Conversation

@bartdegoede
Copy link
Owner

Summary

Complete migration from hyde-x to PaperMod theme with modernized features and improved user experience.

Changes

Theme & Configuration

  • ✅ Migrated to PaperMod theme (most popular Hugo theme in 2025)
  • ✅ Converted config from TOML to YAML with modern Hugo syntax
  • ✅ Updated for Hugo v0.147+ compatibility
  • ✅ Preserved all existing URLs (SEO maintained)

New Features

  • Homepage search - Live filtering with Fuse.js 7.1.0
  • Dark/light mode - Automatic theme switching
  • Modern image styling - Shadows, hover effects, rounded corners
  • Improved typography - Better readability and spacing
  • Share buttons - Social sharing on all posts
  • Code copy buttons - One-click code copying

Custom Features Preserved

  • Audio player - Text-to-speech integration maintained
  • Interactive bloom filter - Rewritten in vanilla JS (removed jQuery)
  • OpenSearch - Browser search bar integration
  • All static content - PDFs, audio files, images

Technical Improvements

  • Modernized JavaScript - Removed jQuery dependency
  • Better asset pipeline - Hugo Pipes with minification & fingerprinting
  • Improved deploy script - Error handling and validation
  • SEO optimized - Proper meta tags and structured data
  • Google Analytics - GA4 properly configured

Testing

  • ✅ All blog posts render correctly
  • ✅ URLs preserved (no broken links)
  • ✅ Search functionality works
  • ✅ Audio players work
  • ✅ Interactive examples work (bloom filter)
  • ✅ Images display correctly
  • ✅ Mobile responsive
  • ✅ Dark/light mode works

Deployment

Site is already live at https://bart.degoe.de with the new theme.


🤖 Migrated with Claude Code

- Add PaperMod theme as submodule
- Convert config.toml to config.yml with modern Hugo syntax
- Update pagination config for Hugo v0.128+
- Configure Google Analytics (GA4)
- Set up basic menu structure
- Preserve permalink structure for URL compatibility
- Modern image and figure styling with shadows and hover effects
- Theme-aware colors for light/dark mode
- Audio player styling integrated with PaperMod
- Bloom filter interactive example styling
- Responsive design adjustments
- extend_head.html: Add OpenSearch integration and custom JS support
- extend_footer.html: Add homepage search functionality with Fuse.js
- footer.html: Custom footer without theme attribution
- Add homepage search bar with live filtering
- Remove old hyde-x template overrides
- Simplified navigation (About only)
- Rewrite from jQuery to vanilla JavaScript
- Use modern ES6+ syntax (const, let, arrow functions, template literals)
- Remove jQuery dependency
- Improve performance and reduce bundle size
- Add Bart Simpson favicon in multiple sizes
- Add apple-touch-icon for iOS devices
- Add OpenSearch descriptor for browser search integration
- Add error handling with set -e
- Add submodule initialization check
- Add build verification
- Add change detection (skip if no changes)
- Improve output with colored messages
- Add success confirmation with site URL
- Add CLAUDE.md with codebase documentation
- Add Hugo build lock file
@bartdegoede bartdegoede merged commit 9b42c6c into master Oct 26, 2025
@bartdegoede bartdegoede deleted the migration-papermod branch October 26, 2025 19:16
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