GitHub使用用户名与不使用用户名（通过gh-pages分支）创建个人主页的方法

Asakura Taka

已于 2023-05-07 10:12:12 修改

阅读量2.1k

点赞数 2

文章标签： github git html 前端 php

于 2023-05-07 10:11:42 首次发布

本文链接：https://blog.csdn.net/m0_62545037/article/details/130539174

版权

GitHub不使用用户名创建个人主页的方法（gh-pages分支）

概览

教程

User/Organization Pages

Project Pages

GitHub使用用户名创建个人主页的方法

概览

创建新仓库：登录GitHub账号，然后点击页面右上角的加号“+”，选择“New repository”创建一个新的仓库。
命名仓库：在“Repository name”文本框中输入您的GitHub账号名，然后在后面添加“.github.io”，例如，如果您的GitHub账号名为“example”，则应该将仓库名设置为“example.github.io”。
设置仓库为公共：在“Visibility”选项下，选择“Public”以确保您的个人主页可以被公开访问。
初始化仓库：如果您不打算将已有的代码上传到该仓库，请选择“Initialize this repository with a README”选项。
上传主页文件：在您的计算机上创建一个名为“index.html”的文件，并将其上传到您刚才创建的仓库中。您可以使用Git命令行工具或GitHub的桌面应用程序来完成此任务。
访问个人主页：等待几分钟，然后访问“https://yourusername.github.io“，其中“yourusername”应该是您的GitHub账号名。您应该能够看到您的个人主页。

详细步骤

参考文献：使用Github创建个人主页

申请GitHub账号

（如果有账号请直接登录然后跳转到教程下一步）

访问Github，点击SIGN UP（注册）按钮。由于GitHub是全英文网站，所以推荐可以在油猴脚本中搜索”GitHub汉化插件“下载并安装。

注册只需要用户名，密码，邮箱即可。用户名用一个酷一点或者有意义一点的，因为稍后，它会出现在你的网址中。

注册时选择社区版（community）即可，接下来的个性化设置中选择最下方的”跳过“。

创建一个仓库

点击页面右上角的加号“+”，选择“New repository”创建一个新的仓库。

点击右上角的加号创建仓库

仓库的名字不可以随便写，必须是 <username>.github.io，比如我注册的名字是 zhihu1，所以这里我创建的仓库的名字必须是： http://zhihu1.github.io

创建仓库的过程

上传主页文件：在您的计算机上创建一个名为“index.html”的文件，并将其上传到您刚才创建的仓库中。您可以使用Git命令行工具或GitHub的桌面应用程序来完成此任务。具体来说，可以在git cmd中使用cd指令进入到你要上传"index.html”文件所在的目录后使用下述指令：

1. 首先，进入您要上传文件的本地目录，使用以下命令将文件添加到Git仓库中：

git add .

该命令将当前目录下所有的文件添加到Git仓库中，包括新添加的“index.html”文件。如果您只想添加单个文件，可以使用以下命令：

git add index.html

2. 接下来，使用以下命令将添加的文件提交到本地Git仓库中：

git commit -m "添加了个人主页文件"

在引号中输入您想要作为提交消息的文本，例如“添加了个人主页文件”。

3. 接下来，使用以下命令将添加的文件提交到本地Git仓库中：

git push origin master

这将把本地Git仓库中的所有更改推送到名为“master”的远程分支。如果您在GitHub仓库中使用的是不同的分支，则需要相应地更改该命令。

如果你不会使用Git命令行工具，你可以按照以下步骤进行：

新建一个文件

命名为index.html，并写入内容

index.html中需要使用html语言编写网页，学习的时候可以先参考笔者写的一个简单的代码

<p>Hello 大家好</p>
<p>我是霸都丶傲天，这是我的个人网站。 </p>
<p>很高兴你来到这里, 你可以在以下的网站找到我</p>

<ul>
  <li> <a href="https://www.zhihu.com/people/AJLoveChina">知乎</a> </li>
  <li> <a href="http://hejie.nigeerhuo.com">我的博客(已经不更细了,现在在知乎写文章)</a> </li>
</ul>

完成这些步骤后，您的个人主页文件应该已经上传到GitHub仓库中。等待几分钟后，您就可以在浏览器中访问“https://username.github.io”来查看您的个人主页了。

