如何开启 GitHub Pages,在线预览你的项目


如何开启 GitHub Pages,在线预览你的项目

什么是 GitHub Pages

GitHub Pages 是 GitHub 提供的一项免费静态网站托管服务。你可以将项目中的 HTML、CSS、JavaScript 文件直接托管在 GitHub 上,生成一个可访问的网站。每个 GitHub 账号可以创建一个用户站点,每个项目也可以创建项目站点。

部署要求

部署 GitHub Pages 非常简单,只需要确保你的仓库中有以下文件:

  • index.html:网站的主入口文件,访问时会自动加载此文件(也可以使用 index.md 直接用 Markdown 编写)
  • 其他资源文件如 CSS、JS、图片等可放在同级目录或子文件夹中

GitHub 会自动处理网站的构建和发布,你只需推送代码,无需额外配置服务器。

开始部署

演示用仓库结构如下:

项目根目录/
├── static/
├── LICENSE
├── README.md
└── index.html

进入你的 GitHub 仓库,按照以下步骤开启 GitHub Pages:

开启 pages 页面

  1. 点击仓库顶部的 Settings(设置)选项卡
  2. 滚动到 Pages 页面配置区域
  3. Branch 下,选择你要部署的分支(通常选择 main 或者 master 分支)
  4. 点击 Save 保存设置

等待片刻后,你的网站就会上线。

访问你的网站

部署成功后,你可以通过以下网址访问你的 GitHub Pages 网站:

要访问的网址

网站地址格式为:

  • 用户站点:https://用户名.github.io
  • 项目站点:https://用户名.github.io/仓库名

现在你可以将项目文件推送到 GitHub,访问你的静态网站了!

效果如下:

预览效果


文章作者: 草莓多多
版权声明: 本博客所有文章除特別声明外,均采用 CC BY 4.0 许可协议。转载请注明来源 草莓多多 !
  目录