再谈在 GitHub Issues 写作,顺带算是样式开源
内容提要
本文介绍了使用Next.js和GitHub API在GitHub Issues上写博客的方法,包括实时获取最新数据、构建网站和实现暗色模式。作者还分享了Next.js的优化和经验。
延伸解读
从静态生成到实时获取:架构选择的权衡
文章对比了早期用GitHub Actions同步Issues到Hexo的方案与现在用Next.js + Vercel Serverless Functions实时获取的方案。前者需要手动触发部署,后者在用户请求时动态获取最新数据,无需后端服务器,但无法静态导出,且可能因滥用导致额度消耗。作者建议可额外套CDN和防火墙规则来缓解。
Markdown渲染库的选择:功能与体积的平衡
作者从markdown-to-jsx切换到react-markdown并添加插件后,Serverless Functions体积从约290KB增至480KB。虽然对Vercel边缘节点影响不大,但如果只需基本Markdown渲染,markdown-to-jsx更轻量。react-markdown的优势在于插件生态,如支持GFM、数学公式和代码高亮。
暗色模式实现:从next-themes到手动控制
作者最初使用next-themes,但发现其导致Disqus评论系统无法正确识别暗色模式,于是改为手动实现。通过React Context管理三种模式(亮色、暗色、跟随系统),并用localStorage保存用户选择。为避免页面加载时闪烁,在Context Provider中插入内联脚本,在HTML首次返回时即设置正确的颜色模式。
Next.js内置优化与开发体验
Next.js 13+的App Router和React Server Components将大部分渲染工作放在服务端,减轻客户端压力。内置的图片、字体、组件懒加载等优化无需手动配置。作者还提到可用react.cache、react.memo、useCallback进一步优化,但需注意使用场景,例如在组件内部嵌套定义子组件可能并不总是需要useCallback。
Q&A
如何在GitHub Issues上写博客?
可以使用Next.js和GitHub API,通过GitHub Actions和Node.js脚本将Issues数据同步到博客,实时获取最新数据。
Next.js如何优化博客的性能?
Next.js 13及以后的版本提供了许多内置优化,如懒加载、无刷新导航和动态HTML渲染,减轻客户端性能压力。
如何实现暗色模式?
可以使用next-themes库或手动实现,通过React Context管理颜色模式状态,并支持用户选择和系统跟随。
使用Octokit库获取Issues数据的步骤是什么?
首先安装Octokit库,然后使用octokit.rest.issues.listForRepo方法获取特定用户的Issues数据,并处理API分页。
Tailwind CSS在博客中的作用是什么?
Tailwind CSS用于样式处理,通过utility-first的方式简化Markdown样式,提升页面的美观性和可读性。
如何将Markdown格式的Issues数据转换为React Node?
可以使用react-markdown库,将Markdown格式的数据转换为React Node,并自定义渲染Markdown组件。