使用 jekyll 和 github 页面构建静态站点时可用的变量

Question

在使用 github pages 和 jekyll 构建网站时，我们可以使用 site.github.repository_name 等变量。这些变量值由 github pages 在构建站点时提供。但我无法在 github 页面的文档或 jekyll 文档中关于 github 页面的页面中找到这些变量的完整列表。

我已经签到了

• https://jekyllrb.com/docs/github-pages/
• https://jekyllrb.com/docs/variables/
• https://docs.github.com/en/free-pro-team@latest/github/working-with-github-pages/about-github-pages-and-jekyll

Answer 1

GitHub Pages 使用一些默认启用且无法禁用的插件。其中之一是jekyll-github-metadata。

如描述中所述：

• 使用repository metadata 传播site.github 命名空间
• 将site.title 设置为存储库名称（如果未设置）
• 将site.description 设置为存储库标语（如果未设置）
• 如果未设置，则将 site.url 设置为 GitHub Pages 域（cname 或用户域）
• 将site.baseurl 设置为项目页面的项目名称（如果未设置）

site.github.repository_name 来自上述存储库元数据，还有site.github.wiki_url 和许多其他内容。