Adding content to your GitHub Pages site using Jekyll

People with write permissions for a repository can add content to a GitHub 页面 site using Jekyll.

本文内容

• About content in Jekyll sites
• Adding a new page to your site
• Adding a new post to your site
• 后续步骤

About content in Jekyll sites

Before you can add content to a Jekyll site on GitHub 页面, you must create a Jekyll site. For more information, see "Creating a GitHub 页面 site with Jekyll."

The main types of content for Jekyll sites are pages and posts. A page is for standalone content that isn't associated with a specific date, such as an "About" page. The default Jekyll site contains a file called about.md, which renders as a page on your site at YOUR-SITE-URL/about. You can edit the contents of that file to personalize your "About" page, and you can use the "About" page as a template to create new pages. For more information, see "Pages" in the Jekyll documentation.

A post is a blog post. The default Jekyll site contains a directory named _posts that contains a default post file. You can edit the contents of that post, and you can use the default post as a template to create new posts. For more information, see "Posts" in the Jekyll documentation.

Your theme includes default layouts, includes, and stylesheets that will automatically be applied to new pages and posts on your site, but you can override any of these defaults. For more information, see "About GitHub 页面 and Jekyll."

To set variables and metadata, such as a title and layout, for a page or post on your site, you can add YAML front matter to the top of any Markdown or HTML file. For more information, see "Front Matter" in the Jekyll documentation.

Changes to your site are published automatically when the changes are merged into your site's publishing source. If you want to preview your changes first, you can make the changes locally instead of on GitHub Enterprise. Then, test your site locally. For more information, see "Testing your GitHub 页面 site locally with Jekyll."

Adding a new page to your site

1. On GitHub Enterprise, navigate to your site's repository.

2. Navigate to the publishing source for your site. For more information about publishing sources, see "About GitHub 页面."

3. In the root of your publishing source, create a new file for your page called PAGE-NAME.md, replacing PAGE-NAME with a meaningful filename for the page.

4. Add the following YAML frontmatter to the top of the file, replacing PAGE TITLE with the page's title and URL-PATH with a path you want for the page's URL. For example, if the base URL of your site is https://octocat.github.io and your URL-PATH is /about/contact/, your page will be located at https://octocat.github.io/about/contact.

   layout: page
   title: "PAGE TITLE"
   permalink: /URL-PATH/

5. Below the frontmatter, add content for your page.

6. 在页面底部，键入简短、有意义的提交消息，描述您对文件所做的更改。您可以在提交消息中将提交归因于多个作者。更多信息请参阅“创建多个合作作者的提交."

   

7. 在 commit message（提交消息）字段下方，决定要将提交添加到当前分支还是添加到新分支。如果当前分支为 master，则应选择为提交创建新分支，然后创建拉取请求。

   

8. 单击 Propose file change（提议文件更改）。

   

Adding a new post to your site

1. On GitHub Enterprise, navigate to your site's repository.

2. Navigate to the publishing source for your site. For more information about publishing sources, see "About GitHub 页面."

3. Navigate to the _posts directory.

4. Create a new file called YYYY-MM-DD-NAME-OF-POST.md, replacing YYYY-MM-DD with the date of your post and NAME-OF-POST with the name of your post.

5. Add the following YAML frontmatter to the top of the file, replacing POST TITLE with the post's title, YYYY-MM-DD hh:mm:ss -0000 with the date and time for the post, and CATEGORY-1 and CATEGORY-2 with as many categories you want for your post.

   layout: page
   title: "POST TITLE"
   date: YYYY-MM-DD hh:mm:ss -0000categories: CATEGORY-1 CATEGORY-2

6. Below the frontmatter, add content for your post.

7. 在页面底部，键入简短、有意义的提交消息，描述您对文件所做的更改。您可以在提交消息中将提交归因于多个作者。更多信息请参阅“创建多个合作作者的提交."

   

8. 在 commit message（提交消息）字段下方，决定要将提交添加到当前分支还是添加到新分支。如果当前分支为 master，则应选择为提交创建新分支，然后创建拉取请求。

   

9. 单击 Propose file change（提议文件更改）。

   

后续步骤

You can add a Jekyll theme to your GitHub 页面 site to customize the look and feel of your site. For more information, see "Adding a theme to your GitHub 页面 site using Jekyll."