That MLOps Guy Blog

This is the repository for my personal website built with Hugo, a fast static site generator written in Go.

🚀 Quick Start

Prerequisites

• Git
• Hugo (for local development)
• Docker (alternative for local development)

Clone the Repository

git clone --recurse-submodules https://github.com/thatmlopsguy/thatmlopsguy.github.io.git
cd thatmlopsguy.github.io

If you've already cloned the repository without submodules, initialize them:

git submodule update --init --recursive

🛠️ Development

Option 1: Using Hugo (Recommended)

1. Install Hugo on your system following the official installation guide

2. Start the development server:

   hugo serve

3. Open your browser and navigate to http://localhost:1313

Option 2: Using Docker

1. Set the Hugo version (optional, defaults to latest):

   export HUGO_VERSION=0.119.0

2. Start the development server using Docker Compose:

   make docs-serve
   # or
   docker compose up -d

3. Open your browser and navigate to http://localhost:1313

📁 Project Structure

├── archetypes/        # Content templates
├── content/           # All content files
│   ├── posts/         # Blog posts
│   └── notes/         # Notes and quick thoughts
├── data/              # Data files (JSON, YAML, TOML)
├── layouts/           # Custom layout files
├── static/            # Static assets (images, files)
├── themes/            # Hugo themes
│   └── cactus2/       # Current theme (git submodule)
├── docker-compose.yml # Docker development setup
├── hugo.toml          # Hugo configuration
└── Makefile           # Build commands

✍️ Creating Content

New Blog Post

hugo new posts/my-new-post.md

New Note

hugo new notes/my-new-note.md

🚀 Deployment

This site is automatically deployed to GitHub Pages when changes are pushed to the main branch.

🎨 Theme

This site uses the Cactus2 theme, which is included as a git submodule.

📝 Available Commands

Run make help to see all available commands:

make help

🤝 Contributing

Feel free to open issues or submit pull requests if you find any problems or have suggestions for improvements.

📄 License

This project is licensed under the terms specified in the LICENSE file.