AI Agents Blog

A minimalist multilingual blog built with Hugo and PaperMod theme, focusing on AI agents, automation, and intelligent systems.

🚀 Features

• Multilingual Support: English and Russian content
• Dark Theme by Default: Optimized for comfortable reading
• Search Functionality: Client-side search powered by Fuse.js
• RSS Feeds: Available for both languages
• GitHub Pages Deployment: Automated with GitHub Actions
• Custom Domain Ready: Configure your own domain easily
• Mobile Responsive: Looks great on all devices

📋 Setup Instructions

1. Clone the Repository

git clone https://github.com/yourname/ai-agents-blog.git  # TODO: Update with your repo URL
cd ai-agents-blog

2. Initialize Theme Submodule

git submodule update --init --recursive

3. Install Hugo

Visit Hugo's installation guide for your platform.

4. Configure Your Blog

Edit config.yml and replace the following TODO placeholders:

• baseURL: Your GitHub Pages URL or custom domain
• author: Your name
• Social links in params.socialIcons
• GitHub repository URLs in post templates

5. Run Locally

hugo server -D

Visit http://localhost:1313 to see your blog.

📝 Content Management

Adding New Posts

English Post

hugo new content/en/posts/my-new-post.md

Russian Post

hugo new content/ru/posts/my-new-post.md

Content Structure

content/
├── en/
│   ├── _index.md
│   ├── search.md
│   └── posts/
│       ├── introduction-to-ai-agents.md
│       └── building-your-first-ai-agent.md
└── ru/
    ├── _index.md
    ├── search.md
    └── posts/
        ├── introduction-to-ai-agents.md
        └── building-your-first-ai-agent.md

🎨 Customization

Theme Colors

The blog uses PaperMod's dark theme by default. To customize colors, create assets/css/extended/custom.css and override the CSS variables.

Logo and Favicon

Place your logo and favicon files in the static/ directory and reference them in config.yml.

🚀 Deployment

GitHub Pages (Automatic)

1. Push your changes to the main branch
2. GitHub Actions will automatically build and deploy your site
3. Enable GitHub Pages in your repository settings
4. Set the source to "GitHub Actions"

Custom Domain

1. Update baseURL in config.yml
2. Update the CNAME file with your domain
3. Configure your domain's DNS to point to GitHub Pages

📊 Analytics and SEO

The blog is configured with:

• Privacy-focused analytics settings
• SEO-optimized meta tags
• Open Graph and Twitter Card support
• Sitemap and robots.txt generation

🛠 Development

Project Structure

ai-agents-blog/
├── .github/workflows/    # GitHub Actions
├── archetypes/           # Content templates
├── content/              # Blog posts and pages
│   ├── en/              # English content
│   └── ru/              # Russian content
├── static/               # Static assets
├── themes/               # Hugo themes (PaperMod)
├── config.yml           # Main configuration
├── CNAME                # Custom domain
└── README.md            # This file

Local Development

# Install dependencies (if using npm for additional tools)
npm install

# Start development server
hugo server -D --disableFastRender

# Build for production
hugo --minify

📚 Writing Guidelines

Post Front Matter Template

---
title: "Your Post Title"
date: 2024-01-15T10:00:00+00:00
draft: false
author: "Your Name"
tags: ["AI", "Agents", "Tutorial"]
categories: ["AI Fundamentals"]
description: "Brief description for SEO and social media"
ShowToc: true
TocOpen: false
weight: 1
cover:
    image: "path/to/image.jpg"
    alt: "Alt text for image"
    caption: "Image caption"
    relative: false
    hidden: false
---

Best Practices

1. SEO: Include relevant keywords in titles and descriptions
2. Multilingual: Keep content structure consistent across languages
3. Images: Optimize images for web and include proper alt text
4. Internal Linking: Link between related posts
5. Tags and Categories: Use consistent taxonomy

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test locally
5. Submit a pull request

📄 License

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

🙏 Acknowledgments

• Hugo - The world's fastest framework for building websites
• PaperMod - A fast, clean, responsive Hugo theme
• GitHub Pages - Free static site hosting

---

TODO Items to Complete:

1. Replace yourname with your actual GitHub username throughout the project
2. Update baseURL in config.yml with your actual URL
3. Replace placeholder social media links
4. Add your actual custom domain to CNAME file (or delete if not using)
5. Update author information in config.yml and post templates