使用自动生成器创建页面
您可以使用 GitHub Enterprise 的自动页面生成器为项目、用户或组织快速创建单页面网站。
自动页面生成器设计用于创建单页面网站。 如果您想构建多页面网站,我们建议您使用 Jekyll。 要将多个页面添加到您的自动页面生成器站点,作为一种变通方法,您可以尝试复制仓库根目录中的 index.html
文件,然后将其编辑为其他网页的模板。 这种变通方法需要比较熟悉 HTML。
注:如果您将 GitHub Pages 发布来源设置为从 /docs master branch
(master 分支上的 /docs
文件夹)发布站点,则自动页面生成器将被禁用。 更多信息请参阅“配置 GitHub Pages 的发布来源”。
用户和组织页面
要生成用户和组织页面站点,您需要创建名为 <username>.[hostname]
的仓库。 用户名或组织名称必须归您所有,否则您的 GitHub 页面 站点将无法构建。 自动页面生成器可通过仓库的 Settings(设置)页面访问。 您可以阅读有关用户和组织页面的更多信息。
项目页面
您可以使用自动页面生成器为任何项目仓库发布 GitHub 页面 站点。
警告:您必须使用上述命名规范创建仓库,否则您将无法发布 GitHub 页面 站点。
自动页面生成器
-
在 GitHub Enterprise 上,导航到仓库的主页面。
-
在仓库名称下,单击 Settings(设置)。
-
单击 Automatic Page Generator(自动页面生成器)按钮。
-
在 Markdown 编辑器中创作内容。
-
单击 Continue To Layouts(继续布局)按钮。
-
在我们的主题中预览您的内容。
-
找到您喜欢的主题后,单击 Publish page(发布页面)。
生成 GitHub 页面 站点后,您可以获取其 HTML 代码的本地副本。 如果您生成了项目页面站点,请获取并检出新分支:
$ 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://主机名/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
分支中,因此只需检出 master
然后拉取!
$ 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://主机名/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
> ...