地 址：联系地址联系地址联系地址
电 话：020-123456789
网址：whcdba.com
邮 箱：admin@aa.com
根据你的网站文件网站需求，以下是平台使用 Docsify和 MkDocs两种工具搭建静态文档网站的步骤指南，供你参考：
一、搭建使用 Docsify 搭建文档网站
Docsify是网站文件网站一个轻量级、可扩展的平台静态网站生成器，专为文档展示设计，搭建支持 Markdown 编写和多种主题。网站文件网站
1. 安装与初始化
安装 Docsify CLI
在终端运行以下命令安装全局工具：
```bash
npm i docsify-cli -g
```
创建项目目录
```bash
mkdir docsify-demo
cd docsify-demo
```
初始化 Docsify
运行命令生成配置文件和示例结构：
```bash
docsify init
```
本地预览
使用以下命令启动本地服务器：
```bash
docsify serve
```
访问 `http://localhost:3000/` 即可查看效果。平台
2. 自定义配置与主题
修改配置文件
编辑 `docsify.yml`（或 `index.html`）设置站点名称、搭建URL、网站文件网站导航菜单等。平台
主题定制
支持多种主题，搭建可通过修改配置文件切换主题，网站文件网站或克隆官方主题仓库进行二次开发。平台
二、搭建使用 MkDocs 搭建文档网站
MkDocs是另一个流行的静态网站生成器，以 Markdown 为基础，适合技术文档和项目文档。
1. 安装与项目创建
安装 MkDocs
通过 pip 安装：
```bash
pip install mkdocs
```
创建新项目
```bash
mkdocs new my_docs
```
生成 `mkdocs.yml` 配置文件和 `docs` 文档目录。
2. 配置与内容填充
编辑配置文件
在 `mkdocs.yml` 中设置站点名称、URL、导航结构等。
编写文档
使用 Markdown 编写文档，存入 `docs` 目录。
启动本地服务器
运行命令预览网站：
```bash
mkdocs serve
```
访问 `http://localhost:8000/` 查看效果。
三、注意事项
Docsify 和 MkDocs 无需单独安装服务器软件，直接通过 `serve` 命令启动即可。
部署选项
静态网站托管： 将生成的 `site` 目录部署到 GitHub Pages、Netlify 等平台。 自建服务器
插件支持：
Docsify 提供插件扩展功能，MkDocs 可通过 `mkdocs plugins` 管理插件。
动态内容：若需动态内容，可结合后端语言（如 Python、Node.js）使用。
四、总结
Docsify 和 MkDocs 都是轻量化的文档网站搭建工具，选择时可根据需求：
Docsify：适合纯文档展示，易用性高，支持主题扩展。
MkDocs：适合技术文档，集成 Markdown 编辑器，适合团队协作。
通过以上步骤，你可以在本地快速搭建文档网站，并根据需求进行定制和部署。
