使用命令行创建项目页面
GitHub 页面 可用于具有 GitHub Free 的公共仓库,以及具有 GitHub Pro、GitHub Team、GitHub Enterprise Cloud 和 GitHub Enterprise Server 的公共和私有仓库。
如果您熟悉命令行 Git,可以直接手动创建项目页面站点。
创建新克隆
要设置项目页面站点,您需要在仓库中创建一个新的“孤立”(与现有分支没有共同历史记录)分支。 最安全的方法是从一个新克隆开始:
$ git clone https://主机名/user/repository.git
# 克隆我们的仓库
> Cloning into 'repository'...
> remote: Counting objects: 2791, done.
> remote: Compressing objects: 100% (1225/1225), done.
> remote: Total 2791 (delta 1722), reused 2513 (delta 1493)
> Receiving objects: 100% (2791/2791), 3.77 MiB | 969 KiB/s, done.
> Resolving deltas: 100% (1722/1722), done.
创建 master
分支
有了清洁的仓库后,您需要创建一个新的 master
分支,除非您克隆的仓库中已有 master
分支。
提示:也可以选择为项目页面站点创建 gh-pages
分支。 有关选项的更多信息,包括从 master
分支上的 /docs
文件夹发布项目页面的选项,请参阅“用户、组织和项目页面”。
- 将目录切换到新克隆的仓库:
$ cd repository
-
检查仓库中是否已存在
master
分支:$ git branch # 显示仓库的分支列表 > * branch-name > * branch-name
-
如果仓库中还没有
master
分支,请创建一个新的master
分支:$ git checkout --orphan master # 创建没有任何父系的 master 分支(它是孤立的!) > Switched to a new branch 'master'
提示:如果您刚创建
master
分支,则在您进行第一次提交之前,当您使用git branch
命令时,它不会出现在分支列表中。
删除所有文件以创建一个空工作目录
有了 master 分支后,您需要删除工作目录和索引中的所有内容:
$ git rm -rf .
# 删除旧工作树中的所有文件
> rm '.gitignore'
添加内容并推送
现在您有一个空工作目录。 您可以在此分支中创建一些内容并将其推送到 您的 GitHub Enterprise Server 实例。 例如:
$ echo "My Page" > index.html
$ git add index.html
$ git commit -a -m "First pages commit"
$ git push origin master
您的 GitHub 页面 站点现在应该可以使用了。 如果在您的实例上启用了出站电子邮件,构建不成功时您会收到一封电子邮件。 有关启用出站电子邮件的更多信息,请联系您的站点管理员。
加载新的 GitHub 页面 站点
推送到 master
分支后,您的项目页面站点可通过 http(s)://[hostname]/pages/<username>/<projectname>/
访问。