以前这个站都用了哪些引擎

文章发布时间:

最后更新时间:

文章总字数:
875

预计阅读时间:
3 分钟

以前这个站都是由哪几种工具构建的?

v0.1 “My Docs”、v1.0 “sysdl132 network”

  • 基于 python 的 mkdocs 和 material for mkdocs

目前该版本的代码已经找不到了

v2.0 “The site of sysdl132 - reborn”

  • hugo 和 jekyll

旧的文件存储在同一个代码仓库的 main-old 分支里

v3.0 “sysdl132’s lab”

  • hexo

我现在的版本

工具差别(AI 文章)

一、核心定位差异

  1. MkDocs:专为技术文档设计,以Markdown文件为核心生成静态HTML网站。其默认主题(如Material for MkDocs)针对文档阅读优化,支持多级导航、代码高亮和全文搜索,但博客功能需额外配置或使用专用主题(如mkdocs-simple-blog)。
  2. Jekyll:GitHub Pages原生支持的静态站点生成器,定位为“博客感知型”工具。其核心功能围绕博客场景设计,支持多语言、标签分类和RSS订阅,但文档功能需依赖插件扩展。
  3. Hexo:基于Node.js的静态博客生成器,专注博客场景。通过丰富的主题和插件体系,可快速实现高颜值博客,同时支持技术文档编写,但文档功能不如MkDocs专业。

二、技术栈对比

  1. MkDocs:使用Python编写,依赖pip安装,配置文件为YAML格式。适合熟悉Python生态的用户,且与Read the Docs等文档托管平台无缝集成。
  2. Jekyll:基于Ruby语言,需安装Ruby环境及Bundler管理依赖。其Liquid模板语法对非开发者有一定学习成本,但与GitHub Pages深度集成,无需额外构建流程。
  3. Hexo:基于Node.js,通过npm安装,支持npm插件生态。其命令行工具(CLI)简洁直观,适合前端开发者或熟悉JavaScript生态的用户。

三、性能与构建效率

  1. MkDocs:轻量级框架,构建速度快,适合中小型文档站点。但缺乏多语言支持和复杂模板引擎,扩展性有限。
  2. Jekyll:构建速度较慢,尤其在大型站点上表现不如Hugo或Hexo。其优势在于与GitHub Pages的无缝集成,适合无需高性能的静态博客场景。
  3. Hexo:构建速度优于Jekyll,但不及Hugo。其Node.js单线程特性在构建大型项目时可能成为瓶颈,但通过插件可优化构建流程。

四、功能扩展性

  1. MkDocs:插件生态丰富,支持全文搜索、国际化、多语言等文档核心功能。但博客相关插件较少,需依赖社区扩展。
  2. Jekyll:插件系统完善,可满足SEO优化、评论系统、代码高亮等博客需求。但插件质量参差不齐,部分功能需手动配置。
  3. Hexo:插件生态活跃,支持RSS、SEO、分类标签等博客功能,且主题数量众多,可快速实现个性化定制。

五、适用场景建议

  1. 个人博客快速搭建:Hexo是首选。其丰富的主题和插件体系可满足高颜值、功能丰富的博客需求,且部署简单(支持GitHub Pages、Vercel等平台)。
  2. 技术文档为主,博客为辅:MkDocs更合适。其文档友好型设计(如内置搜索、多级导航)可提升阅读体验,且通过mkdocs-simple-blog等主题可扩展博客功能。
  3. 偏好GitHub Pages原生集成:Jekyll是最佳选择。其与GitHub Pages的无缝集成可简化部署流程,适合无需额外服务器配置的项目。