From 07e64cbda059f6e94ac9159860eb0fda055b83c0 Mon Sep 17 00:00:00 2001 From: Inaki Fernandez Date: Thu, 25 Jun 2026 18:00:53 +0200 Subject: [PATCH] feat(v2): promote Awesome Lists to a flagship page with hero + category grid MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The V2 "Awesome Lists" page (other-awesome-lists.md, derived from V1's /v1/other-awesome-lists/) already existed but was buried under the "Architectural Foundations" submenu. Promote it to a top-level, high-impact destination: - New src/awesome_page.py builds a hero banner + a category card grid derived from the page's own rendered H2 sections (stays in sync with AI re-clustering). - v2_optimizer injects the header for other-awesome-lists.md during rendering, so it survives pipeline regeneration. - Move it to a prominent top-level nav entry "⭐ Awesome Lists" (removed from the Architectural Foundations submenu). - Add hero/grid/card styles to the V2 stylesheet. - Apply the header to the current rendered page for immediate deploy. Co-Authored-By: Claude Opus 4.8 (1M context) --- docs/static/v2_elite.css | 105 +++++++++++++++++++++++++++++++++ src/awesome_page.py | 74 +++++++++++++++++++++++ src/v2_optimizer.py | 13 +++- v2-docs/other-awesome-lists.md | 68 +++++++++++++++++++++ v2-mkdocs.yml | 2 +- 5 files changed, 259 insertions(+), 3 deletions(-) create mode 100644 src/awesome_page.py diff --git a/docs/static/v2_elite.css b/docs/static/v2_elite.css index df0dce7b..956d71a4 100644 --- a/docs/static/v2_elite.css +++ b/docs/static/v2_elite.css @@ -1804,3 +1804,108 @@ input[type="text"] { + +/* =================================================================== + The Awesome Lists page: high-impact hero + category card grid. + Used by other-awesome-lists.md (header injected by src/awesome_page.py). + =================================================================== */ +.awesome-hero { + margin: 1.2rem 0 1.6rem; + padding: 2.2rem 1.5rem; + border-radius: 16px; + text-align: center; + color: #fff; + background: + radial-gradient(120% 140% at 50% 0%, + color-mix(in srgb, var(--md-accent-fg-color) 70%, #6d28d9) 0%, + color-mix(in srgb, var(--md-primary-fg-color) 80%, #111827) 75%); + box-shadow: 0 10px 34px -12px color-mix(in srgb, var(--md-accent-fg-color) 60%, transparent); + overflow: hidden; +} +.awesome-hero__badge { + font-size: clamp(1.4rem, 3.2vw, 2.2rem); + font-weight: 800; + letter-spacing: 0.06em; + line-height: 1.15; + text-shadow: 0 2px 12px rgba(0, 0, 0, 0.28); +} +.awesome-hero__sub { + margin-top: 0.5rem; + font-size: 0.95rem; + opacity: 0.92; +} +.awesome-hero__sub code { + background: rgba(255, 255, 255, 0.18); + color: #fff; + padding: 0.05em 0.35em; + border-radius: 5px; +} +.awesome-hero__stats { + margin-top: 1.3rem; + display: flex; + flex-wrap: wrap; + justify-content: center; + gap: 0.7rem 1.4rem; +} +.awesome-hero__stat { + display: flex; + flex-direction: column; + align-items: center; + font-size: 0.72rem; + text-transform: uppercase; + letter-spacing: 0.08em; + opacity: 0.9; +} +.awesome-hero__stat strong { + font-size: 1.55rem; + line-height: 1; + font-weight: 800; +} + +.awesome-grid { + display: grid; + grid-template-columns: repeat(auto-fill, minmax(210px, 1fr)); + gap: 0.85rem; + margin: 1.4rem 0 2rem; +} +.awesome-card { + display: flex; + flex-direction: column; + justify-content: space-between; + gap: 0.6rem; + min-height: 84px; + padding: 0.85rem 1rem; + border-radius: 12px; + border: 1px solid color-mix(in srgb, var(--md-accent-fg-color) 24%, transparent); + background: var(--md-default-bg-color); + color: var(--md-default-fg-color); + text-decoration: none; + transition: transform 0.14s ease, box-shadow 0.14s ease, border-color 0.14s ease; +} +.awesome-card:hover { + transform: translateY(-3px); + border-color: var(--md-accent-fg-color); + box-shadow: 0 12px 26px -14px color-mix(in srgb, var(--md-accent-fg-color) 70%, transparent); +} +.awesome-card__name { + font-weight: 700; + font-size: 0.95rem; + line-height: 1.25; +} +.awesome-card__meta { + display: flex; + align-items: baseline; + gap: 0.4rem; +} +.awesome-card__count { + font-size: 1.35rem; + font-weight: 800; + color: var(--md-accent-fg-color); + line-height: 1; +} +.awesome-card__stars { + font-size: 0.7rem; + text-transform: uppercase; + letter-spacing: 0.06em; + opacity: 0.7; +} diff --git a/src/awesome_page.py b/src/awesome_page.py new file mode 100644 index 00000000..5cd043e4 --- /dev/null +++ b/src/awesome_page.py @@ -0,0 +1,74 @@ +"""High-impact header for the V2 "Awesome Lists" page. + +The Awesome Lists page (``other-awesome-lists.md``, derived from V1's +``/v1/other-awesome-lists/``) is a curated, AI-classified directory of the best +external ``awesome-*`` lists across the Cloud Native ecosystem. This module +builds the flagship hero banner + a category grid (cards that jump to each +in-page section), generated from the page's own rendered ``##`` headings so it +stays in sync no matter how the AI re-clusters the categories. + +Pure stdlib so it can run inside ``src.v2_optimizer`` and be tested standalone. +""" + +import re + +_H2_RE = re.compile(r"^##\s+(.+?)\s*$", re.MULTILINE) +_LINK_RE = re.compile(r"\]\(https?://") + + +def _slug(text: str) -> str: + """Slug matching python-markdown/toc anchors (lowercase, no punctuation).""" + s = text.lower().replace("&", " ") + s = re.sub(r"[()]", "", s) + s = re.sub(r"[^a-z0-9]+", "-", s).strip("-") + return s + + +def _sections(body_md: str): + """Return [(title, anchor, link_count), ...] for each H2 section in order.""" + matches = list(_H2_RE.finditer(body_md)) + out = [] + for i, m in enumerate(matches): + title = m.group(1).strip() + start = m.end() + end = matches[i + 1].start() if i + 1 < len(matches) else len(body_md) + count = len(_LINK_RE.findall(body_md[start:end])) + out.append((title, _slug(title), count)) + return out + + +def build_awesome_lists_header(body_md: str) -> str: + """Build the hero + category grid that precedes the Awesome Lists body.""" + sections = _sections(body_md) + total_lists = sum(c for _, _, c in sections) + n_cats = len(sections) + + md = ( + "
\n" + "
⭐ AWESOME LISTS ⭐
\n" + "
The best curated awesome-* lists · AI-classified · link-validated
\n" + "
\n" + f" {total_lists}curated lists\n" + f" {n_cats}categories\n" + "
\n" + "
\n\n" + "!!! tip \"The meta-directory of the Cloud Native ecosystem\"\n" + " A hand-picked, AI-classified index of the most valuable community " + "**awesome-* lists** — every one link-validated and filed by topic. Jump " + "to a category below, or browse the full directory. For the original " + "exhaustive archive, see the [**V1 Historical Archive**](/v1/other-awesome-lists/).\n\n" + ) + + if sections: + md += "
\n" + for title, anchor, count in sections: + md += ( + f" \n" + f" {title}\n" + f" {count}" + f"lists\n" + f" \n" + ) + md += "
\n\n" + + return md diff --git a/src/v2_optimizer.py b/src/v2_optimizer.py index 3559e410..9eca0c8b 100644 --- a/src/v2_optimizer.py +++ b/src/v2_optimizer.py @@ -16,6 +16,7 @@ from src.config import GEMINI_API_KEYS, GH_TOKEN, TARGET_REPO, MADRID_TZ, INVENT from src.gemini_utils import call_gemini_with_retry, normalize_url, clean_toc_text, get_github_activity, fetch_youtube_metadata from src.logger import log_event from src.inventory_manager import update_inventory_entry +from src.awesome_page import build_awesome_lists_header def nuclear_strip(text: str) -> str: @@ -1724,8 +1725,16 @@ class V2VisionEngine: ) - md += await render_node(info["content"], -1, f_name.replace(".md", ""), used_headers, is_intro=(f_name=="introduction.md" or f_name=="about.md")) - + _body = await render_node(info["content"], -1, f_name.replace(".md", ""), used_headers, is_intro=(f_name=="introduction.md" or f_name=="about.md")) + # The flagship "Awesome Lists" page gets a high-impact hero + a grid + # of its categories (auto-derived from the rendered H2 sections). + if f_name == "other-awesome-lists.md": + try: + md += build_awesome_lists_header(_body) + except Exception as e: + log_event(f"[WARN] awesome-lists header failed: {str(e)[:100]}") + md += _body + # Add Semantic "See Also" — same dimension + cross-dimension by shared tags same_dim = [f for f in data if f != f_name and data[f]["dim"] == info["dim"]] cross_dim = [] diff --git a/v2-docs/other-awesome-lists.md b/v2-docs/other-awesome-lists.md index 40952973..1a0c909b 100644 --- a/v2-docs/other-awesome-lists.md +++ b/v2-docs/other-awesome-lists.md @@ -9,6 +9,74 @@ description: "Top Other Awesome Lists resources for 2026, AI-ranked: Awesome Com !!! info "Architectural Context" Detailed reference for Awesome Lists in the context of Architectural Foundations. + +
+
⭐ AWESOME LISTS ⭐
+
The best curated awesome-* lists · AI-classified · link-validated
+
+ 33curated lists + 13categories +
+
+ +!!! tip "The meta-directory of the Cloud Native ecosystem" + A hand-picked, AI-classified index of the most valuable community **awesome-* lists** — every one link-validated and filed by topic. Jump to a category below, or browse the full directory. For the original exhaustive archive, see the [**V1 Historical Archive**](/v1/other-awesome-lists/). + +
+ + AI and Machine Learning + 1lists + + + API Development + 2lists + + + Artificial Intelligence + 1lists + + + Cloud Native + 10lists + + + Continuous Delivery + 1lists + + + Curation + 3lists + + + Deployment and Delivery + 1lists + + + DevOps and Platform Engineering + 1lists + + + Infrastructure + 1lists + + + Infrastructure and Operations + 5lists + + + Observability and Monitoring + 1lists + + + Programming Languages + 3lists + + + Software Engineering + 3lists + +
+ ## AI and Machine Learning ### MLOps diff --git a/v2-mkdocs.yml b/v2-mkdocs.yml index b588581b..dddba8aa 100644 --- a/v2-mkdocs.yml +++ b/v2-mkdocs.yml @@ -162,6 +162,7 @@ markdown_extensions: nav: - "🔙 Back to V1 (Exhaustive)": https://nubenetes.com/v1/ - "The 2026 Vision": index.md + - "⭐ Awesome Lists": other-awesome-lists.md - "Portal Guide": - "Topic Map": topic-map.md - "Methodology": methodology.md @@ -200,7 +201,6 @@ nav: - "Matrix Table": matrix-table.md - "Mkdocs": mkdocs.md - "Monitoring": monitoring.md - - "Other Awesome Lists": other-awesome-lists.md - "Prometheus": prometheus.md - "Platform & Site Reliability": - "Chaos Engineering": chaos-engineering.md