1. Github主页搭建前的准备
要搭建Github主页,你需要准备以下材料:
GitHub账号
Git:你需要在计算机上安装Git以便于在Github上进行代码的提交、合并和追踪。
Node.js:Node.js是一个基于Chrome V8引擎的JavaScript运行环境,你需要Node.js,因为Git-hub Pages是证明了HTMl、CSS和JavaScript文件,对于创建一个静态站点来说,Node.js是非常必要的,要在本地计算机上预览网站,也需要Node.js。
代码编辑器:你需要一个代码编辑器来编写网站的HTML,CSS和JavaScript文件。
2. 创建Git-hub仓库
创建一个Github仓库是创建Github Pages网站的第一步,没有仓库就没有在Github上展示的地方。下面是创建仓库的步骤:
2.1. Github账号登录
打开Github的首页 https://github.com ,如果你没有账号,可以先免费注册一个账号,如果你已经有Github账号就可以直接登录。
2.2. 创建仓库
创建仓库分为两种方法:“Create a new repository”和“Import repository”。
Create a new repository
点击 Github 主页右上角的 “+” 按钮,选择 “New repository”,如下图所示:
输入你的仓库名称和简要介绍,选择一个开放的 License,如果你不需要 License,就选择 "Add a license later",最后点击 "Create repository" 按钮。如下图:
Import repository
你可以将你本地电脑中的Git仓库导入到Github中,这一步的操作就不详细介绍了,可以参考Github官方文档。
3. 创建Github Pages网站
3.1. 创建index.html文件
创建一个简单的网站非常容易。只需在仓库的根目录中创建名为 "index.html" 的文件即可。比如,我已经创建了一个名为 “my-github-pages” 仓库,现在可以在本地使用文本编辑器创建一个HTML文件。
touch index.html
在“my-github-pages”仓库中创建一个名为 "index.html" 的空文件。在此文件中添加以下示例HTML代码:
My Github Pages
Hello, Github Pages!
Welcome to my Github Pages
这个简单的HTML页面将显示“Hello, Github Pages!”和“Welcome to my Github Pages”消息。当然你可以完全自定义HTML的内容
3.2. 本地预览Github Pages
通过Github Pages发布一个网站之前,我们可以在本地计算机上验证它。为此,需要使用Node.js来在本地预览您将在Github Pages上托管的网站。下面是预览Github Pages的步骤:
安装http-server
npm install http-server -g
启动http-server
cd /path/to/my-github-pages
http-server . -p 8080
这个命令将在本地计算机上的 “my-github-pages” 目录中启动一个本地http服务。在浏览器中输入“http://localhost:8080”并按Enter键。如果一切正常,您应该可以在浏览器中看到“Hello, Github Pages!”消息。
4. 设置Github Pages
4.1. 打开Github Pages
打开Github上的 “my-github-pages” 仓库,然后点击仓库顶部的 “Setting” 按钮。如下图:
4.2. 配置 Github Pages 选项
在仓库中设置Github Pages的选项有许多选项可以配置,但是最主要的选项包括:
Source:该项用于指定用于与Github Pages托管的网站的文件。在这个选项中,选择“master branch”和“/root”目录。如果你想将网站源码存储在Github Pages仓库中,请选择“master branch /docs folder”。
Theme Chooser (Optional):如果你想要一个基本网站的外观,请使用Github Pages网站模板。
做完上述步骤后,点击 Save 按钮保存设置,并返回仓库主页面。
4.3. 预览Github Pages
你已经将Github Pages的文件提交到了Github上,并设置了Github Pages选项。现在可以在主界面下部的 “Github Pages” 部分看到您的发布状态。若状态显示已发布,那么在浏览器中输入GitHub-User-Name.github.io/my-github-pages 将可以看到刚才创建的网站的内容。例如我的用户名是“qlu8”,那么我的网站URL就是https://qlu8.github.io/my-github-pages。
总结
到这里,你已经搭建完成了一个基本的Github Pages站点。你可以将HTML, CSS 和 JavaScript 文件提交到Github仓库中,所有提交的文件可以通过在浏览器中输入 "GitHub-User-Name.github.io/your-repo-name/" 来访问。
当你提交更改后,网站上的更改也应该随之更新。