朱皮特的博客 自由的飞翔

使用GitHub无须购买空间搭建个人博客

2001-01-01
朱皮特
web
 
阅读量:

如何使用

从这里gaohaoyang.github.io下载模板,稍作修改。

非常感谢作者Gaohaoyang提供的这么好用的模板,修改的内容非常少,就连分类都不需要自己手动配置了,完全根据发的MD博客内容自动获取,非常方便。

如何配置

  • 修改_config.yml文件,对照着修改即可,非常简单。
  • 修改index.html中的博客显示的主标题和副标题。
  • 替换一个你喜欢的favicon.ico图标,当然不修改也没关系。
  • page目录下的页面是要显示在博客顶部的,可以自行修改。主要是归档,标签,分类,关于,除关于的自我介绍需要修改外,其他基本上不需要修改。

最后再提一下,这个模板会自动根据博客内容里指定的分类来管理分类,所以不需要手动配置分类了,方便!

如何发布博客

  • 在_posts目录下写MD文件,可以创建子目录,子目录的名称与上面配置的文章分类不冲突,可以随意取名。长期编写博客的话建议还是分门别类组织好,以免文件太多不好管理。
  • MD文件有一个格式,必须以日期开头,类似:2001-01-01-readme.md
  • 本地写好.md文件,文件最好不要使用中文命名,以免不好做外链分享。MD文件内容开头填好以下字段:
layout: 	post
category:	"web"
title:		"这里写标题"
tags:		[web,blog]

最简的写法:

layout: 	post
category:	"web"
title:		"这里写标题"

复杂点的写法:

layout: 	post
category:	"web"
title:		"这里写标题"
tags:		[web,blog]
date:		2017-02-27

如果有date字段,那么会用内容的时间,不过不建议这么做!

  • 为了让博客显示MD的目录,在上面内容之后正文之前加上这段内容:
	- 目录
	{:toc}
  • 编写好后SVN提交,比Git提交方便太多,推荐!
  • GitHub Pages会在收到提交后,会把文章编译成静态网页,编译使用的字段如上。
  • 刷新网站,可以理解看到效果。
  • 如果MD文件中的格式有误,GitHub会给一个警告,然后按内容修改后重新提交即可。

TODO

以下可以参考,但是不建议直接用,因为要修改的地方太多,部署太麻烦,而且容易失败,但是里面的模块可以借鉴参考:

参考资料


Comments

Content