Create a Root GH-Page

• Create a new repo named as YourAccountName.github.io, with a README in it.

• Go to this repo setting, finde the botton Choose theme, Select a theme you like.

• Back to repo, you’ll see a new file named _config.yml. Open and add new configs:

  ---
  title: Your Title
  description: Your Description
  ---
  

• Create a file index.html or index.md.

• Go back to this repository's settings page, check the Github Pages block, you can see your site is accessible now.

Create a Project Under the Root GH-Page

• Create a new repo named as you like.
• Go into the repo, you will see a pulldown button of Branch: main. Click it and create a new branch: gh-pages.
• Set gh-pages as default. Now you can deletet the main branch.
• Go into the repository's settings page, find the Github Pages block, change the source option to gh-pages. Keep it under the /(root) , or if you need to put it under another gh-page, you can change it also.
• Select a theme, create index file, and check links as above.

How to Use GH-Pages to Maintain Blog

• gh-pages use Jekyll (but not full), you can search gh-pages documentation to get help.

• A lazy way to run gh-pages:

  • You can set settings in your gh-pages, choose a theme, then run git pull.
  • Open index.html, and write a line at tht top in yml language:

  ---
  layout: home
  ---
  <!-- No other content here -->
  

  • Then, create your first blog as file _post/yyyy-mm-dd-Your_Title.md. At the top of the blog, you should write in yml language like this:

  ---
  layout: post
  title: Your Title
  author: Your Name
  ---
  <!-- Here is your content writen in `markdown` -->
  <!-- Search 'Markdown tutorial' in the google, if you don't know how to write markdown -->
  

• Pull to the

Advanced

• It is recomended to pull an push between local and remote, because edit markdown in a good local editor such as VSCode is much comfortable than coding in the browser textarea.