提示

本次教程以宝塔面板为例，需要提前准备好宝塔环境

前提条件

• 安装宝塔面板
• 安装Node.js，要求版本必须大于v18及以上
• 包管理器: npm >= 8、yarn >= 2 或 pnpm >= 7
• 创建知识库对应站点目录
• 已将域名解析到对应站点

---

安装开始

1. 进入站点目录

例如目录为：/www/wwwroot/help.560.com

cd /www/wwwroot/help.560.com

• 注意：路径为部署站点的实际目录

2. 在站点目录下，运行终端，执行安装命令

npm init vuepress-theme-hope help560

提示

命令会新建一个文件夹：help560，并且将vuepress系统文件安装在help560文件夹内

3. 根据界面选择安装

选项说明

• 语言：简体中文
• 包管理器： npm （推荐）
• 应用名称：自填（注意只能英文）
• 版本：1.0.0
• 应用描述：可留空(在主题设置内可修改)
• 设置协议MIT：不填（按回车键下一步）
• 是否需要多语言： N （选Y，会按每个语言构建多个目录）
• Github工作流： N
• 创建项目的类型：Docs （推荐）
• 使用源：国内镜像源（推荐）

注意

注意：安装过程中无法看到进度条，需要耐心等待一段时间。

安装完毕后界面上会出现类似如下画面：

1. 安装完毕后，使用命令构建项目

npm run docs:build

命令说明： 使用构建命令后，会在子目录src/.vuepress/dist 生成静态站点文件 如图：

1. 复制dist文件夹到站点的根目录，并且设置站点的运行目录为dist目录

复制dist到站点根目录

复制dist到站点根目录

设置站点运行目录为diist

Alt text

5. 部署完成，访问站点对应的域名即可

   例如：help.sap560.com

Alt text

后续教程

以上教程为安装vuepress系统，安装后仅为初始化环境。

正式使用，需要掌握以下知识：

1. 编写知识库文档，需掌握markdown语言

   • 参考教程： Markdown知识库

2. 发布知识库文档，需要构建知识库文档

   • 参考教程：构建知识库文档

3. 更多功能配置，请查看左侧功能配置列表