GitHub不使用用户名创建个人主页的方法（gh-pages分支）

概览

请注意，该方法需要使用Git命令行，并不适用于小白。

首先我们需要知道一个规则：

GitHub要求用户站点的repository必须以<user>.github.io的格式命名，其中<user>是您的GitHub用户名。这个repository必须归您的帐户所有，并且必须公开才能发布用户站点。

如果您想要发布组织站点，也可以按照相同的规则创建一个名为<organization>.github.io的repository，其中<organization>是您组织的名称。

请注意，只有名为<user>.github.io或<organization>.github.io的repository才能用于发布用户或组织站点。其他任何名称的repository都不能用于此目的。如果您尝试使用类似joe/bob.github.io这样的存储库进行站点构建，则无法正常工作。

因此，如果想要使用其他任何名称的repository进行站点构建，则需要使用GitHub Pages的另一种构建方式——User/Organization Pages或Project Pages。

对于User/Organization Pages，我们可以在一个名为gh-pages的分支上构建站点，并将该分支推送到我们的repository中。然后便可以通过访问<user>.github.io/<repository>来访问我们的站点，其中<user>是我们的GitHub用户名，<repository>是我们的repository名称。

对于Project Pages，需要在repository中创建一个名为gh-pages的分支，然后将站点构建文件推送到该分支中。我们可以通过访问<user>.github.io/<repository>或<organization>.github.io/<repository>来访问站点，具体取决于我们的repository是属于个人还是组织。

教程

以下是使用User/Organization Pages和Project Pages构建GitHub Pages站点的详细步骤。

User/Organization Pages

步骤1：创建repository

首先，您需要在GitHub上创建一个新的repository，并将其命名为您想要的名称。注意，名称不需要遵循<user>.github.io的格式，因为您将在gh-pages分支上构建站点。

步骤2：创建gh-pages分支

接下来，您需要在该repository中创建一个名为gh-pages的分支。此分支将用于构建和部署站点。

可以通过以下方式在命令行中创建分支：

git clone https://github.com/<username>/<repository>.git
cd <repository>
git checkout --orphan gh-pages

步骤3：构建站点

在gh-pages分支上，您需要添加一个名为index.html的文件，它将是您站点的主页。

您还可以添加其他静态文件（如CSS，JavaScript和图像），以创建完整的站点。请注意，由于GitHub Pages仅支持静态站点，因此不能在站点上添加后端代码或动态内容。

步骤4：推送更改

当您完成站点构建时，您需要将更改推送到gh-pages分支，以便将站点发布到GitHub Pages。您可以使用以下命令将更改推送到gh-pages分支：

git add --all
git commit -m "Initial commit"
git push origin gh-pages

请注意，您必须将更改推送到gh-pages分支，而不是master或其他任何分支。否则，您的站点将无法发布到GitHub Pages。

步骤5：查看站点

完成上述步骤后，您的站点将已经在GitHub Pages上发布。您可以通过访问https://<username>.github.io/<repository>来查看站点，其中<username>是您的GitHub用户名，<repository>是您的repository名称。

Project Pages

步骤1：创建repository

首先，您需要在GitHub上创建一个新的repository，并将其命名为您想要的名称。如果您要创建个人站点，请将repository命名为<username>.github.io。如果您要创建组织站点，请将repository命名为<organization>.github.io。

步骤2：创建站点文件

接下来，您需要在该repository的主分支（通常是master）中添加一个名为index.html的文件，它将是您站点的主页。

步骤3：启用GitHub Pages

要启用GitHub Pages，请执行以下操作：

在repository中，单击页面顶部的“Settings”
在“Options”下拉菜单中，选择“GitHub Pages”
在“Source”下拉菜单中，选择“master branch”
单击“Save”按钮
在页面顶部显示的绿色框中，您将看到您的站点的URL。请注意，它可能需要几分钟才能更新，以反映您的更改。

步骤4：查看站点

完成上述步骤后，您的站点将已经在GitHub Pages上发布。您可以通过访问站点URL来查看站点，该URL将是https://<username>.github.io/<repository>，其中<username>是您的GitHub用户名，<repository>是您的repository名称。

请注意，如果您的repository名称是<username>.github.io（对于个人站点）或<organization>.github.io（对于组织站点），则可以省略<repository>部分，例如https://<username>.github.io/或https://<organization>.github.io/。