部署按钮
本小节将介绍如何在 GitHub 仓库中添加一键部署按钮，让用户能够快速将您的模板部署到 EdgeOne Pages。
部署按钮
Pages 部署按钮如下所示：
当用户点击此按钮时，他们将被引导至 Pages，并预先配置您的仓库作为部署源。
如何添加部署按钮
将以下 markdown 代码添加到您仓库的 README.md 文件中：
[](https://edgeone.ai/pages/new?repository-url=YOUR_REPO_URL)
将
YOUR_REPO_URL 替换为您的 GitHub 仓库 URL，支持子路径。例如：[](https://edgeone.ai/pages/new?repository-url=https%3A%2F%2Fgithub.com%2FTencentEdgeOne%2Fpages-templates%2Ftree%2Fmain%2Fexamples%2Fvue-template)
URL Search 参数
部署按钮 URL 支持以下 Search 参数：
Search 参数名称 | 描述 |
template | 通过 Pages 官方模板来部署的模板名称 |
repository-name | Github 仓库名称 |
repository-url | 通过其他 GitHub 仓库来部署的仓库地址 |
project-name | 项目名称 |
build-command | 构建命令 |
install-command | 安装命令 |
output-directory | 构建后产物的输出目录 |
root-directory | 构建根目录 |
env | 仓库必要的环境变量，如需多个可用英文逗号连接，如：KEY1,KEY2,KEY3 |
env-description | 跟环境变量相关的描述 |
env-link | 跟环境变量相关的链接 |
注意：
参数值需使用
encodeURIComponent() 编码后再拼接进 URL，如 build-command=npm%20run%20build
示例
对于公共 GitHub 仓库：
[](https://edgeone.ai/pages/new?repository-url=https%3A%2F%2Fgithub.com%2Fusername%2Frepository)
对于特定分支：
[](https://edgeone.ai/pages/new?repository-url=https%3A%2F%2Fgithub.com%2Fusername%2Frepository%2Ftree%2Fbranch-name)
如何使用 URL Search 参数：
[](https://edgeone.ai/pages/new?repository-url=https%3A%2F%2Fgithub.com%2FTencentEdgeOne%2Fpages-templates%2Ftree%2Fmain%2Fexamples%2Fvue-template&output-directory=.%2Fdist&install-command=npm%20install&build-command=npm%20run%20build)
用户体验
当用户点击部署按钮时：
1. 页面将被重定向到 Pages 控制台
2. GitHub 仓库将被作为默认的部署源
3. 支持调整项目的配置项
4. 点击“立即创建”后，项目就会被部署至 Pages
这为想要快速尝试或部署您模板的用户提供了无缝的体验。
更多配置
参考 edgeone.json 文档，您可以自定义项目的构建命令(buildCommand)、依赖安装命令(installCommand) 以及输出目录(outputDirectory)。建议根据项目实际情况配置这些参数，以确保其他人能够正确构建和部署您的项目。