Github Page 博客不完全实践指南

2017/01/11 技术指南

这里是一些有用的小技巧,如果各位想要利用GitHub Page 搭建自己的博客并且使用Jeyll引擎的话。我在几天的博客搭建、写作实践中踩了一些坑,包括处理图片,使用Git命令,中文符号问题以及错误排查等等,希望对各位有所帮助。

关于上传图片

我的经历

三年以来,我的博客从新浪搬迁到网易,从Lofter和自己买的VPS搬迁到AWS EC2,中间反复的导出博客,格式也不知道乱了多少。其中图片是一个让人头疼的问题。我之前的博客用的是七牛的CDN,因为在国内,速度非常不错。缺点是,你需要一个已经在大陆地区备案过的域名,这个过程很繁琐。加上,把自己的博客图片放在一个国内的第三方服务器上,总觉得有些不安稳。我的看法是——文字放在哪,图片就放哪儿,这样集中管理更加方便。

对于现在这个博客,我的图片是放在GitHub的 username/username.github.io 这个仓库里的。

我之前的文章都是用Word写的,图片直接粘贴在里面,这样的好处不言自喻,文件就是一切,你可以独立的保存。后来转到markdown的时候,我对这些文档进行了一次处理,只需要安装一个叫做Writage的小插件,就可以在保存Word文档的时候解锁这种姿势:

之后,它会自动生成一个叫做 media 的文件夹,你可以把它直接拖拽到你的博客根目录。

那么,问题来了,生成的md文件的图片格式要不要改呢?显然是要的,一般来说,它自动生成的是这个样子: media/simple.img ,之后你整理好文章中的字,然后很兴奋的打开,哎,为什么刚才发布的文章图片显示不出来呢?

于是我们打开github,把地址定位到这个新发布的博文—— github.com/username/username.github.io/_post/simple-doc.md ,你发现,哎,图片也没有。

于是,我又重新把图片放在的 _post根目录,打开 github.com/username/username.github.io/_post/simple-doc.md ,结果发现,不错,有了。但是,打开网站查看的时候,依旧显示不出来。

解决办法

经过仔细查看我fork的这个博客原主人的博客代码,我发现,他的图片放在了根目录,地址定位的是 /media/simple.img ,前面多了一个绝对引用路径,经过尝试,发现可以解决问题。

所以,请把图片放在根目录,然后修改图片的链接为绝对路径: /media/simple.img 即可完美显示图片

无法显示新写的博客

关于博客MD文件命名的问题

一般来说,文件格式要保存成这个样子: 201X-XX-XX-你的标题.md 或者 201X-XX-XX-你的标题.markdown 但是,你也可以偷一下懒,文章标题不写,或者少些一点,将来博客显示的标题是你md文档头部那个title 标签的东西,至于文件名,则仅仅是一个标签,方便你之后进行管理。关于文件名,你命名md文件的时候,所有的字符,比如《、》、——等等显示在地址栏的时候都会自动变成 -,所以,除去规范的201X-XX-XX-这个日期标志之外,其余的部分随便写,它仅仅是一个标签。

文章内容冲突

一般来说,你的博客出