Github上写Blog

Posted 2021-02-01 zhuyx

预备知识：

必须：Git，GitHub，Jekyll，Markdown

可选：html，javascript，CSS，XML

工具：

可选：VSCode+Markdown Preview Github Styling，GitHub Desktop

操作：

1. 注册一个GitHub的账号，可以使用GitHub Desktop或者GitHub网站；
2. 创建一个空的项目
• 在项目里面创建index.md，或者index.html，提交后，博客首页就建好了。
• 注1：index.html的优先级比index.md的高，系统会默认使用index.html显示。
• 进入项目的Settings，找到Github Pages，修改Source的选项，默认是None（也就是不开启主页显示模式），改为master branch，点save。页面重新刷新，再找到Source就会出现系统提示的显示地址。
• 如果还想换个漂亮的皮肤，就点theme就可以了。
• 注1：所有的操作完成后，系统会编译你的主页，等1分钟左右，就可以点击那个地址，看自己的成果了。如果报错，就再多等一会，可惜GitHub也不给个编译进程的提示。
• 注2：如果你的index.md文件编写有问题，系统编译没有通过就会报错，提醒你去修改。
3. 如果不甘心使用这样简单的主页，你就需要fork一个别人的项目barryclark/jekyll-now；
• 修改_config.yml文件
  • name：博客的名字
  • description：显示在浏览器上的标题栏的名字
  • avatar：博主的照片（可以从Git的Profile里面取照片的地址）
  • # Flags below are optional：表示以下的内容可以选择性的修改
    • email，github是我有的，其他的就看个人喜欢，不填内容就不会在网页上显示，也不会出错
    • sina，douban等国内的需要修改代码才能实现（人懒就先放一下了）
  • permalink在前面加个#把它屏蔽掉，因为默认的方式似乎无法正常显示。
• Settings设置参考前面的说明。
• 按照“_post”目录下的“2014-3-3-Hello-World.md”的模式，依据“YYYY-MM-DD-文件名称.md”的标准创建一个新文件，就是你发表的新文章了。
• 打开主页，就会看到文章的主题出现在主页，点进去就可以看到文章的内容。
• 注1：系统需要编译，请耐心等待一会再打开查看，还要记得看系统编译有没有问题。
• 注2：如果不喜欢远程编译结果出来后才知道有没有问题，可以自己在本机安装Jekyll，具体方法可以参考其他文章。
4. 如果还想更漂亮的的页面，更完整功能可以fork这个项目mmistakes/minimal-mistakes
• 以后补充。