kasohrab's Personal Website

Personal website and blog built with Hugo and deployed to GitHub Pages

🌐 Live Site: https://kasohrab.github.io

About

This is my personal website and blog where I share my thoughts, experiences, and projects as a software engineer. The site features:

• About Page: Learn more about me and my background
• Blog: Technical posts and personal thoughts
• CV/Resume: My professional experience and skills
• Projects: Showcase of my work and contributions

Tech Stack

• Static Site Generator: Hugo v0.149.0
• Theme: hugo-theme-reimu by D-Sketon
• Hosting: GitHub Pages
• Deployment: GitHub Actions (automated)
• Domain: Custom domain support ready

Features

• ✨ Responsive design with dark/light mode
• 📱 Mobile-optimized layout
• 🔍 Search functionality
• 📊 Analytics ready
• 🚀 Fast loading and SEO optimized
• 📝 Markdown-based content management
• 🔗 Social media integration

Quick Start

Prerequisites

• Hugo v0.149.0+ (extended version)
• Go v1.21+
• Git

Development

# Clone the repository
git clone https://github.com/kasohrab/kasohrab.git
cd kasohrab

# Install dependencies
make install

# Start development server
make dev

Visit http://localhost:1313 to see the site.

Available Commands

make help          # Show all available commands
make dev           # Start development server
make build         # Build for production
make clean         # Clean build artifacts
make new-post TITLE="My Post"  # Create new blog post
make deploy-check  # Verify build works

Content Management

Creating Blog Posts

# Using make command (recommended)
make new-post TITLE="My Amazing Post"

# Using Hugo directly
hugo new post/my-amazing-post.md

Content Structure

content/
├── _index.md          # Homepage
├── about.md           # About page
├── cv.md             # Resume/CV
├── archives/          # Blog archives
└── post/             # Blog posts
    ├── _index.md     # Blog index
    └── *.md          # Individual posts

Customization

Site Configuration

• Edit hugo.toml for basic site settings
• Modify config/_default/params.yml for theme configuration
• Update data/social.yml for social media links

Theme Customization

• Override layouts in layouts/ directory
• Add custom CSS/JS in assets/ directory
• Customize colors and fonts in theme configuration

Deployment

The site is automatically deployed to GitHub Pages via GitHub Actions when changes are pushed to the main branch.

Manual Deployment

# Build the site
make build

# The built site will be in the public/ directory

Custom Domain Setup

1. Add a CNAME file to the static/ directory
2. Configure DNS settings with your domain provider
3. Update baseURL in hugo.toml

Project Structure

kasohrab/
├── .github/
│   └── workflows/
│       └── hugo.yml      # GitHub Actions deployment
├── archetypes/           # Content templates
├── assets/              # CSS, JS, images
├── config/
│   └── _default/
│       └── params.yml   # Theme configuration
├── content/             # Site content (Markdown)
├── data/
│   └── social.yml       # Social media links
├── layouts/             # Custom templates
├── static/              # Static assets
├── hugo.toml           # Hugo configuration
├── package.json        # NPM scripts
├── Makefile           # Development commands
├── SETUP.md           # Setup documentation
├── DEVELOPMENT.md     # Development guide
└── README.md          # This file

Contributing

This is my personal website, but if you notice any issues or have suggestions:

1. Open an issue
2. Submit a pull request
3. Reach out via email

License

This project is open source and available under the MIT License.

The content (blog posts, personal information) is copyrighted and may not be reused without permission.

Contact

• GitHub: @kasohrab
• LinkedIn: kasohrab
• Email: kasohrab@example.com
• Website: kasohrab.github.io

---

⭐ If you found this project helpful, consider giving it a star!

Built with ❤️ using Hugo and deployed with GitHub Actions