Professional Portfolio Configuration Guide

This repository contains the configuration snippets and examples for transforming a Jekyll blog with Minimal Mistakes theme into a professional developer portfolio.

Quick Setup

1. Enable Analytics (Optional)

To enable Plausible analytics, update _config.yml:

analytics:
  provider: false
  plausible:
    domain: "yourdomain.com"

2. Enable Comments (Optional)

To enable Giscus comments, update _config.yml:

comments:
  provider: "giscus"
  giscus:
    repo_id: "your-repo-id"
    category_name: "General"
    category_id: "your-category-id"
    discussion_term: "pathname"
    reactions_enabled: "1"
    theme: "light"

Get your Giscus configuration at: https://giscus.app

3. Add Social Preview Images

Create these images in /assets/images/:

4. Customize Colors

Edit _includes/head/custom.html to adjust the color scheme:

.masthead {
  background: linear-gradient(135deg, #your-color1 0%, #your-color2 100%);
}

.btn--primary {
  background-color: #your-brand-color;
}

Features Included

✅ Enhanced Configuration

✅ Professional Post Templates

✅ Projects Collection

✅ Professional Pages

✅ Optional Integrations

File Structure

├── _config.yml              # Main configuration with all enhancements
├── _data/
│   └── navigation.yml       # Navigation with Projects and CV links
├── _includes/
│   ├── head/
│   │   └── custom.html      # Custom CSS and analytics
│   └── seo.html            # Open Graph and social meta tags
├── _pages/
│   ├── about.md            # Professional about page
│   ├── cv.md               # Comprehensive resume/CV
│   └── projects.md         # Projects collection index
├── _projects/
│   └── my-project.md       # Example project with gallery
└── _posts/
    └── 2024-01-15-scalable-react-applications.md  # Enhanced post example

Configuration Snippets

Analytics Integration (Plausible)

Add to _includes/head/custom.html:

Comments Integration (Giscus)

The theme handles Giscus automatically when configured in _config.yml. No additional code needed.

Social Media Cards

The custom SEO include automatically generates:

Customization Tips

  1. Brand Colors: Update the CSS variables in _includes/head/custom.html
  2. Images: Replace placeholder image paths with your actual images
  3. Content: Customize the about page, CV, and project examples
  4. Navigation: Adjust _data/navigation.yml for your needs
  5. Social Links: Update author links in _config.yml

Performance Optimizations

The configuration includes several performance enhancements:

SEO Best Practices

This configuration transforms a basic Jekyll blog into a professional portfolio suitable for senior developers, technical leads, and engineering managers.