https://github.com/thatmlopsguy/thatmlopsguy.github.io
https://github.com/thatmlopsguy/thatmlopsguy.github.io
Last synced: 5 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/thatmlopsguy/thatmlopsguy.github.io
- Owner: thatmlopsguy
- License: mit
- Created: 2024-05-02T14:37:07.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2025-08-19T15:59:46.000Z (10 months ago)
- Last Synced: 2025-08-19T17:44:57.822Z (10 months ago)
- Language: Makefile
- Homepage: https://thatmlopsguy.github.io/
- Size: 4.73 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# That MLOps Guy Blog
This is the repository for my personal website built with [Hugo](https://gohugo.io/), a fast static site generator written in Go.
## 🚀 Quick Start
### Prerequisites
- [Git](https://git-scm.com/)
- [Hugo](https://gohugo.io/installation/) (for local development)
- [Docker](https://docs.docker.com/get-docker/) (alternative for local development)
### Clone the Repository
```bash
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:
```bash
git submodule update --init --recursive
```
## 🛠️ Development
### Option 1: Using Hugo (Recommended)
1. Install Hugo on your system following the [official installation guide](https://gohugo.io/installation/)
2. Start the development server:
```bash
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):
```bash
export HUGO_VERSION=0.119.0
```
2. Start the development server using Docker Compose:
```bash
make docs-serve
# or
docker compose up -d
```
3. Open your browser and navigate to `http://localhost:1313`
## 📁 Project Structure
```text
├── 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
```bash
hugo new posts/my-new-post.md
```
### New Note
```bash
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](https://github.com/thatmlopsguy/hugo-theme-cactus2) theme, which is included as a git submodule.
## 📝 Available Commands
Run `make help` to see all available commands:
```bash
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](LICENSE) file.