AGENTS

概述

本仓库为「爬客」博客的 GitHub Pages 站点（sixgad.github.io），对外说明见 README.md。
内容以静态 HTML/CSS/JS 为主；本地用 Python 将各文章目录下的 Markdown 转为 article.html，并生成首页分页、文章索引、ACG 推荐页与导航聚合页（index-hub.html）。
工程取向：保持「纯静态 + 少量手写 CSS」与现有 Python 生成流程，不引入 Node/npm 构建链；全站导航与视觉增量集中在 static/css/site-v2.css，模板仍复用 static/css/style.css、plugin.css 等与旧版主题兼容的资源。

Python：用于站点生成脚本（具体次版本以本机环境为准）。
依赖（见 requirements.txt，已钉版本）：Jinja2==3.1.2、Markdown==3.4.1。
模板与生成：Jinja2 加载 basetp/ 下 ori_*.html 与 frag_nav.html；Markdown 使用 extra、codehilite、tables、toc、meta 等扩展（配置见 generate.py 中 default_config["md_ext"]）。
前端静态资源：static/ 下 Bootstrap、jQuery、合并版 plugin.js/plugin.css（内含 Bootstrap 与图标字体样式）、site-v2.css 等；无 package.json。static/fonts/ 当前仅保留 Font Awesome 与 Simple Line Icons 的 woff2 文件（与 plugin.css 中 @font-face 一致）。
托管：CNAME（自定义域）、.nojekyll（禁用 Jekyll 处理）。

blog/：文章目录，子文件夹名为 序号-标题；内含源稿 .md（及图片等）、生成结果 article.html。
basetp/：Jinja2 源模板——ori_index.html（首页分页）、ori_detail.html（文章页）、ori_list.html（索引）、ori_acg.html（ACG）、ori_hub.html（导航聚合）、frag_nav.html（顶栏导航片段，被各页 include）。
static/：全站公共 CSS/JS/字体与图片（如 static/css/、static/js/、static/fonts/、static/images/）。
仓库根目录：generate.py 为生成入口；index.html、index2.html… 为列表分页输出；index-list.html、index-acg.html、index-hub.html 为单页输出（运行生成脚本后更新）。

仓库内无 ESLint、Ruff、Black、EditorConfig 等统一工具链配置；修改时与现有 generate.py、模板与静态资源风格保持一致即可。
文章 Markdown 需带 markdown.extensions.meta 所需字段（脚本中读取 tags、date、title、private 等）；是否生成 article.html 由 private 的字符串判定（仅当取值（小写）中包含 no 或 false 时才生成，逻辑见 generate.py）。

pip install -r requirements.txt：安装生成博客页所需的 Python 依赖。
python generate.py：删除仓库根目录下所有以 index 开头且后缀为 .html 的文件后，扫描 blog/ 中 Markdown，生成各篇 article.html，并重新生成分页首页、index-list.html、index-acg.html 与 index-hub.html。