返回首页 GitHub Pages 指南

用自动生成器生成 Pages

你可以使用 GitHub Pages 自动生成器快速的建立一个项目的网页、用户或组织的网页。

用户和组织 Pages

为了生成用户和组织的网页,你需要生成一个库叫作username.github.io。用户名和组织名必须是你自己的否则你的 GitHub Pages 不会建立的。页面自动生成器是容易通过库的设置页面进入的。你可以从这里阅读更多关于用户和组织页面。

警告: GitHub Pages 在互联网上是公开的可进入的,尽管它们的库是私有的。如果你有一些敏感的数据在你的页面库中,你可能想把它在发布前去除。

项目 Pages

你可以用页面自动生成器给任何项目库去发布 GitHub Pages。

警告:你必须新建一个符合命名规则描述的库,否则你将不能把它发布到你的 GitHub Pages。

页面自动生成器

  1. 在 GitHub 上打开库的页面。
  2. 在你的库右面的侧边栏,点击

  3. 点击 Automatic Page Generator 按钮。
  4. 编辑的的内容在 Markdown 编辑器。
  5. 点击 Continue To Layouts 按钮。
  6. 在主题中预览你的内容。

  7. 当你找到你喜欢的主题,点击 Publish page

在你的 GitHub Pages 生成之后,你可以得到它 HTML 代码的本地复制。如果你生成一个项目网页,fetch 和 check out 一个新的分支。

$ cd repository
$ git fetch origin
remote: Counting objects: 92, done.
remote: Compressing objects: 100% (63/63), done.
remote: Total 68 (delta 41), reused 0 (delta 0)
Unpacking objects: 100% (68/68), done.
From https://github.com/user/repo.git
* [new branch]      gh-pages     -> origin/gh-pages
$git checkout gh-pages
Branch gh-pages set up to track remote branch gh-pages from origin.
Switched to a new branch 'gh-pages'

如果你生成了一个用户网页,代码会在 master 的分支,而不是 gh-pages 的分支,所以仅仅 check out master然后 pull 就可以了。

$cd repository
$git checkout master
Switched to branch 'master'
git pull origin master
remote: Counting objects: 92, done.
remote: Compressing objects: 100% (63/63), done.
remote: Total 68 (delta 41), reused 0 (delta 0)
Receiving objects: 100% (424/424), 329.32 KiB | 178 KiB/s, done.
Resolving deltas: 100% (68/68), done.
From https://github.com/user/repo.git
 * branch      master     -> FETCH_HEAD
Updating abc1234..def5678
Fast-forward
index.html                                     |  265 ++++
...
98 files changed, 18123 insertions(+), 1 deletion(-)
create mode 100644 index.html
...