用途:基于博客模板管理博客全生命周期,包括撰写或导入草稿、格式化文章、设置标题与头图、添加 SEO 结构、构建、预览与发布。
主要能力:项目含 config.py(站点常量配置)、build.py(生成器)、scripts/import_article.py(导入任意 HTML 文章为草稿)、scripts/import_x_articles.py(导入 X 文章为草稿)、scripts/og_image.py(按标题自动生成 OG 卡片)以及 templates、assets、content/posts、public 等目录。
使用方式:在 content/posts/ 创建 YYYY-MM-DD-<slug>.md,frontmatter 支持 title、slug、date、author、description、tags、draft、og_image、source_url;正文为标准 Markdown,导入文章可含内联 style/script。构建命令:python3 build.py --check(仅校验)、python3 build.py(完整构建,草稿不进入公开页面)、python3 build.py --drafts(草稿显示在首页并标记 [draft]),输出到 public/。预览可用 python3 -m http.server 8000 -d public/。导入示例:python3 scripts/import_article.py "URL" --date YYYY-MM-DD --slug S --title "T" --author "Author" --tags a,b --description "...";X 文章用 python3 scripts/import_x_articles.py。
发布:public/ 为静态 HTML,可部署至 GitHub Pages、Netlify/Vercel、任意静态托管或社区发布。
限制:配置缺失时回退 config.example.py;YAML 标题含 : 或 # 需加引号;图表依赖 vendor/chart.umd.min.js;头图为 RGBA PNG 时 Telegram/X 可能不显示预览;受保护 slug(1892-starchild-blog、1892-docs)不得停止或覆盖;价格、收费与效果等未提供。