SuperAPI AI 工具集

github-pages

前端与建站

查看项目

更新于 10-15 21:38

技能介绍

用途:处理 GitHub Pages 静态站点托管相关任务,内容依据官方 GitHub 文档生成。适用场景包括创建或配置 Pages 站点、设置自定义域名、配置发布源(分支、文件夹或 GitHub Actions)、使用 Jekyll 主题与插件、排查部署问题、为站点启用 HTTPS,以及了解 Pages 的功能与限制。

主要能力:区分用户站点(仓库名 <username>.github.io,地址 https://<username>.github.io)、组织站点(<org>.github.io)与项目站点(任意仓库名,地址 https://<username>.github.io/<repo>)。发布源支持分支发布(如 main、gh-pages)、文件夹发布(/ 根目录或 /docs)以及 GitHub Actions 自定义工作流。自定义域名需在仓库根目录添加 CNAME 文件,并配置 DNS:顶级域名添加指向 GitHub IP(185.199.108.153、185.199.109.153、185.199.110.153、185.199.111.153)的 A 记录,子域名添加指向 <username>.github.io 的 CNAME 记录。Jekyll 通过 _config.yml 配置标题、描述、主题与插件。非 Jekyll 站点可添加 .nojekyll 文件禁用处理。官方提供 Jekyll、Next.js、Nuxt.js、Gatsby、Hugo、Astro、Eleventy 等工作流模板。

使用方式:在仓库 Settings > Pages 中选择发布源;分支部署需选择分支与文件夹。自定义 Actions 工作流使用 actions/checkout、actions/upload-pages-artifact、actions/deploy-pages,并设置 contents: read、pages: write、id-token: write 权限。技能内含 references/ 参考文件:getting_started.md、custom_domains.md、jekyll.md、troubleshooting.md,可用 view 读取。

限制:不支持服务端语言(PHP、Ruby、Python);存在仓库大小、带宽与构建时间限制;免费账户使用私有仓库需 GitHub Pro/Team/Enterprise。常见问题包括 404(检查仓库可见性、发布源、index 文件,变更最多需 10 分钟生效)、构建失败(检查 _config.yml 语法与 Gemfile 依赖)、自定义域名不生效(检查 DNS、CNAME 位置与 HTTPS 设置,DNS 传播最长 24 小时)。