Now-subconverter 使用指南

原文地址 blogsue.vercel.app

生成一个 repo 权限的 github token。具体步骤见官方文档，其中第 7 步只勾选第一个钩 (repo)，保存好生成的 token 待用。

生成一个 repo 权限的 github token。具体步骤见官方文档，其中第 7 步只勾选第一个钩 (repo)，保存好生成的 token 待用。

纯傻瓜式搭建

点击即可，一路无脑选择下一步，等待部署成功。

在 github 上 fork 我的 now-subconverter 项目 2. 在 github 上 fork 一个你喜欢的 subconverter 前端项目，此处推荐 sub-web，其常见的修改版有 leosam2048。不过为满足需要，仅以我修改的版本为例，在 sub-web 提交修改后会自动推送修改给你预设的 now-subconverter 仓库。

github action 可视为 github 提供的自动化服务，可以自行设置触发事件，然后执行你需要的操作 (例如编译版本 / 自动关闭 issue)。

对以上 fork 的项目做以下操作： 1. 点击你的仓库右上角的 Settings，打开 Actions 这一项，Actions permissions 中勾选 Allow all actions

如果 fork 了我的 sub-web 项目还需要对你 fork 的 sub-web 仓库做以下操作： 1. 点击你的仓库右上角的 Settings，找到 Secrets 这一项，添加一个名为 REPO_TOKEN 的变量，值是有 repo 权限的 github token (预先准备中获得的)

详细见 /.github/workflows/ 下的 main.yml 中 env 下各参数的注释 env 下为自动触发时默认使用的设置 workflow_dispatch 中各参数的 default 一项为手动触发时使用的默认设置，手动触发时还可以自定义设置

提交说明的内容

从何处更新 subconverter

可选值	含义
release	从 release 中下载稳定版本，可用下面的 tag 参数指定版本
action	从最新代码所关联 github action 的 Artifacts 里下载已经编译好的
build	拉取最新代码自己编译

当 branch 参数设置为 release 时，这个参数指定下载的版本设置为 latest 时，自动选择最新版本 release

自定义配置文件的方法 不建议直接修改subconverter/ 内的 pref.ini 等配置文件，因为会在更新后端（subconverter）时被全新的文件覆盖，配置就丢失了。

可选值	含义
sed	在 Modify pref.ini by sed 步骤中，用 sed 命令修改配置文件
files	使用本项目中 /files 文件夹中的文件覆盖

/.github/workflows/ 下的 main.yml 中的步骤 Modify pref.ini by sed 使用 sed 命令修改 subconverter 的默认配置 pref.ini 的方法仿照此示例即可

编辑 /.github/workflows/sub-web.yml 文件中的 25 行，修改为你的 sub-web 项目；51 行的 commit 信息可以自定义修改。

修改 /.github/workflows/build.yml 中的 39 行，其中的链接为.../zhongfly/now-subconverter/... 即我的 now-subconverter 项目，请修改成你的项目地址.
自定义修改 sub-web 项目满足你的个人需要，请参考 sub-web 的 readme.md，此处不过多介绍。当在你的 sub-web 项目中提交修改后，会自动触发你的 now-subconverter 项目更新其中的 sub-web 文件