如何在 Github 上建立个人主页和项目主页

最近有很多朋友咨询怎样使用 Github 方便免费的页面托管服务,在 Github 上放置自己的网页。由此可分为两种情况:个人主页和项目主页。本文就这托管两种页面的操作方法做简要介绍。

个人主页

  1. 在 Github 上建立仓库 <username>.github.io ,其中 <username> 应为 Github 的帐号用户名。
  2. 已绑定密钥。
  3. 按如下方式上传静态网页文件。
1
2
3
4
5
6
7
8
# 在静态站点目录下
git init
git config user.email "email@address"
git config user.name "name"
git remote add origin [email protected]:<username>/<username>.github.io.git
git add -A
git commit -m "test"
git push origin master

即可访问 https://<username>.github.io

项目主页

  1. 例如已有某项目仓库 test
  2. 已绑定密钥。
  3. 按如下方式上传静态网页文件。
1
2
3
4
5
6
7
8
9
# 在静态站点目录下
git init
git config user.email "email@address"
git config user.name "name"
git remote add origin [email protected]:<username>/test.git
git checkout --orphan gh-pages
git add -A
git commit -m "test"
git push origin gh-pages

即可访问 https://<username>.github.io/test

References

User, Organization, and Project Pages

Adding a remote

手动创建项目 Pages

git 如何清空所有的 commit 记录

orphan 分支

熟悉 Git 和 GitHub

单个 GitHub 帐号下添加多个 GitHub Pages 的相关问题

git 常用命令

Mastodon