Where the Theme and Layout for renzhezhilu.github.io Come From
Updated
The layout and styles on renzhezhilu.github.io come from the Jekyll theme selected in the repository's settings. The theme's name is saved in the Jekyll _config.yml configuration file, and the site is rebuilt by Jekyll each time a commit is made to the repository. To change the look of the site, you change the theme selection rather than editing the page content itself.
How the pieces fit together
The page describes a standard GitHub Pages setup with three moving parts:
- Markdown files hold the content. You maintain and preview them using the editor on GitHub.
- Jekyll does the building. Whenever you commit to the repository, GitHub Pages runs Jekyll to rebuild the site's pages from the Markdown content.
- The Jekyll theme supplies the layout and styles. It is chosen in the repository settings, and its name is recorded in
_config.yml.
So the content you write and the appearance visitors see are handled separately. Markdown controls what the page says; the theme controls how it looks.
What the page says about Markdown formatting
The site's welcome page also documents the Markdown conventions it supports, which is useful if you are editing content and want to know what will render:
| Element | Syntax shown on the page |
|---|---|
| Headers | # Header 1, ## Header 2, ### Header 3 |
| Bulleted list | - Bulleted |
| Numbered list | 1. Numbered |
| Bold / italic | **Bold** and _Italic_ |
| Code | `Code` text |
| Code block | Syntax highlighted code block |
| Link | [ Link ]( url ) |
| Image |  |
For more detail, the page points to GitHub Flavored Markdown.
Changing the theme
Because the theme name lives in _config.yml and the selection is made in repository settings, changing the site's appearance means updating that theme selection. The page does not spell out the exact menu path, so treat the settings area of the repository as the place to look, and expect _config.yml to reflect the theme you choose. After the change, the next commit triggers Jekyll to rebuild the pages with the new layout and styles.
If something goes wrong with Pages, the page directs you to GitHub's documentation or to support for help.