爱意满满的作品展示区。
evend

不用部署的 GitHub 个人主页:四套复古主题,改个 JSON 就生效

  •  
  •   evend · 56 mins ago · 70 views

    平时想开个人主页或博客,最后总是卡在同一件事上:买服务器、挑静态生成器、配 CI、写完还要 build 一次。但我的 README 和 Gist 本来就在 GitHub 上,为什么不能直接拿它们当主页?

    于是做了 ClassyGit。

    一句话:它把 GitHub 上已有的公开数据——profile README、公开仓库、公开 Gist、Gist 评论——渲染成个人主页 + 博客。四套主题:System 6、8-bit、Windows 98、DOS。

    把 URL 里的用户名换成任意公开的 GitHub 账号,都能直接生成页面,不用 fork,也不用注册。

    四套主题,同一份 GitHub 数据

    mac · System 6

    mac 主题

    用 mac 主题打开 demo

    nes · 8-bit

    nes 主题

    用 nes 主题打开 demo

    win98 · Windows 98

    win98 主题

    用 win98 主题打开 demo

    tui · DOS

    tui 主题

    用 tui 主题打开 demo

    它不是什么

    不是又一个静态博客生成器。区别在于内容和构建:

    • 内容不搬家:README 就是主页,Gist 就是文章,不用把旧文章导过来
    • 没有 build:Fork 仓库,改一个 classy.config.json(主要是 owner 字段),最多 5 分钟生效
    • 没有账号:站主不注册,访客不登录
    • 没有服务器:内容在 GitHub,页面由 Cloudflare 边缘渲染,没有 VPS、数据库、对象存储要维护

    Gist 变文章的方法很简单:描述写成 classy.blog.标题 #标签,分类、标题、标签就都有了。RSS、按月归档、阅读时长、多文件 Gist、Shiki 服务端高亮这些都有。

    技术上有意思的地方

    • 运行时只有两个外部依赖:GitHub 提供内容和身份,Cloudflare 提供计算、缓存和计数
    • Astro SSR 跑在 Workers 上,KV 存网站环和可索引用户,Durable Object 存访客计数
    • 没有内容数据库。Cloudflare 侧的数据全丢了也无所谓,内容一直在 GitHub 上,重新访问一次就能重建
    • 边缘缓存按「主题 + 语言」分键,用户主页 5 分钟、文章 1 小时,不会把 NES 的页面发给 mac 访客
    • 四套主题的 CSS 独立打包,看 mac 的人不会下载 NES 那 279KB
    • 服务端直出 HTML,OG 图和分享卡跟着当前主题走

    一些刻意的取舍

    • 只读公开数据,私有仓库和 secret Gist 不显示
    • 不存 IP、没有分析脚本,只有主题和语言两个功能性 cookie
    • 用户页默认 noindex,因为不然就是无限生成的薄内容;想被收录就自己开 seo.index
    • 留言簿直接用 Gist 评论,删留言就去 GitHub 删,没有审核后台,但留言需要 GitHub 账号
    • 公共实例只是一次部署,代码 MIT,自建、换域名、改主题都行

    适合谁

    想有个主页或博客、但一直不想碰服务器和构建流程的人,以及喜欢老系统界面的人。

    欢迎 issue、PR,或者直接甩个链接让我看看你的主题搭配。也想问问:这四套主题里你们最想加哪一套?

    No Comments Yet
    About   ·   Help   ·   Advertise   ·   Blog   ·   API   ·   FAQ   ·   Privacy   ·   Solana   ·   1035 Online   Highest 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 23ms · UTC 22:55 · PVG 06:55 · LAX 14:55 · JFK 17:55
    ♥ Do have faith in what you're doing.