# Petyo Kostakov - Professional Portfolio

A professional Jekyll-based portfolio website showcasing CV, learning and blog posts.

## 🚀 Quick Start

```bash
cd /Users/kostapet/git/PetyoKostakov.github.io
bundle install
bundle exec jekyll serve
```

Visit: **http://localhost:4000**

---

## 📖 Documentation

All documentation files are in the `docs/` folder:

- **[QUICKSTART.md](docs/QUICKSTART.md)** - Get running in 5 minutes
- **[SETUP_GUIDE.md](docs/SETUP_GUIDE.md)** - Detailed setup instructions
- **[TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md)** - Problem solving
- **[COMMANDS.md](docs/COMMANDS.md)** - Command reference
- **[MASTER_INDEX.md](docs/MASTER_INDEX.md)** - Complete navigation guide
- **[PROJECT_SUMMARY.md](docs/PROJECT_SUMMARY.md)** - Project overview

---

## 📁 Project Structure

```
.
├── docs/                 # Documentation files
├── scripts/              # Utility scripts
├── index.md              # Homepage
├── cv.md                 # CV page
├── blog.md               # Blog listing
├── learning.md           # Learning listing
├── about.md              # About page
├── 404.md                # Error page
├── _posts/               # Blog posts
├── _learning/            # Learning entries
├── _layouts/             # Templates
├── _includes/            # Components
├── assets/               # CSS and styles
├── _config.yml           # Site configuration
├── Gemfile               # Dependencies
└── .gitignore            # Git rules
```

---

## 📊 Features

✅ Professional design  
✅ Responsive layout  
✅ Blog system with categories/tags  
✅ Learning log (courses, workshops, training, conferences)  
✅ CV showcase  
✅ SEO optimized  
✅ Social media integration  
✅ Free GitHub Pages hosting  

---

## 🎯 Site Pages

- **index.md** - Homepage with featured content
- **cv.md** - Professional CV/Resume
- **blog.md** - Blog post listing
- **learning.md** - Courses, workshops, training and conferences attended
- **about.md** - Personal bio and expertise
- **404.md** - Custom error page

---

## 📚 Creating Content

### Blog Post
```bash
# Create file: _posts/YYYY-MM-DD-title.md
# Example: _posts/2024-09-15-my-first-post.md
```

### Learning Entry
```bash
# Create file: _learning/descriptive-name.md
# Example: _learning/2026-kubecon-eu.md
```

See [SETUP_GUIDE.md](docs/SETUP_GUIDE.md) for detailed examples.

---

## 🚀 Deployment

```bash
git add .
git commit -m "Update portfolio"
git push origin main
```

Enable GitHub Pages in repository settings.

Your site: **https://petyokostakov.github.io**

---

## 🔧 Utilities

Scripts in `scripts/` folder:

- **verify_setup.sh** - Verify your setup is correct

Run:
```bash
bash scripts/verify_setup.sh
```

---

## 📞 Support

See the `docs/` folder for complete documentation:

- Getting started? → [QUICKSTART.md](docs/QUICKSTART.md)
- Need help? → [TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md)
- Lost? → [MASTER_INDEX.md](docs/MASTER_INDEX.md)

---

## ✨ Tech Stack

- **Jekyll:** 4.3.3
- **Theme:** Minima
- **Ruby:** 3.4.0+
- **Plugins:** feed, seo-tag, sitemap

---

**Your professional portfolio is ready!** 🌟

Start with: `bundle install && bundle exec jekyll serve`