GitHub Pages 设置详解

什么是 GitHub Pages

GitHub Pages 是 GitHub 提供的一项服务，可以让用户将静态网页托管在 GitHub 的服务器上。无论是个人网站、项目展示还是文档，都可以通过 GitHub Pages 实现。

GitHub Pages 的特点

• 免费托管：无须支付任何费用，提供高可用性。
• 易于使用：只需将代码推送到特定的分支，即可自动发布。
• 支持自定义域名：可以将自定义域名指向 GitHub Pages。
• 支持 Jekyll：可以直接在 GitHub 上使用 Jekyll 生成静态网站。

如何设置 GitHub Pages

第一步：创建 GitHub 存储库

1. 登录到您的 GitHub 账号。
2. 点击右上角的 + 号，选择 New repository。
3. 输入存储库名称，建议使用 username.github.io 形式。
4. 选择 Public（公开）或 Private（私有）选项，通常选择公开。
5. 点击 Create repository 按钮。

第二步：添加 HTML 文件

1. 在存储库主页，点击 Add file，选择 Create new file。

2. 输入文件名为 index.html。

3. 在文本框中输入简单的 HTML 代码，例如： html

第三步：启用 GitHub Pages

1. 在存储库主页，点击 Settings 标签。
2. 向下滚动至 GitHub Pages 部分。
3. 在 Source 下拉菜单中，选择 main 或 master 分支，点击 Save。
4. 页面将刷新，您会看到生成的链接，通常为 https://username.github.io/。

第四步：访问您的页面

• 打开浏览器，访问 https://username.github.io/，您应该能看到刚刚创建的网页。

自定义域名

如果您希望使用自定义域名，可以按照以下步骤设置：

1. 购买域名：在任何域名注册商处购买一个域名。
2. 添加 CNAME 文件：在存储库中创建一个名为 CNAME 的文件，文件中仅包含您的域名，例如 www.example.com。
3. 配置 DNS 记录：在域名注册商的 DNS 管理页面，添加 CNAME 记录，指向 username.github.io。
4. 等待生效：DNS 更改可能需要一些时间才能生效，通常是几小时到48小时不等。

使用 Jekyll 生成网站

GitHub Pages 支持 Jekyll，这是一个静态网站生成器，可以帮助您快速构建网站。

安装 Jekyll

在本地安装 Jekyll，确保您的机器上已经安装 Ruby。

1. 使用以下命令安装 Jekyll： bash gem install jekyll bundler

2. 创建新的 Jekyll 网站： bash jekyll new mysite cd mysite

3. 将生成的网站文件推送到您的 GitHub 存储库。

FAQ

如何设置 GitHub Pages？

• 您只需创建一个存储库，并在设置中启用 GitHub Pages，推送 HTML 文件即可。

GitHub Pages 支持哪些文件格式？

• GitHub Pages 支持 HTML、CSS、JavaScript 以及静态文件，如图片等。

如何更改 GitHub Pages 的主题？

• 在 Jekyll 网站中，您可以在 _config.yml 文件中更改主题设置，GitHub Pages 提供了一些预设主题供您选择。

使用 GitHub Pages 是否收费？

• GitHub Pages 是免费的，您无需为网站托管支付费用。

GitHub Pages 能否用于商业网站？

• 可以，但需遵守 GitHub 的服务条款，建议将其用于个人项目和展示。

结论

设置 GitHub Pages 是一个简单而有效的方法，适合个人开发者和项目团队。通过上面的步骤，您可以快速创建和部署自己的网页。在使用过程中，如果遇到任何问题，请查阅 GitHub 官方文档或相关社区。