Modernize Jekyll site: update dependencies, add SEO, and comprehensive documentation

[Copilot]

Updates outdated Jekyll dependencies and configuration, adds missing documentation, and improves SEO. The site was using github-pages ~> 231 from 2023, lacked webrick for Ruby 3.0+, and had an empty README.

Dependencies

• github-pages: ~> 231 → ~> 232
• Added webrick ~> 1.8 (required for Ruby 3.0+)
• minima: ~> 2.5.1 → ~> 2.5
• Added jekyll-seo-tag plugin
• tzinfo: ~> 1.2 → >= 1, < 3

Configuration (_config.yml)

# Added timezone and SEO metadata
timezone: Europe/Madrid

author:
  name: Andrés Pérez Gil
  email: helloandres@outlook.com

social:
  name: Andrés Pérez Gil
  links:
    - https://twitter.com/AndresPerezGil
    - https://github.com/khnumdev
    - https://www.linkedin.com/in/andresperezgil

plugins:
  - jekyll-feed
  - jekyll-paginate
  - jekyll-seo-tag

Documentation (README.md)

Created comprehensive README (239 lines) covering:

• Local development setup (bundle install, bundle exec jekyll serve)
• Post creation guide with file naming convention and front matter template
• Project structure explanation
• Configuration and deployment details

Project Files

• .ruby-version: Added Ruby 3.1.0 specification
• .gitignore: Enhanced with modern Jekyll patterns (.bundle/, vendor/, .DS_Store)

Gemfile.lock updated with resolved dependencies. All existing posts build successfully with SEO tags properly rendered.

Original prompt

Problem Statement

This Jekyll-based GitHub Pages site was created years ago and needs updates to align with current best practices and modern Jekyll configuration.

Current Issues Identified

1. Outdated Dependencies

• github-pages gem: Currently ~> 231 (from ~2023), should be updated to ~> 232 (latest)
• Bundler version: Currently 2.2.26 (from 2021), should be updated to latest 2.5.x
• Missing webrick: Ruby 3.0+ requires webrick gem explicitly added
• Jekyll version: 3.9.5 (locked by github-pages, which is correct)

2. Empty README

The README.md file is essentially empty (only 1 byte). It needs comprehensive documentation including:

• Project description and purpose
• How to create a new blog post
• Local development setup instructions
• Project structure explanation
• Deployment information
• Configuration details

3. Configuration Improvements Needed

The _config.yml needs modern best practices:

• Add SEO optimization settings
• Add timezone configuration
• Improve plugin configuration
• Add helpful comments for future maintainers

4. Missing Project Files

• No .ruby-version file for Ruby version consistency
• .gitignore could be improved with modern Jekyll patterns

Required Changes

Update Gemfile

source "https://rubygems.org"

# Use GitHub Pages gem for compatibility
gem "github-pages", "~> 232", group: :jekyll_plugins

# Theme
gem "minima", "~> 2.5"

# Plugins
group :jekyll_plugins do
  gem "jekyll-feed", "~> 0.12"
  gem "jekyll-seo-tag"
end

# Required for Ruby 3.0+
gem "webrick", "~> 1.8"

# Windows and JRuby compatibility
platforms :mingw, :x64_mingw, :mswin, :jruby do
  gem "tzinfo", ">= 1", "< 3"
  gem "tzinfo-data"
end

# Performance-booster for watching directories on Windows
gem "wdm", "~> 0.1.1", :platforms => [:mingw, :x64_mingw, :mswin]

Update _config.yml

Add the following improvements:

# Add timezone (infer from existing content or use UTC)
timezone: Europe/Madrid  # or appropriate timezone

# Improve SEO settings
author:
  name: Andrés Pérez Gil
  email: helloandres@outlook.com

# Add social links for SEO
social:
  name: Andrés Pérez Gil
  links:
    - https://twitter.com/AndresPerezGil
    - https://github.com/khnumdev
    - https://www.linkedin.com/in/andresperezgil

# Improve plugin list
plugins:
  - jekyll-feed
  - jekyll-paginate
  - jekyll-seo-tag

# Pagination settings (already present)
paginate: 5
paginate_path: "/page:num/"

# Build settings
markdown: kramdown
highlighter: rouge

Create Comprehensive README.md

Create a detailed README with these sections:

1. Header - Project title and description
2. About - Brief description of the blog
3. Tech Stack - Jekyll, GitHub Pages, Minima theme
4. Prerequisites - Ruby, Bundler requirements
5. Local Development Setup
   • Clone repository
   • Install dependencies: bundle install
   • Run local server: bundle exec jekyll serve
   • Access at http://localhost:4000
6. Creating a New Post
   • File naming convention: YYYY-MM-DD-title.markdown
   • Required front matter structure
   • Example post template
   • Location: _posts/ directory
7. Project Structure
   • Explain key directories and files
   • _config.yml, _posts/, Gemfile, etc.
8. Configuration
   • How to modify site settings
   • Available configuration options
9. Deployment
   • Explain GitHub Pages automatic deployment
   • Main branch deployment process
10. Theme Customization
    • Link to Minima theme documentation
    • How to override theme defaults
11. License - Reference to LICENSE file

Add .ruby-version file

3.1.0

(or appropriate Ruby version for GitHub Pages compatibility)

Update .gitignore

Enhance with modern Jekyll patterns:

_site/
.sass-cache/
.jekyll-cache/
.jekyll-metadata
.bundle/
vendor/
*.gem
.DS_Store
Gemfile.lock

Acceptance Criteria

• Gemfile updated with latest github-pages gem (~> 232)
• webrick gem added for Ruby 3.0+ compatibility
• _config.yml enhanced with timezone, SEO, and better plugin configuration
• README.md created with comprehensive documentation covering all sections listed above
• .ruby-version file added
• .gitignore improved with modern Jekyll patterns
• All changes maintain backward compatibility with existing posts
• Site builds successfully locally with bundle exec jekyll serve
• No breaking changes to existing functionality

Testing Steps

1. Run bundle install to verify Gemfile changes work
2. Run bundle exec jekyll serve to verify site builds locally
3. Visit http://localhost:4000 to verify site renders correctly
4. Verify all existing posts are accessible
5. Create a test post following README instructions to verify documentation accuracy
6. Verify no console errors or warnings during build

Additional Notes

• Maintain the current Minima theme version (2.5.1) for consistency
• Keep existing posts and co...

This pull request was created from Copilot chat.

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.