基本要求
必须安装 Jekyll 和 Git 后才可使用 Jekyll 创建 GitHub Pages 站点。 更多信息请参阅 Jekyll 文档中的安装和“设置 Git”。
我们建议使用 Bundler 安装和运行 Jekyll。 Bundler 可管理 Ruby gem 依赖项,减少 Jekyll 构建错误和阻止环境相关的漏洞。 要安装 Bundler:
为站点创建仓库
如果站点是一个独立的项目,您可以创建新仓库来存储站点源代码。 如果您的站点与现有的项目关联,您可以添加站点的源代码添加到 gh-pages
分支或该项目仓库 master
分支上的 docs
文件夹中。 例如,如果您创建站点来发布已经在 GitHub Enterprise Server 中的项目文档, 您可能想要将站点的源代码存储在与项目相同的仓库中。
如果要在现有仓库中创建站点,请跳至“创建站点”一节。
- 在任何页面的右上角,使用 下拉菜单选择 New repository(新建仓库)。
- 使用 Owner(所有者)下拉菜单选择你想要拥有仓库的帐户。
- 输入仓库的名称和说明(可选)。 如果您创建的是用户或组织站点,仓库名称必须为
<user>.github.io
或<organization>.github.io
。 更多信息请参阅“关于 GitHub Pages”。 - 选择仓库可见性。 更多信息请参阅“关于仓库可见性”。
创建站点
必须先在 GitHub Enterprise Server 上有站点的仓库,然后才可创建站点。 如果未在现有仓库中创建站点,请参阅“为站点创建仓库”。
警告:如果您的站点管理员启用了公共页面,GitHub Pages 站点在互联网上公开,即使站点的仓库是私有或内部的。 如果 您的站点仓库中有敏感数据,则您可能要在发布前删除该数据。 更多信息请参阅“为企业配置 GitHub Pages”和“关于仓库可见性”。
-
打开 Terminal(终端)Terminal(终端)Git Bash。
-
如果您还没有本地版仓库,请导航到您想要存储站点源文件的位置,将 PARENT-FOLDER 替换为要包含仓库文件夹的文件夹。
$ cd PARENT-FOLDER
-
如果尚未初始化本地 Git 仓库,请将 REPOSITORY-NAME 替换为仓库名称。
$ git init REPOSITORY-NAME > Initialized empty Git repository in /Users/octocat/my-site/.git/ # Creates a new folder on your computer, initialized as a Git repository
-
将目录更改为仓库。
$ cd REPOSITORY-NAME # Changes the working directory
-
如果是创建项目网站,确定要使用的发布源。 更多信息请参阅“关于 GitHub Pages”。
-
导航到站点的发布来源。 有关发布源的更多信息,请参阅“关于 GitHub Pages”。 例如,如果选择从默认分支上的
docs
文件夹发布站点,则创建并切换目录到docs
文件夹。$ mkdir docs # Creates a new folder called docs $ cd docs
如果选择从
gh-pages
分支发布站点,则创建并检出gh-pages
分支。$ git checkout --orphan gh-pages # Creates a new branch, with no history or contents, called gh-pages and switches to the gh-pages branch
-
要创建新 Jekyll 站点,请使用
jekyll new
命令:$ jekyll new . # Creates a Jekyll site in the current directory
-
打开 Jekyll 创建的 Gemfile 文件。
-
将 "#" 添加到以
gem "jekyll "
开头的行首,以注释此行。 -
编辑以
# gem "github-pages"
开头的行来添加github-pages
gem。 将此行更改为:gem "github-pages", "~> GITHUB-PAGES-VERSION", group: :jekyll_plugins
将 GITHUB-PAGES-VERSION 替换为
github-pages
gem 的最新支持版本。 您可以在这里找到这个版本:“依赖项版本”。正确版本 Jekyll 将安装为
github-pages
gem 的依赖项。 -
保存并关闭 Gemfile。
-
从命令行运行
bundle update
。 -
(可选)对
_config.yml
文件进行任何必要的编辑。 当仓库托管在子目录时相对路径需要此设置。 更多信息请参阅“将子文件夹拆分到新仓库”。domain: my-site.github.io # if you want to force HTTPS, specify the domain without the http at the start, e.g. example.com url: https://my-site.github.io # the base hostname and protocol for your site, e.g. http://example.com baseurl: /REPOSITORY-NAME/ # place folder name if the site is served in a subfolder
-
(可选)在本地测试您的站点。 更多信息请参阅“使用 Jekyll 在本地测试 GitHub Pages 站点”。
-
添加并提交您的工作。
git add . git commit -m 'Initial GitHub pages site with Jekyll'
-
将您的 GitHub Enterprise Server 仓库添加为远程仓库,将 HOSTNAME 替换为您企业的主机名,将 USER 替换为拥有该仓库的帐户,并将 REPOSITORY 替换为仓库名称。
$ git remote add origin https://HOSTNAME/USER/REPOSITORY.git
-
将仓库推送到 GitHub Enterprise Server,BRANCH 替换为您所操作的分支的名称。
$ git push -u origin BRANCH
-
配置发布源。 更多信息请参阅“配置 GitHub Pages 站点的发布来源”。
-
在 GitHub Enterprise Server 上,导航到站点的仓库。
-
在仓库名称下,单击 Settings(设置)。
-
要查看您已发布的站点,请在“GitHub Pages”下点击您的站点 URL。
注:对站点的更改在推送到 GitHub Enterprise Server 后,最长可能需要 20 分钟才会发布。 如果一小时后仍然在浏览器中看不到您的更改,请参阅“关于 GitHub Pages 站点的 Jekyll 构建错误”。
注:如果网站 的源文件位于默认发布源 - master
(对于用户和组织站点)或 gh-pages
(对于项目站点)- 但您的站点 未自动发布,请确保有一个拥有管理权限和经验证的电子邮件地址的人已推送到默认发布源。
后续步骤
要向站点添加新页面或帖子,请参阅“使用 Jekyll 添加内容到 GitHub Pages 站点”。
您可以将 Jekyll 主题添加到 GitHub Pages 站点,以自定义站点的外观。更多信息请参阅“使用 Jekyll 添加主题到 GitHub Pages 站点”。