2.5 KiB
2.5 KiB
发布文章生成器 CLI 工具
这是一个专为 WooCommerce 生成草稿发布文章而设计的 CLI 工具。 通过该工具生成的文章将以草稿形式发布到 https://developer.woocommerce.com。
如果您没有 WordPress.com 认证令牌,也可以生成文章的 HTML 表示形式。
设置
- 确保已在 monorepo 中运行
pnpm i。 - 确保已添加包含环境变量的
.env文件。如果使用--outputOnly参数,WCCOM_TOKEN是可选的,但GITHUB_ACCESS_TOKEN是必需的。如需生成令牌的帮助,请参阅文档。要静默所有 CLI 输出,请将LOGGER_LEVEL设置为"silent"。 - 请注意,
.env文件应位于您运行命令的同一路径下。 - 通过 npm 脚本运行工具,例如
pnpm release-post release "6.8.0" --outputOnly - 有关各个选项的更多帮助,请运行帮助命令
pnpm release-post <command> --help。例如pnpm release-post rc --help
发布草稿文章
如果您省略 --outputOnly 标志,此工具将为您将草稿文章发布到 https://developer.woocommerce.com。但这需要一些首次设置:
- 在 WordPress.com 上此处创建一个应用。
- 推荐设置:
- 名称可以是任何内容
- 描述可以留空
- 网站 URL 只需填写
http://localhost - 重定向 URL,默认情况下应添加:
http://localhost:3000/oauth - JavaScript 来源填写
http://localhost - 类型 - 选择 "Web"
- 创建应用后,您可以返回应用列表并点击"管理应用"。
- 记下
client secret和client id。 - 在您的
.env文件中,将客户端密钥添加到WPCOM_OAUTH_CLIENT_SECRET变量,将客户端 ID 添加到WPCOM_OAUTH_CLIENT_ID变量。
仅生成贡献者列表
如果您还没有最终发布版本,可以生成一个 HTML 贡献者列表,以便复制粘贴到空白文章中。
只需运行 pnpm release-post contributors "<currentVersion>" "<previousVersion>" 即可。
高级
如果您无法在本地主机的 3000 端口运行任何程序,可能需要覆盖 OAuth 的重定向 URI。
步骤:
- 在
.env文件的WPCOM_OAUTH_REDIRECT_URI变量中添加您首选的重定向 URI。例如http://localhost:4321/oauth - 在 WordPress.com 上创建应用时,请确保设置的重定向 URL 与
.env中设置的一致。