在 Github 上构建 Jekyll 时,使用的是 Github Pages 环境,而本地则使用本地计算机的环境。确保你的本地 Jekyll 版本和 Github Pages 版本相同,并安装相同的插件和依赖项。你可以查看 Github Pages 环境中安装的 Jekyll 版本和插件的列表,以便检查本地版本是否与之相同。
Github Pages 有一些预定义的环境变量,你需要在你的代码中使用它们来正确地构建你的站点。特别是,在 Github Actions 中构建时,你应该使用此关键字:{{ site.github.repository_name }}
来动态设置站点的基本 URL。
一些 Github 构建错误可能是因为文件编码格式不正确。确保文件编码符合 UTF-8 标准,并使用正确的换行符号(由于 Windows 和 Unix 使用不同的换行符号,这可能导致构建失败)。
示例代码:
下面是设置 Github Pages 基本 URL 的示例代码:
baseurl: "{{ site.github.repository_name }}"
如果你的站点的配置文件有一个 baseurl
键,则可以使用此代码来动态设置基本 URL,而不必在每个页面或链接中手动设置。