[PR #2969] [MERGED] Relaunch website with custom build system #15963

New Issue

GiteaMirror · 2026-05-02T08:12:36-05:00

GiteaMirror commented

2026-05-02 08:12:36 -05:00

📋 Pull Request Information

Original PR: https://github.com/vinta/awesome-python/pull/2969
Author: @vinta
Created: 3/18/2026
Status: ✅ Merged
Merged: 3/18/2026
Merged by: @vinta

Base: master ← Head: feature/relaunch-website

📝 Commits (6)

4af84da remove mkdocs site infrastructure
177183d add custom website build system
cd7b8f6 update README description and remove Resources section
2fe0f5c ci: bump actions/checkout to v6 and upload-pages-artifact to v4
87a16f4 build: load .env in Makefile and rename fetch_stars to site_fetch_stats
7eb9b11 data: remove zipline entry from github_stars.json

📊 Changes

19 files changed (+5297 additions, -56 deletions)

View changed files

➕ .github/workflows/deploy-website.yml (+48 -0)
📝 .gitignore (+10 -4)
📝 Makefile (+12 -9)
📝 README.md (+1 -5)
➖ docs/CNAME (+0 -1)
➖ docs/css/extra.css (+0 -9)
➖ mkdocs.yml (+0 -26)
➕ pyproject.toml (+23 -0)
➖ requirements.txt (+0 -2)
➕ uv.lock (+258 -0)
➕ website/build.py (+502 -0)
➕ website/data/github_stars.json (+2622 -0)
➕ website/fetch_github_stars.py (+192 -0)
➕ website/static/main.js (+154 -0)
➕ website/static/style.css (+459 -0)
➕ website/templates/base.html (+67 -0)
➕ website/templates/index.html (+146 -0)
➕ website/tests/test_build.py (+642 -0)
➕ website/tests/test_fetch_github_stars.py (+161 -0)

📄 Description

Summary

Replace MkDocs with a custom Python site generator (Jinja2 + Markdown), with GitHub stars data, search, and a modern design
Add GitHub Actions workflow for automated deployment to GitHub Pages
Add uv for dependency management, Makefile targets for local dev (site_fetch_stats, site_build, site_preview)

Changes

Removed: mkdocs.yml, requirements.txt, docs/CNAME, docs/css/extra.css
Added: website/ (build script, templates, static assets, tests, star data), pyproject.toml, uv.lock, .github/workflows/deploy-website.yml
Updated: Makefile (new targets, .env auto-loading), README.md (description tweak, removed Resources section), .gitignore

Test plan

Run make site_build and verify the site generates in website/output/
Run make site_preview and check the site at localhost:8000
Run uv run pytest website/tests/ to verify all tests pass
Verify GitHub Actions workflow runs successfully on push to master

🤖 Generated with Claude Code

_{🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.}

## 📋 Pull Request Information **Original PR:** https://github.com/vinta/awesome-python/pull/2969 **Author:** [@vinta](https://github.com/vinta) **Created:** 3/18/2026 **Status:** ✅ Merged **Merged:** 3/18/2026 **Merged by:** [@vinta](https://github.com/vinta) **Base:** `master` ← **Head:** `feature/relaunch-website` --- ### 📝 Commits (6) - [`4af84da`](https://github.com/vinta/awesome-python/commit/4af84dac8e2fc4a53071588909444ae8c9089f0f) remove mkdocs site infrastructure - [`177183d`](https://github.com/vinta/awesome-python/commit/177183d9bde4b4f0a51f0d97e9f95588204a619d) add custom website build system - [`cd7b8f6`](https://github.com/vinta/awesome-python/commit/cd7b8f6bb0692c46377b8c88d68975b186cff999) update README description and remove Resources section - [`2fe0f5c`](https://github.com/vinta/awesome-python/commit/2fe0f5c2bd36652734425673e9d698e2b925cab4) ci: bump actions/checkout to v6 and upload-pages-artifact to v4 - [`87a16f4`](https://github.com/vinta/awesome-python/commit/87a16f47ead7ed523afc166eb3e73199b07c03a3) build: load .env in Makefile and rename fetch_stars to site_fetch_stats - [`7eb9b11`](https://github.com/vinta/awesome-python/commit/7eb9b11a67c523bbfb1227d0f50a2d3744a752d5) data: remove zipline entry from github_stars.json ### 📊 Changes **19 files changed** (+5297 additions, -56 deletions) <details> <summary>View changed files</summary> ➕ `.github/workflows/deploy-website.yml` (+48 -0) 📝 `.gitignore` (+10 -4) 📝 `Makefile` (+12 -9) 📝 `README.md` (+1 -5) ➖ `docs/CNAME` (+0 -1) ➖ `docs/css/extra.css` (+0 -9) ➖ `mkdocs.yml` (+0 -26) ➕ `pyproject.toml` (+23 -0) ➖ `requirements.txt` (+0 -2) ➕ `uv.lock` (+258 -0) ➕ `website/build.py` (+502 -0) ➕ `website/data/github_stars.json` (+2622 -0) ➕ `website/fetch_github_stars.py` (+192 -0) ➕ `website/static/main.js` (+154 -0) ➕ `website/static/style.css` (+459 -0) ➕ `website/templates/base.html` (+67 -0) ➕ `website/templates/index.html` (+146 -0) ➕ `website/tests/test_build.py` (+642 -0) ➕ `website/tests/test_fetch_github_stars.py` (+161 -0) </details> ### 📄 Description ## Summary - Replace MkDocs with a custom Python site generator (Jinja2 + Markdown), with GitHub stars data, search, and a modern design - Add GitHub Actions workflow for automated deployment to GitHub Pages - Add `uv` for dependency management, Makefile targets for local dev (`site_fetch_stats`, `site_build`, `site_preview`) ## Changes - **Removed**: `mkdocs.yml`, `requirements.txt`, `docs/CNAME`, `docs/css/extra.css` - **Added**: `website/` (build script, templates, static assets, tests, star data), `pyproject.toml`, `uv.lock`, `.github/workflows/deploy-website.yml` - **Updated**: `Makefile` (new targets, `.env` auto-loading), `README.md` (description tweak, removed Resources section), `.gitignore` ## Test plan - [x] Run `make site_build` and verify the site generates in `website/output/` - [x] Run `make site_preview` and check the site at `localhost:8000` - [x] Run `uv run pytest website/tests/` to verify all tests pass - [ ] Verify GitHub Actions workflow runs successfully on push to master 🤖 Generated with [Claude Code](https://claude.com/claude-code) --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>

GiteaMirror added the pull-request label 2026-05-02 08:12:36 -05:00

GiteaMirror closed this issue

2026-05-02 08:12:37 -05:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: github-starred/awesome-python#15963