GitHub Pages托管启用方法

GitHub Pages托管启用方法
余亦雾中人1. 准备工作
确保你已经有一个 GitHub 账号。如果没有,可以前往 GitHub官网 注册一个免费账号。
2. 创建新的 GitHub 仓库
- 登录你的 GitHub 账号后,点击页面右上角的 “+” 按钮,然后选择 “New repository”。
- 输入你的仓库名称,描述是可选的。
- 选择公开(Public)或私人(Private)。注意,GitHub Pages 对于公共仓库是免费的,对于私人仓库,你需要有 GitHub 的高级账户(即需要花钱)。
- 点击 “Create repository”。
3. 上传项目文件
将你的 HTML、JavaScript 和 WebAssembly 文件上传到这个新的仓库中。
- 你可以通过 Git 命令行工具将文件推送到仓库:
- 克隆你的仓库到本地:
1
git clone https://github.com/your-username/your-repository.git
- 将你的项目文件复制到本地仓库目录中。
- 使用 Git 命令将文件添加并提交:
1
2
3
4cd your-repository
git add .
git commit -m "Initial commit"
git push origin main
- 克隆你的仓库到本地:
- 或者,你可以直接在 GitHub 网页界面上上传文件:
- 进入你的仓库页面。
- 点击 “Add file” 按钮,然后选择 “Upload files”。
- 拖拽你的文件到上传区域或点击选择文件上传。
4. 启用 GitHub Pages
- 在你的仓库页面,点击 “Settings”。
- 在左侧菜单中找到 “Pages”。
- 在 “Source” 部分,选择你想要用来托管站点的分支(通常是
main
或master
)。然后选择/root
文件夹作为站点的根目录。 - 点击 “Save” 按钮。
GitHub 会自动为你生成一个 URL,你可以在同一页面的顶部看到一个绿色的消息,其中包含站点的 URL。通常格式为 https://username.github.io/repository-name/
。
5. 测试和分享
- 点击提供的 URL,测试你的页面是否正常加载。如果遇到问题,请确保所有文件正确上传,并且你的 HTML 和其他资源路径设置正确。
- 你可以将这个 URL 分享给任何人,他们可以直接通过这个链接访问你的项目。
注意事项
- 自定义域名:如果你有自己的域名,你可以在 GitHub Pages 的设置中配置它,以替代默认的
github.io
域名。 - 安全和隐私:如果你的项目包含敏感信息,注意设置仓库为私人并使用适当的访问控制。
- 资源路径:确保你的 HTML 文件中的资源路径(如 CSS, JS, 图像等)是相对路径,或使用绝对路径,否则在不同的 URL 路径下可能找不到这些资源。