能否在GitHub Pages中为Web应用用户指南的链接设置域名根？

问题场景 #

我在Web应用的代码仓库中，使用GitHub Pages搭建应用的用户指南。希望给指南添加指向Web应用对应页面的链接，但不想硬编码完整URL，而是通过一处配置应用域名，让所有URL都引用这个域名。例如先定义ROOT_DOMAIN=MyApp.com，之后在Markdown里用[Login](%ROOT_DOMAIN%/account/login)这样的写法，询问是否有可行的实现方法。

可行解决方案 #

方案1：利用GitHub Pages原生支持的Jekyll变量 #

GitHub Pages默认支持Jekyll静态站点生成，可直接用其变量功能实现：

• 在仓库根目录创建_config.yml文件，添加配置：

  root_domain: "MyApp.com"
  

• 在Markdown文件中使用Jekyll的变量语法引用：

  [Login]({{ site.root_domain }}/account/login)
  

• 提交代码后，GitHub Pages会自动构建并替换变量为实际域名。

方案2：通过GitHub Actions做预处理 #

如果不想使用Jekyll，可以借助GitHub Actions编写脚本替换占位符：

• 在仓库中创建配置文件（比如.env），定义域名：

  ROOT_DOMAIN=MyApp.com
  

• 编写脚本（如Shell或Python脚本），读取配置中的域名，遍历所有Markdown文件，将%ROOT_DOMAIN%替换为实际域名
• 在.github/workflows目录下创建GitHub Actions工作流文件，设置流程：先运行替换脚本，再将处理后的文件部署到GitHub Pages

方案3：本地预处理后提交 #

适合不想依赖CI/CD的场景，本地完成变量替换后再提交代码：

• 定义域名配置文件，编写本地替换脚本（如Python的字符串替换脚本）
• 每次修改Markdown内容后，运行脚本替换所有%ROOT_DOMAIN%占位符
• 将处理后的最终Markdown文件提交到仓库，直接由GitHub Pages部署

内容的提问来源于stack exchange，提问作者David Thielen