My First Github Page

记录github pages 入门使用过程

不得不说，github的guide做的是真的好，不管是页面还是内容，简洁好看易懂。希望能够学到一点其写作与排版的风格。

构建属于自己的 github page 主要分为两步 :

• 创建github.io仓库
• 克隆项目，本地编写文档，上传仓库

创建github page 仓库

按照Guide__Getting Started with GitHub Pages一步步操作

• 创建仓库 username.github.io
• 进入setting，选择主题 choose a theme, 然后commit
• 浏览器输入地址https://username.github.io即可进入主页，默认README.md

本地编写文档，上传仓库

参考pages.github.com

• clone

  git clone https://github.com/username/username.github.io
  

• edit

  cd username.github.io
  可添加html或md文档
  

• push

  git add --all
  git commit -m "Initial commit"
  git push -u origin main
  

Connecting to github with SSH

参考GitHub Docs_Connecting to github with SSH

Using the SSH protocol, you can connect and authenticate to remote servers and services. With SSH keys, you can connect to GitHub without supplying your username and personal access token at each visit.

实现目录与文件跳转

文件之间跳转

markdown 使用 []() 进行链接跳转，若要实现在github page 上文件的跳转，需指定路径，并将文档的后缀改为 .html

如：[Introduction](Booklist/introduction.html)

（）内可使用相对路径或绝对路径，绝对路径的开头为 https://zzy2005137.github.io

[Introduction](https://zzy2005137.github.io/Booklist/introduction.html)

返回主目录

[HOME](https://zzy2005137.github.io/Booklist)

图片

图片地址则指定相对路径或绝对路径即可

页内目录跳转

Take me to [pookie](#pookie)

pookie为各个标题名，成为anchor point

HOME