我们经常发布文档更新,此页面的翻译可能仍在进行中。有关最新信息,请访问英文文档。如果此页面上的翻译有问题,请告诉我们
文章版本: GitHub.com

使用命令行创建项目页面

GitHub 页面 可用于具有 GitHub Free 的公共仓库,以及具有 GitHub Pro、GitHub Team、GitHub Enterprise Cloud 和 GitHub Enterprise Server 的公共和私有仓库。更多信息请参阅“GitHub 的产品。”

如果您熟悉命令行 Git,可以直接手动创建项目页面站点。

创建新克隆

要设置项目页面站点,您需要在仓库中创建一个新的“孤立”(与现有分支没有共同历史记录)分支。 最安全的方法是从一个新克隆开始:

$ git clone https://github.com/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 文件夹发布项目页面的选项,请参阅“用户、组织和项目页面”。

  1. 将目录切换到新克隆的仓库:
$ cd repository
  1. 检查仓库中是否已存在 master 分支:

    $ git branch
    # 显示仓库的分支列表
    > * branch-name
    > * branch-name
  2. 如果仓库中还没有 master 分支,请创建一个新的 master 分支:

    $ git checkout --orphan master
    # 创建没有任何父系的 master 分支(它是孤立的!)
    > Switched to a new branch 'master'

    提示:如果您刚创建 master 分支,则在您进行第一次提交之前,当您使用 git branch 命令时,它不会出现在分支列表中。

删除所有文件以创建一个空工作目录

有了 master 分支后,您需要删除工作目录和索引中的所有内容:

$ git rm -rf .
# 删除旧工作树中的所有文件
> rm '.gitignore'

添加内容并推送

要在推送到页面仓库时触发构建流程,必须先验证您的电子邮件地址

现在您有一个空工作目录。 您可以在此分支中创建一些内容并将其推送到 GitHub。 例如:

$ 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)://<username>.github.io/<projectname>访问。 GitHub 页面 站点一经发布,始终向公众开放,即使其仓库是私有仓库。

要设置 GitHub 页面 站点的自定义域,请参阅“使用 GitHub 页面 设置自定义域”。

问问别人

找不到要找的内容?

联系我们