
地 址:上海市杨浦66号
电 话:19985779531
网址:dsesh.com
邮 箱:93643448@qq.com
一、网站文档网站使用 Docusaurus搭建
特点:Facebook 开源的搭建(jian)搭建(jian)静态网站生(sheng)成器,基于 React 开发,流程支持 Markdown 编写文档,技术教程内置搜索、网站文档网站国际化等功能,搭建搭建主题丰富且可自定义。流程

步骤:


```bash
npx create-docusaurus@latest my-website classic
```
使用 `classic` 模板(适合技术(shu)文档)
配置项目
修改 `docusaurus.config.js` 中的技术教程标题、描述等基本信息
添加(jia) Markdown 文件到 `docs` 目录
启动开发服务器
```bash
npm start
```
访问 `http://localhost:3000` 查看效果(guo)
部署
部署到 GitHub Pages 可自动配置 HTTPS
或选择其他静态站点托管服务(wu)
二、网站文(wen)档网站使用 Docsify搭建
特点: 轻量(liang)级文档生(sheng)成工具,搭建搭建运行时转换文档,流程无需生成(cheng)静态 HTML 文(wen)件,技术教(jiao)程适合快速部署到 GitHub Pages,网站文档网站支持插件扩展(zhan)。搭建搭建 步骤安装 Node.js
(需版本 ≥ 14)
全局安装 Docsify CLI
```bash
npm i docsify-cli -g
```
初始化项目
```bash
docsify init ./docs
```
生成 `index.html`、流程`README.md` 等基础文件(jian)
启动本地服务器
```bash
docsify serve
```
访问 `http://localhost:3000` 预览
配置与(yu)部署
通过 `index.html` 配置侧边栏、插件等
部署至 GitHub Pages,支持自动 HTTPS 配置
三、其(qi)他选择方案
VuePress:
CloudBase:提供一键部署服务,支持域名和(he) HTTPS,适合无服务器(qi)架构
静态站点生成器:如 Jekyll(需配置 Git)或 Hugo(需学习模板语法)
总结
Docusaurus 和 Docsify 都是快速搭建技术文档网站的优秀选择。Docusaurus 功能更全面,适合需要复杂配置和主题定制(zhi)的场景;Docsify 更(geng)轻量,适合简单部署和快速迭代(dai)。根据(ju)需求选择合适工具,并结合 GitHub Pages 或其他托管服务即可。