# 快速上手

如果你想在某个网页或者文章页中使用 Waline,请参照以下步骤配置:

# 获取 APP ID 和 APP Key

请先 登录在新窗口打开注册在新窗口打开 LeanCloud 国际版, 进入 控制台在新窗口打开 后点击左下角 创建应用在新窗口打开:

创建应用

创建好应用后,进入刚刚创建的应用,选择左下角的 设置 > 应用Key,然后就能看到你的 APP ID,APP KeyMaster Key 了:

ID 和 Key

提示

我们推荐大家使用 Leancloud 国际版 (leancloud.app在新窗口打开)。如果你确实想用 Leancloud 国内版(leancloud.cn在新窗口打开),除了 APP_ID, APP_KeyMaster Key 之外,你还需要为应用绑定域名

绑定域名: 进入应用后选择 设置 > 域名绑定 > API 访问域名 > 绑定新域名 > 输入需要绑定的已备案域名点击 确定。之后按照页面上的提示去 DNS 上做正确的 CNAME 解析即可。

域名设置

# Vercel 部署

Vercel在新窗口打开

点击上方按钮,跳转至 Vercel 进行快速部署。未登录的话建议选择 GitHub 登录。之后请按要求输入 Vercel 项目名称。

创建项目

输入名称后点击 Continue 进入下一步,输入 GitHub 仓库名称。Vercel 会基于 waline 模板帮助你新建并初始化该仓库。

创建仓库

仓库初始化完毕后,需要在 Environment Variables 中配置 LEAN_ID, LEAN_KEYLEAN_MASTER_KEY 三个环境变量。它们的值分别对应上一步在 LeanCloud 中获得的 APP ID, APP KEY, Master Key。如果你是 LeanCloud 国内版用户的话,还需要输入 LEAN_SERVER 环境变量,对应的是你在上一步上绑定的已备案域名。

设置域名

设置好环境变量后,点击 Deploy 部署。稍等片刻,你会看到满屏的烟花庆祝部署成功。点击 Visit ,即可跳转到部署好的网站地址,该地址即为之后需要填入的 serverURL 地址。

部署成功

# HTML 片段

设置初始化配置中的 serverURL 选项为上面刚刚获取到的二级域名即可(其他可以默认)。

<head>
  ..
  <script src="//cdn.jsdelivr.net/npm/@waline/client/dist/Waline.min.js"></script>
  ...
</head>
<body>
  ...
  <div id="waline"></div>
  <script>
    Waline({
      el: '#waline',
      serverURL: 'https://your-domain.vercel.app',
    });
  </script>
</body>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

# NPM

Waline 已发布到 npm在新窗口打开,可以直接安装:

yarn add -D @waline/client
1
npm i -D @waline/client
1
// Use import
import Waline from '@waline/client';
// or Use require
const Waline = require('@waline/client');

Waline({
  el: '#waline',
  // other config
});
1
2
3
4
5
6
7
8
9

# 评论数据管理

Waline 还带有简单的后台,可以实现对评论的管理。部署完成后,建议立即访问 <serverURL>/ui/register 进行注册,第一个注册的人会被设定成管理员。登陆后,即可看到评论管理界面,建议收藏该地址以便后续使用。