CERBERUS/awesome-python
1
0
Fork 0
mirror of https://github.com/vinta/awesome-python.git synced 2026-08-04 15:05:39 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 3

feat(website): generate static category pages

Browse source
This commit is contained in:
Vinta Chen 2026-05-02 23:31:08 +08:00
parent 429c9b3d12
commit e11afd1730
No known key found for this signature in database
GPG key ID: B93DE4F003C33630
7 changed files with 399 additions and 12 deletions
Download patch file Download diff file Expand all files Collapse all files

34
website/build.py
View file

@ -84,6 +84,14 @@ def build_robots_txt() -> str:
)
def category_path(category: ParsedSection) -> str:
return f"/categories/{category['slug']}/"
def category_public_url(category: ParsedSection) -> str:
return f"{SITE_URL}categories/{category['slug']}/"
def write_sitemap_xml(path: Path, urls: Sequence[tuple[str, str]]) -> None:
ET.register_namespace("", SITEMAP_NS)
urlset = ET.Element(f"{{{SITEMAP_NS}}}urlset")
@ -278,6 +286,7 @@ def build(repo_root: Path) -> None:
entry["last_commit_at"] = sd.get("last_commit_at", "")
entries = sort_entries(entries)
category_urls = {cat["name"]: category_path(cat) for cat in categories}
env = Environment(
loader=FileSystemLoader(website / "templates"),
@ -302,10 +311,27 @@ def build(repo_root: Path) -> None:
repo_stars=repo_stars,
build_date=build_date.strftime("%B %d, %Y"),
sponsors=sponsors,
category_urls=category_urls,
),
encoding="utf-8",
)
tpl_category = env.get_template("category.html")
categories_dir = site_dir / "categories"
for category in categories:
category_entries = [entry for entry in entries if category["name"] in entry["categories"]]
page_dir = categories_dir / category["slug"]
page_dir.mkdir(parents=True, exist_ok=True)
(page_dir / "index.html").write_text(
tpl_category.render(
category=category,
category_url=category_public_url(category),
entries=category_entries,
total_categories=len(categories),
),
encoding="utf-8",
)
static_src = website / "static"
static_dst = site_dir / "static"
if static_src.exists():
@ -317,11 +343,15 @@ def build(repo_root: Path) -> None:
llms_template = (website / "templates" / "llms.txt").read_text(encoding="utf-8")
llms_txt = build_llms_txt(llms_template, readme_text, stars_data)
(site_dir / "robots.txt").write_text(build_robots_txt(), encoding="utf-8")
write_sitemap_xml(site_dir / "sitemap.xml", [(SITE_URL, build_date.date().isoformat())])
sitemap_date = build_date.date().isoformat()
sitemap_urls = [(SITE_URL, sitemap_date)] + [
(category_public_url(category), sitemap_date) for category in categories
]
write_sitemap_xml(site_dir / "sitemap.xml", sitemap_urls)
(site_dir / "index.md").write_text(markdown_index, encoding="utf-8")
(site_dir / "llms.txt").write_text(llms_txt, encoding="utf-8")
print(f"Built single page with {len(parsed_groups)} groups, {len(categories)} categories")
print(f"Built site with {len(parsed_groups)} groups, {len(categories)} categories")
print(f"Total entries: {total_entries}")
print(f"Output: {site_dir}")