关于本站
本站致力于梳理和总结全栈开发相关的知识体系与技术资源,旨在打造一个既方便自己日常工作查阅,也能为其他开发者提供参考价值的技术平台。站点的 核心知识内容均由 AI 辅助生成 ,这不仅确保了内容的专业性和系统性,更重要的是能够随着技术的演进持续更新,始终保持与时俱进。
建站理念
选择知识库+博客这种复合形式是经过深思熟虑的。相比纯博客形式,这种模式能让内容创作更加从容 —— 知识库部分可以持续积累,不受时间线的限制;而博客则用于分享个人的观点和思考。这样的组合既能保证内容的系统性和完整性,又能保持足够的灵活度。当有独到见解时,以博客形式呈现;而系统性的知识则以结构化的方式沉淀在知识库中。
技术选型
本站的建设过程中,我深入研究了多个优秀的知识库和博客站点,其中 https://spacexcode.com/ 的精心设计给了我很大的启发。在技术选型上,我也借鉴了业界多个成熟的解决方案。
建站框架
经过深入对比,最终选择了 Docusaurus 作为核心框架。这个选择主要基于以下考虑:
- 灵活的路由系统
- 强大的扩展能力
- 对动态页面的良好支持
- 完善的 MDX(Markdown + React 组件)支持
虽然 Next.js 和 Nuxt.js 这样的全能型框架也是不错的选择,但 Docusaurus 作为一个专注于文档和博客的框架,其开箱即用的特性和专业功能更符合本站的需求。
内容架构
站点内容规划为六大板块:
- 知识库:系统化的技术知识沉淀
- 博客:原创技术文章和心得分享
- 博客译站(建设中):优质外文技术文章的中文翻译
- 专题:特定技术领域的深度探讨
- 作品集:个人项目和技术实践展示
- Newsletter(建设中):定期发送的技术动态和见解
其中,博客译站是一个特色板块,通过 AI 辅助翻译的方式,为中文开发者带来优质的外文技术内容。Docusaurus 的多博客系统支持让这一功能的实现变得简单优雅。
技术架构
本站采用创新的双仓库架构:
- 源码仓库(Private):存放原始代码和内容
- 部署仓库(Public):存放编译后的静态文件
这种架构带来多重优势:
- 更好的内容管理:避免了传统单仓库模式下的 Fork 困扰
- 自动化部署:通过 GitHub Actions 实现从源码到部署的全自动化流程
- 可持续运营:借助 GitHub Pages 的稳定性,最大程度保证了站点的持续可用性
GitHub Pages 优势
选择 GitHub Pages 作为托管平台主要基于以下优势:
- 零成本:完全免费的托管服务
- 全球加速:依托 GitHub 的全球 CDN 网络
- 域名灵活:支持自定义域名绑定
- 安全保障:自动配置 SSL 证书
- 自动化支持:完整的 CI/CD 集成能力
虽然在国内访问速度上可能不如本土 CDN,但考虑到整体的稳定性和可持续性,GitHub Pages 仍是最佳选择。通过合理的技术方案,我们也可以在未来根据需要引入国内 CDN 来优化访问体验。