Gloria 使用指南

本文章不再更新, 相关内容已被转移至 Gloria 的官方指南: http://docs.gloria.pub

有关 Gloria 的一切都是围绕着任务展开的, 每一个任务包含着它所需要执行的代码, 以及其相应的配置信息, 这样 Gloria 才能知道它应该做些什么. 这篇文章将一步步引导你如何正确的使用 Gloria.

安装 Gloria

在一切开始之前, 你需要安装 Gloria 的 Chrome 扩展程序, Gloria 是专为 Chrome 这一市场占有率最高的现代浏览器而开发的, 如果你使用的是其他浏览器, 则可能需要等待我或是其他人将 Gloria 移植上去.

有以下三种方式可以安装 Gloria.

通过官方网站 Gloria.Pub 上安装

打开 Gloria 的官方网站 https://gloria.pub/, 点击页面上那个醒目的Install Extension按钮, Chrome 将会弹出一个关于安装 Gloria 的确认对话框, 确认它, Gloria 很快就会安装到你的 Chrome.

Gloria 的安装文件大小不到1MB, 通常情况下, 它会很快安装完毕. 安装完毕后, Gloria 会弹出一个安装完毕的通知, 你可以凭此来确定 Gloria 已经安装完毕.

通过 Chrome Web Store 安装

在 Gloria 的官网安装扩展程序毫无疑问是最简便的方式, 但也可能在一些情况下失效, 这时候你需要自己进入 Gloria 在 Chrome Web Store 的页面进行安装.

Gloria 在 Chrome Web Store 的页面是 https://chrome.google.com/webstore/detail/gloria/cnelmenogjgobndnoddckekbojgginbn

像你以往安装其他扩展程序时一样, 点击安装按钮, Gloria 便会安装到你的 Chrome.

通过源码安装

对于一般用户, 你不应该通过这种方法安装 Gloria, 请跳过此节.

在某些特殊情况下, 比如开发人员需要亲自调试 Gloria 的一些新功能的情况下, 我们需要在本地安装扩展程序. 对于熟悉 Github 和 Node.js 的开发人员来说, 这是十分简单的, 在开始运行代码前, 请确认你安装了git, node.js 以及 npm.

首先你需要从本项目在 Github 的代码仓库中 Clone 代码, 在你的终端执行:

git clone https://github.com/BlackGlory/Gloria.git  

然后进入 Gloria 的代码目录, 安装 Gloria 依赖的模块, 并编译 Gloria, 实际上你只需要执行以下3行命令:

cd Gloria  
npm install  
npm run build  

在漫长的等待之后, 你会得到一个 build 目录, 打开 Chrome 的扩展程序页面(chrome://extensions/), 勾选"开发者模式", 点击"加载已解压的扩展程序", 选择刚刚生成的 build 目录, 点击确认, 一切皆已完成.

打开 Gloria 的设定界面

Gloria 的设定界面只有一个, 我们的大部分操作都将在这里完成, 包括新建/修改/删除任务. 有两个方法打开 Gloria 的设定界面.

弹出窗口中的设定界面

在 Chrome 浏览器的地址栏右侧, 有着你安装的扩展程序的图标, 找到 Gloria 的图标并点击它, 设定界面就会弹出.

Chrome 扩展的标准设定界面打开方式

弹出窗口实际上并不是用来打开 Chrome 扩展程序设定界面的标准方法, 只不过我把 Gloria 的弹出窗口载入的内容设置成了和设定界面一样的内容.

标准的进入设定界面的方法, 是右键点击地址栏右侧托盘区的 Gloria 图标, 在弹出的菜单中选择"选项", 此时会打开 chrome://extensions/?options=cnelmenogjgobndnoddckekbojgginbn 页面, 这就是真正的设定界面了. 如果你从扩展程序页面找到 Gloria, 并点击"选项", 也将打开同一个设定界面.

设定界面

设定界面包含了3个面板, 点击对应的图标即可切换, 它们分别是Task, History和Advanced.

Task

Task 是用来存放和展示 Gloria 当前存储的任务代码的地方, 如果你是首次使用 Gloria, 这里还是一片空白, 稍后我们将为 Gloria 添加第一个任务.

History

History 会记录每一个由任务弹出的通知, 如果你忽视了 Gloria 之前弹出的通知, 你可以在这里找到, 为了节省内存和存储空间, History的通知最大记录数量被限制在50个, 旧的通知将被新的通知替代.

Advanced

Advanced 提供一些与任务开发相关的功能, 对于大部分用户而言, 不需要关心这里, 如果你对此有兴趣, 之后有关任务开发的文档会为你介绍 Advanced.

添加第一个 Gloria 任务

添加一个任务非常简单, 切换到 Task 面板, 看到右下角的加号按钮了吗? 点击它.

弹出的对话框会要求你输入此任务的代码, 作为教程, 我们输入以下代码:

commit({ message: `Hello, it is ${new Date()}.` })  

点击Next, 对话框会要求你输入该任务的名称, 我们输入Hello, 再点击下一步.

新的对话框看起来有点复杂, 但实际上只有2项内容可以设置:

第一项是Trigger interval, 它是一个滑块, 通过左右滑动你可以为当前新建的任务设置其触发的间隔时间, 单位是分钟. 为了更快的看到效果, 请把它调整至1分钟.

第二项是Notice need an interaction, 它是一个复选框, 勾选此项意味着你当前新建的这个任务弹出的所有通知提醒都不会自动消失, 只有当你与通知产生交互后才会消失, 对于一些很重要的任务, 我建议你勾选此项, 对于不那么重要的任务, 勾选此项会让你心烦意乱.

最后点击Finish, 我们的第一个任务便添加完毕了.

等待1分钟左右, 会有一个有关此任务的通知弹出, 切换到 History 面板也可以找到它.

每当任务被调用, 它的Triggered计数都会增加1, 如果这次调用造成了新的通知, 那么Pushed计数也会增加1.

安装来自 Gloria.Pub 的任务

安装来自 Gloria.Pub 是非常简单的, 你只需要打开 Gloria.Pub, 输入关键字, 查找你想要安装的任务.

在任务的代码页面点击页面上的 Install 按钮, 任务就会自动被安装进 Gloria, 默认的Trigger interval是5分钟, Notice need an interaction是不勾选的, 你可以进入选项界面找到新安装的任务.

修改任务

并不是所有任务都需要实时启动着, 你可以在 Task 面板里找到你想要开启/关闭的任务, 点击右侧的滑块按钮, 决定是否启用此任务.

在 Task 面板点击任务后, 会在下方展开详细设置的面板, 其中包括了你熟悉的Trigger interval和Notice need an interaction选项, 如果该任务是从 Gloria.Pub 安装的, 那么还会包含该任务在 Gloria.Pub 的任务页面, 你可以随时点击进入 Gloria.Pub 跟进更新和反馈. 位于右侧的是"编辑"和"删除"按钮.

点击"编辑“后会出现与添加任务时类似的对话框, 点击"删除"则会弹出对话框询问你是否真的要删除任务, 确认后任务就会被永久删除.

至此, 就是目前作为用户所需要了解的有关 Gloria.Pub 的一切.


对于想要开发任务的用户, 下一篇文章将说明如何编写 Gloria.Pub 任务代码.