目录

静态网站生成工具

主流静态站点生成器与文档方案横向整理

下面整理常见的静态网站生成工具(Static Site Generator,SSG)与文档站点方案,记录它们的特点与代表性应用案例,便于横向对比与选型。

Jekyll 是 GitHub Pages 官方支持的静态网站生成工具,基于 Ruby。最大优势是能在 GitHub 上直接编辑 Markdown,提交后由 GitHub 自动完成构建。详情见 jekyllrb.com

Hugo 是基于 Go 语言的静态网站生成工具,以构建速度极快著称。

应用案例:

Hexo 是基于 Node.js 的博客框架,生成速度快,主题与插件生态丰富。

Gatsby 是基于 React 的站点框架,支持 SSG、DSG、SSR 等多种渲染方式,可按页选择。

VuePress 是以 Markdown 为中心、由 Vue 驱动的静态网站生成器,常用于文档站点。

Nuxt.js 是基于 Vue 的通用应用框架,支持 SSR 与静态站点生成(nuxt generate),可用于文档与博客。

Docusaurus 由 Meta(Facebook)维护,专注构建开源项目文档站点,支持版本化文档、博客与国际化。

应用案例:

  • k3s 文档

Eleventy(11ty)是一款零客户端 JavaScript、模板语言无关的轻量静态站点生成器,基于 Node.js。

Publii 是一款跨平台桌面端的静态网站生成工具,适合非技术用户可视化编辑后导出静态站点。

Primo 是一款可视化、拖拽式的静态网站构建工具,内置内容管理与部署能力。

MkDocs 是一款面向项目文档的静态站点生成器,基于 Python,源文件使用 Markdown,单一 YAML 配置文件管理。

Sphinx 是 Python 生态主流的文档生成工具,源文件使用 reStructuredText(也支持 MyST Markdown),可输出 HTML、PDF(LaTeX)、ePub 等多种格式。

应用案例:

  • Ray 文档
  • Python 官方 API 文档

GitBook 早期为开源 CLI 工具,曾广泛用于开源项目文档。其老版本 CLI 已被官方标记为废弃(legacy),当前 GitBook 主营托管与商业化平台。

Astro 是一款面向内容驱动网站(content-driven)的 Web 框架,官方定位为「The web framework for content-driven websites」。可使用 React、Vue、Svelte 等熟悉的框架编写 UI 组件,在构建时将整站渲染为静态 HTML,默认不向浏览器发送多余 JavaScript,从而获得较高的性能。

应用案例:

与上述「构建期生成静态 HTML」的工具不同,下面这类工具在浏览器端按需渲染 Markdown,无需构建过程。

docsify 是一款运行时文档站点生成器,直接由浏览器实时渲染 Markdown,无静态生成的 HTML 文件,部署轻量。

  • PicGo:基于 Vue-Cli + Electron 构建的图片上传工具。
  • PicX:基于 GitHub API 开发的图床工具,提供图片上传托管、链接生成与图片工具箱。
  • jsDelivr:面向开源项目的免费 CDN。
  • PicoShare:极简的图片与文件分享服务,便于自托管。

相关内容