1. 简介
publish-workflowy 是一个 npm 包，可以将 Workflowy 中的文本转换为 html，并发布到指定的站点。它是基于 puppeteer 控制 Chrome 浏览器进行操作的，因此可以完美地模拟用户在 web 页面的操作。
2. 安装与配置
使用 publish-workflowy 需要 node 8 及以上的版本。可以通过以下命令安装：
npm install -g publish-workflowy
安装完成后，需要进行一些配置工作才能正确地运行 publish-workflowy。
2.1 Workflowy 配置
首先需要为 Workflowy 账号生成一个 API 令牌，用于登录使用。具体操作如下：
- 打开 Workflowy Developer Page，点击 "Create a New API Key"。
- 在弹出的对话框中，输入应用名称，比如 "Publish Workflowy"，点击 "Create Application"。
- 在页面中会显示应用的信息，包括 Client ID 和 Client Secret。接下来需要点击 "Generate Access Token"，生成一个访问令牌，用于登录。
- 将生成的 Access Token 记下来，备用。
2.2 配置文件
接下来需要配置 publish-workflowy 的配置文件，使其正确地使用生成的 Access Token 登录 workflowy。
首先需要创建一个配置文件，文件名为 .pwrclirc.json，具体配置如下：
{
"workflowyAccessToken": "<access-token>"
}将 <access-token> 替换为之前生成的 Access Token 即可。
配置文件需要放置在用户的 HOME 目录下，比如：
- Windows:
C:\Users\<username>\.pwrclirc.json - Linux/MacOS:
/home/<username>/.pwrclirc.json
同时，还需要在 workflowy 中创建一个标签，用于 publish-workflowy 识别需要发布的内容。比如可以创建一个名为 "Publish" 的标签。
3. 使用示例
接下来通过一个简单的示例来演示 publish-workflowy 的使用方法。
假设我们在 Workflowy 中创建一个文本：
# My Awesome Blog Post - This is the first paragraph of my blog post - This is the second paragraph of my blog post
将这个文本标记为 "Publish"，保存后，即可使用 publish-workflowy 将其发布到我们的博客网站上。
3.1 首次使用
在命令行中执行以下命令：
pwrcli login
会出现一个浏览器窗口，需要使用 Workflowy 账号登录，登录成功后，再次回到命令行，即可开始发布文章。
3.2 发布文章
在命令行中执行以下命令：
pwrcli publish
这将会扫描 workflowy 中所有标记为 "Publish" 的文本，生成对应的 html 文件，并上传到指定的站点上。
3.3 配置站点
在 ~/.pwrclirc.json 文件中，添加 publish.site 字段，设置站点地址和登录信息。
{
"publish.site": {
"url": "http://example.com/wp-json/wp/v2",
"username": "admin",
"password": "adminpw"
}
}其中 url 是 WordPress rest api 地址，username 和 password 则是登录信息。
发布文章时，使用以下命令：
pwrcli publish --site example.com
即可将发布的文章上传到指定的站点上。
4. 总结
通过 publish-workflowy，我们可以轻松地将 Workflowy 中的文本转换为 html，并发布到指定的站点上。同时，它也为我们提供了一个自动化的方案，可以节省大量的时间和精力。
需要注意的是，使用 publish-workflowy 需要认真配置和使用，否则会导致数据泄露和安全问题。在使用时，请务必保证自己的账号和密码的安全性。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/600671d030d0927023822977