跳到主要内容

静态网站生成器

SSG, Static Site Generator, 静态网站生成器。

介绍

静态网站生成器是一种工具,它可以将动态内容转换为静态内容。静态内容是指不需要运行服务器就可以访问的内容。

静态网站生成器的优点是:

  • 速度快
  • 安全性高
  • 成本低

以下是一些常见的静态网站生成器:

Docusaurus

https://docusaurus.io/

Docusaurus 是一个现代化的、易于维护的静态网站生成器,专为构建文档网站而设计,支持多语言和插件扩展。

安装代码片段:

npx create-docusaurus@latest my-website classic

运行代码片段:

cd my-website
npm run start

它会启动开发服务器,默认访问 http://localhost:3000 即可查看生成的文档网站。

Gatsby

https://www.gatsbyjs.com/

Gatsby 是一个基于 React 的静态网站生成器,能够快速构建高性能的网站和应用,支持 Markdown、GraphQL 等功能,适合开发博客、文档等。

安装代码片段:

npm install -g gatsby-cli

使用代码片段:

# 创建新项目
gatsby new my-gatsby-site

# 进入项目目录
cd my-gatsby-site

# 启动开发服务器
gatsby develop

访问 http://localhost:8000 即可查看生成的网站。

VuePress & VitePress

VuePress

https://vuepress.vuejs.org/zh/

VuePress 是一个基于 Vue.js 的静态网站生成器,主要用于构建文档和博客。它支持 Markdown 语法,提供丰富的插件生态,可轻松定制主题和功能。

安装代码片段:

npm install -g vuepress

使用代码片段:

mkdir my-blog
cd my-blog

创建一个 Markdown 文件:

# Hello VuePress

This is my first VuePress blog.

运行 VuePress:

vuepress .

访问 http://localhost:8080 即可查看生成的静态页面。

VitePress

https://vitepress.dev/

VitePress 是一个基于 Vite 和 Vue 的静态站点生成器,专为构建文档网站而设计,具有快速冷启动和热更新的特点,支持 Markdown 和 Vue 组件。

安装代码片段:

npm create vitepress@latest my-docs

运行代码片段:

cd my-docs
npm install
npm run dev

访问 http://localhost:3000 即可查看生成的文档网站。

Hugo

https://gohugo.io/

Hugo 是一款快速且灵活的静态网站生成器,适合构建个人博客、文档站点等。它支持多种主题和自定义配置,能够快速生成静态页面。

安装代码片段(以 npm 安装为例):

npm install -g hugo

使用代码片段:

# 创建新网站
hugo new site my-site

# 创建新文章
cd my-site
hugo new posts/my-first-post.md

# 启动开发服务器
hugo server

访问 http://localhost:1313 即可查看生成的网站。

Hexo

https://hexo.io/zh-cn/

Hexo 是一个快速、简洁且高效的静态博客框架,使用 Node.js 编写,支持 Markdown 语法,适合快速搭建个人博客。

安装代码片段:

npm install -g hexo-cli

使用代码片段:

# 初始化博客项目
hexo init my-blog
cd my-blog

# 安装依赖
npm install

# 创建新文章
hexo new "My First Post"

# 启动开发服务器
hexo server

访问 http://localhost:4000 即可查看博客。

Docsify

https://docsify.js.org/#/

Docsify 是一个轻量级的文档网站生成工具,支持 Markdown 语法,无需构建步骤,直接将 Markdown 文件转换为文档网站,适合快速搭建文档页面。

安装代码片段:

npm install docsify-cli -g

使用代码片段:

# 初始化项目
docsify init ./my-docs

# 启动本地服务器
cd my-docs
docsify serve

访问 http://localhost:3000 即可查看生成的文档网站。

Nextra

https://nextra.site/

Nextra 是一个基于 Next.js 的静态文档框架,专为构建高性能文档网站而设计,支持 Markdown 和 MDX 格式,内置主题和插件系统,可快速搭建文档站点。

安装代码片段:

npx create-nextra@latest my-docs

运行代码片段:

cd my-docs
npm install
npm run dev

访问 http://localhost:3000 即可查看生成的文档网站。

Rspress

https://rspress.dev/zh/

Rspress 是一个基于 Rust 和 Web 技术构建的静态站点生成器,专注于性能和易用性,适合构建文档、博客和项目网站。

安装代码片段:

npm install -g rspress

使用代码片段:

# 创建新项目
rspress new my-site

# 进入项目目录
cd my-site

# 启动开发服务器
rspress dev

访问 http://localhost:3000 即可查看生成的网站。

其他

  • MkDocs
  • Jekyll
  • Pagic
  • Astro
  • Docz
  • Confluence
  • bisheng
  • dumi