Humblebee AI - Blog

This repository is for "blog.humblebee.ai" technical blog.

✨ Features

• Technical blog
• MkDocs Material
• Markdown support
• Static site generator

---

🛠 Installation

1. 🚧 Prerequisites

• Install Python (>= v3.10) and pip (>= 23):
  • [RECOMMENDED] Miniconda (v3)
  • [arm64/aarch64] Miniforge (v3)
  • [Python virutal environment] venv

[OPTIONAL] For DEVELOPMENT environment:

• Install git
• Setup an SSH key (video tutorial)

2. 📥 Download or clone the repository

2.1. Prepare projects directory (if not exists):

# Create projects directory:
mkdir -pv ~/workspaces/projects

# Enter into projects directory:
cd ~/workspaces/projects

2.2. Follow one of the below options [A], [B] or [C]:

OPTION A. Clone the repository:

git clone https://github.com/humblebeeintel/docs.humblebee-blog.git && \
    cd docs.humblebee-blog

OPTION B. Clone the repository (for DEVELOPMENT: git + ssh key):

git clone git@github.com:humblebeeintel/docs.humblebee-blog.git && \
    cd docs.humblebee-blog

OPTION C. Download source code:

1. Download archived zip file from releases.
2. Extract it into the projects directory.

3. 📦 Install dependencies

# Install 'mkdocs-material' and other dependencies:
pip install -r ./requirements.txt

4. 🏁 Run the documentation server locally (for DEVELOPMENT)

mkdocs serve -a 0.0.0.0:8000
# Or:
./scripts/docs.sh

5. 🌐 Check the documentation in web browser

• http://localhost:8000

6. 🏗️ Generate the HTML documentation files (static site)

mkdocs build
# Or:
./scripts/build.sh

# Check the generated HTML files (it should be in the `site` directory):
ls -al ./site

7. 🚀 Deploy the documentation

If you make any changes to docs/* or mkdocs.yml, it will automatically re-deploy the new changes to GitHub Pages when you push to the main branch.

8. ✅ Verify the deployment

• Wait for a few minutes until the GitHub Actions workflow is completed.
• Then go to https://blog.humblebee.ai and verify the changes.
• If you don't see the changes, try to clear the browser cache or do a hard refresh (e.g. Cmd + Shift + R on macOS, or Ctrl + F5 on Windows).

👍

---

📑 References

• https://squidfunk.github.io/mkdocs-material
• https://squidfunk.github.io/mkdocs-material/getting-started
• https://www.mkdocs.org
• https://pypi.org/project/mkdocs-material
• https://github.com/mkdocs/catalog
• https://github.com/jimporter/mike
• https://mkdocstrings.github.io
• https://lukasgeiter.github.io/mkdocs-awesome-nav
• https://oprypin.github.io/mkdocs-literate-nav
• https://github.com/bharel/mkdocs-render-swagger-plugin
• https://blueswen.github.io/mkdocs-swagger-ui-tag