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)

Install Hugo on your system following the official installation guide
Start the development server:
```
hugo serve
```
Open your browser and navigate to http://localhost:1313

Option 2: Using Docker

Set the Hugo version (optional, defaults to latest):
```
export HUGO_VERSION=0.119.0
```
Start the development server using Docker Compose:
```
make docs-serve
# or
docker compose up -d
```
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
│   └── mlops/         # Current theme
├── 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 a custom theme called mlops.

📝 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.