A custom, Python-powered static site generator for building a beautiful developer portfolio. It fetches live GitHub contribution data via the GraphQL API, renders dynamic SVG charts, and automatically deploys to GitHub Pages via NeonDB-logged CI pipelines.
Everything you need to understand, run, and modify this project is thoroughly documented in the docs/ folder. Please refer to the links below:
- 🚀 Getting Started – Setup instructions and local previewing.
- 🏗️ Architecture & Build System – How the custom Python SSG works under the hood.
- 📝 Data & Content – How to easily update the content via
projects.md. - 🔌 GitHub API Integration – Details on the GraphQL queries and fallback systems.
- ⚙️ Deployment & CI/CD – How GitHub actions orchestrate the automated deployment and NeonDB logging.
| Technology | Purpose |
|---|---|
| Python 3.10+ | Core scripting logic, content parsing, and API interactions. |
| Jinja2 | Powerful templating engine for generating HTML files. |
| Markdown | Content structure parsing (projects.md). |
| Requests | HTTP client for interacting with the GitHub GraphQL API. |
| PostgreSQL (NeonDB) | Logging database driven by psycopg2 during CI/CD. |
| GitHub Actions | CI/CD automation. |
| Vanilla HTML/CSS/JS | The resulting beautifully generated static frontend output. |
# Clone the repository
git clone https://github.com/zakyislm/zakyislm.github.io.git
cd zakyislm.github.io
# Install dependencies
pip install -r requirements.txt
# Run the build
python build.pyFor more details, see the Getting Started Guide.
Generated by Jax