我看到Jake VanderPlas写的Github文章《Understanding Data Types in Python》，如此优美，且有comment栏。
我尝试github.io，得到https://pages.github.com。按照指示可以申请自己的github.io的博客。这个博客的特点是：书写markdown文档，上传，可发布为blog（Github会将其翻译成html网页）。
那么，想想看，如果建设一个基础repo，让其成为一个capacity，那日后只要写markdown文档就好。我喜欢Paul Le先生的Lagrange模板，修改其个人化数据，就以它作为基础repo。
那么核心任务是将其所有文件连同文件夹结构复制到我的Github repo。
1）新建一个repository，名字叫username.github.io。我的是dersu-git.github.io。
2）点击repository setting，选择一个theme。这样在浏览器输入username.github.io，可以得到博客网页。
3）替换整个repo。
在Terminal中pull 整个repository。
git remote set-url origin https://github.com/Dersu-git/dersu-git.github.io
git pull origin master
将所有文件“数据同步”至本地repo。Git command系列命令为：
git add .
git commit -m "Copy a demo repo."
git push origin master
稍等（Github有约半分钟的滞后），可以看到blog如同demo site。
如果不想用Git command，可以在网页上按这样的文档结构一个一个地上传（我这样想象，没有尝试）。若在上传之前就做好以下的个人化的工作更节约劳动。
4）个人化。
- _post中的md文档删除，替换成自己的blog md文档。
- 修改menu中的文档。
- 修改_config.yml。
- 修改_data中的setting.yml。需要申请disqus账号，获得short name。disqus用来实现comment功能。
- 修改favicon.ico。需要申请favicon。
每个文件都看一看，确保改好，数据同步。
从Git command的角度看，整个过程如图1示。
图1：创建Github blog的流程
日后写新的博客，是写.md文档，依葫芦画瓢起文件名，例如，2020-06-10-how-to-build-a-Github-blog.md（这个名字结构和网站代码读取文件有关），拷贝至_posts文件夹，图片存于assets/img，数据同步。我平时用网易云笔记写markdown文档，但无法保存，需要拷贝到TextEdit或Sublime保存为.md (我爱Sublime，我爱它的风格）。
若在Github markdown文档尽量手写，不要使用复杂标记语言（如list、引用脚注），Github会不理睬的。如果插入图片，我使用HTML标记语言：
<div style="text-align:left;"><img src="https://dersu-git.github.io/assets/img/gitcommand.jpg" style="margin-bottom:0px; max-80%;" alt=""><p style="font-size:12px">Fig: Git work flow</p></div>
感谢毛毛虫_wendy，《如何利用github page快速搭建个人博客》这个博文给我很多启发。
这里是本文的英文版。
相关：