为站点创建存储库
如果站点是一个独立的项目,您可以创建新仓库来存储站点源代码。 如果站点与现有项目关联, 您可以将站点的源代码添加到该项目仓库中的 gh-pages
分支或 master
分支上的 docs
文件夹。 例如,如果您创建站点来发布已经在 GitHub 上的项目文档, 您可能想要将站点的源代码存储在与项目相同的仓库中。
如果要在现有仓库中创建站点,请跳至 创建您的站点 一节。
1.在任何页面的右上角,使用 下拉菜单选择 New repository(新建仓库)。
2.使用 Owner(所有者)下拉菜单选择你想要拥有仓库的帐户。
3.输入仓库的名称和说明(可选)。 如果您创建的是用户或组织站点,仓库名称必须为 <user>.github.io
或 <organization>.github.io
。 更多信息请参阅“关于 GitHub Pages”。
4.选择仓库可见性。 更多信息请参阅“关于仓库可见性”。
5.选择 Initialize this repository with a README(使用自述文件初始化此仓库)。
6.单击 Create repository(创建仓库)。
创建您的站点
- 在GitHub上,导航到站点的存储库。
- 如果要创建项目站点,请决定要使用哪个发布源。如果要创建用户或组织网站,则必须将站点的源代码存储在
master
分支。有关更多信息,请参见“关于GitHub页面." - 如果您选择的发布源已经存在,请导航到发布源。如果所选发布源不存在,则创建发布源。
- 在发布源的根目录中,创建一个名为
index.md
它包含要在网站主页上显示的内容。 - 如果要为项目站点使用非默认发布源,请配置发布源。有关更多信息,请参见“为GitHub页面站点配置发布源."
- 在您的存储库名称下,单击 设置.
若要查看已发布的网站,请在“GitHub页面”下单击站点的URL。