读取你 GitHub 上的公开数据,渲染成多种复古风格的个人主页 + 博客,并且可进行个性化配置。内容不迁移,不建数据库,不买服务器, 前言 我想有个自己的主页和博客,但不想把文章搬到新平台、换图片链接、接评论系统、维护构建和部署。
GitHub 上已经有 profile README、公开仓库和一些 Gist,直接拿来当内容源就够了。 ClassyGit 就是这个思路:GitHub 是内容源,站点只是渲染层。
内容一直在 GitHub,换一个实例或自建都能继续。是什么,不是什么 是:读取 GitHub 公开数据的渲染层,提供主页、仓库页、Gist 博客、归档、留言簿和 RSS。
不是:静态博客生成器,不托管内容,不需要构建发布;也不是通用建站工具,不能随便写页面。要完全自定义,Astro / Hexo 更合适。
和 GitHub 自带 profile README 的区别:README 只有一页,ClassyGit 是多页站点,仓库列表、仓库 README、Gist 文章、归档、标签、留言簿都在。能做什么 README 直接当主页 :保留 Markdown、代码高亮和相对图片;自动生成资料卡、贡献墙、最近仓库、最近 Gist、近况。
Gist 就是博客 :描述写 classy.blog.标题 #标签 ,自动解析分类、标题、标签;支持多文件、阅读时间、按月归档、标签筛选、搜索、Atom。留言簿 :用一条公开 Gist 的评论当留言板,站点只读展示;这条 Gist 必须是你的公开 Gist,删留言直接在 Gist 里删。
留言需要 GitHub 账号。复古社区件 :网站环(满 3 人出现上一站/随机/下一站)、随机推荐、88×31 徽章。
分享件 :主题分享卡带二维码、1200×630 OG 图、sitemap。多页 :主页、仓库列表、仓库 README、Gist 列表、文章、归档、留言簿、RSS。
怎么个性化配置 Fork Dnevend/classy-github ,仓库名保持 classy-github 。打开 /ai-market-guide/ 生成配置,粘到根目录 classy.config.json ,把 owner 改成你的 GitHub 用户名。
打开 /ai-market-guide/ ,配置最多 5 分钟生效。不用构建、不用 CI、不用 Cloudflare 账号、不用域名。
配置生成器只生成 JSON,不请求 GitHub 授权,也不用给 ClassyGit 任何 token。想先看效果,任何公开 GitHub 账号都能直接打开 /ai-market-guide/ ,不用 fork。
技术实现 Astro SSR 跑在 Cloudflare Workers,服务端直出 HTML,边缘缓存。没有内容数据库;KV 只存网站环、随机推荐、可索引用户,Durable Object 只存访客数。
这些丢了也能从 GitHub 重建。 GitHub GraphQL 限流时回退 REST;配额耗尽时优先返回 24 小时内的旧页面( x-classy-stale ),而不是错误页。
README、Gist、留言走白名单清洗, javascript: 链接会被丢弃;不存 IP,只有主题和语言两个功能性 cookie。已知限制 只读公开数据,私有仓库和 secret Gist 不显示。
Gist 最多 100 条;README、仓库、Gist 列表最多缓存 30 分钟。默认 noindex ,要搜索引擎收录得设 seo.index: true 。
和 GitHub Pages / Hexo 的区别 GitHub Pages + Hexo 自由度高,但内容要搬、要构建、要挑主题。 ClassyGit 是内容零迁移、配置即数据、多页现成,代价是定制空间小、依赖公共实例和 GitHub API。
如果你要的是完全静态、深度定制,前者更合适;如果你只是想让已有的 GitHub 内容有个门面,ClassyGit 更省事。链接 在线体验: /ai-market-guide/ 我的主页: /ai-market-guide/ 源码(MIT): https://github.com/Dnevend/classy-github 功能和边界都还比较早期,如果试了觉得哪里别扭,欢迎在帖子里说,或者直接提 issue,欢迎 Star 支持。