静态网站生成器
SSG, Static Site Generator, 静态网站生成器。
介绍
静态网站生成器是一种工具,它可以将动态内容转换为静态内容。静态内容是指不需要运行服务器就可以访问的内容。
静态网站生成器的优点是:
- 速度快
- 安全性高
- 成本低
以下是一些常见的静态网站生成器:
Docusaurus
Docusaurus 是一个现代化的、易于维护的静态网站生成器,专为构建文档网站而设计,支持多语言和插件扩展。
安装代码片段:
npx create-docusaurus@latest my-website classic
运行代码片段:
cd my-website
npm run start
它会启动开发服务器,默认访问 http://localhost:3000
即可查看生成的文档网站。
Gatsby
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
VitePress 是一个基于 Vite 和 Vue 的静态站点生成器,专为构建文档网站而设计,具有快速冷启动和热更新的特点,支持 Markdown 和 Vue 组件。
安装代码片段:
npm create vitepress@latest my-docs
运行代码片段:
cd my-docs
npm install
npm run dev
访问 http://localhost:3000
即可查看生成的文档网站。
Hugo
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
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
Docsify 是一个轻量级的文档网站生成工具,支持 Markdown 语法,无需构建步骤,直接将 Markdown 文件转换为文档网站,适合快速搭建文档页面。
安装代码片段:
npm install docsify-cli -g
使用代码片段:
# 初始化项目
docsify init ./my-docs
# 启动本地服务器
cd my-docs
docsify serve
访问 http://localhost:3000
即可查看生成的文档网站。
Nextra
Nextra 是一个基于 Next.js 的静态文档框架,专为构建高性能文档网站而设计,支持 Markdown 和 MDX 格式,内置主题和插件系统,可快速搭建文档站点。
安装代码片段:
npx create-nextra@latest my-docs
运行代码片段:
cd my-docs
npm install
npm run dev
访问 http://localhost:3000
即可查看生成的文档网站。
Rspress
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