A complete modern redesign of the DarkGenesis blog built on Jekyll 4.3, featuring modern web standards, accessibility, and SEO optimization while preserving all existing URLs.
✨ Modern Design
- Responsive, mobile-first CSS with Grid/Flexbox
- CSS custom properties for consistent theming
- Clean, minimal aesthetic
🌓 Dark Mode
- Automatic system preference detection
- Manual toggle support
- Smooth transitions
🔍 Enhanced Search
- Client-side search with intelligent ranking
- Real-time results as you type
- Weighted scoring (title > description > content)
♿ Accessibility
- WCAG 2.1 AA compliant
- Semantic HTML5 markup
- Skip links for keyboard navigation
- Proper ARIA labels and roles
- Respects
prefers-reduced-motion
🎯 SEO Optimized
- OpenGraph meta tags
- Twitter Cards
- JSON-LD structured data
- Canonical URLs
- Preserved legacy permalink structure
⚡ Performance
- Optimized CSS (compressed in production)
- Minimal JavaScript (vanilla, no frameworks)
- Lazy loading support ready
- Fast page loads
🤖 Automation
- GitHub Actions deployment
- Automated link checking
- Extensible workflow system
- Ruby 3.1+
- Bundler
- Git
- Install Ruby with DevKit (recommended)
- Option A (Windows Package Manager):
winget install RubyInstallerTeam.RubyWithDevKit - Option B: RubyInstaller from https://rubyinstaller.org (choose a “with DevKit” build)
-
Close and reopen PowerShell so
ruby/gemare on PATH. -
Install Bundler:
gem install bundlerIf you already have Ruby installed but bundle isn’t found, Bundler is usually missing from your Ruby gems.
# Clone the repository
git clone https://github.com/SimonDarksideJ/SimonDarksideJ.github.io.git
cd SimonDarksideJ.github.io
git checkout copilot/dark-genesis-next
# Install dependencies
bundle install
# Start the development server
bundle exec jekyll serve --livereload
# Open your browser
http://localhost:4000├── _includes/ # Reusable components
│ ├── header.html
│ ├── footer.html
│ ├── post-card.html
│ └── search-bar.html
├── _layouts/ # Page templates
│ ├── default.html
│ ├── home.html
│ └── post.html
├── _sass/ # SCSS stylesheets
│ ├── _variables.scss
│ ├── _base.scss
│ ├── _layout.scss
│ ├── _post-card.scss
│ └── _search.scss
├── assets/
│ ├── css/
│ │ └── main.scss
│ └── js/
│ ├── theme-toggle.js
│ ├── mobile-menu.js
│ └── search.js
├── .github/workflows/ # GitHub Actions
│ ├── deploy.yml
│ └── link-checker.yml
├── _posts/ # Blog posts
├── _config.yml # Jekyll configuration
└── docs/ # Documentation
Create a new post in _posts/ with the format: YYYY-MM-DD-title.md
---
layout: post
title: "Your Post Title"
date: 2024-12-15 12:00:00 +0000
description: "A brief description for SEO"
img: posts/2024/featured-image.jpg
preview_gif: posts/2024/preview.gif # Optional animated preview
category: Technology
tags:
- jekyll
- web-development
author: Simon Jackson
---
Your content here...Google Analytics is configured in _config.yml:
google_analytics: G-S2P4W0VHVBThe site preserves existing URLs using:
permalink: ':title:output_ext'This maintains backward compatibility with all existing posts (e.g., /post-title.html).
The site automatically deploys to GitHub Pages when you push to the copilot/dark-genesis-next branch.
Workflow: .github/workflows/deploy.yml
The site uses the custom domain: darkgenesis.zenithmoon.com
Configured in: CNAME file
Additional documentation is available in the docs/ directory:
- docs/README.md - Documentation overview
- Future: Newsletter setup guide
- Future: Social media integration guide
- Future: Advanced configuration
- Jekyll 4.3 - Static site generator
- SCSS - CSS preprocessor
- Vanilla JavaScript - No frameworks
- GitHub Actions - CI/CD
- GitHub Pages - Hosting
- Chrome/Edge (last 2 versions)
- Firefox (last 2 versions)
- Safari (last 2 versions)
- Modern mobile browsers
© 2024 Simon Jackson. All rights reserved.
- Email: darkside@zenithmoon.com
- GitHub Issues: Report a bug
- Twitter: @simondarksidej