GithubPages+Prose搭建一个静态博客 | 好IT
    欢迎访问好IT,推荐使用最新版火狐浏览器和Chrome浏览器访问本网站.

GithubPages+Prose搭建一个静态博客

教程 小旭 4个月前 (08-24) 9次浏览 0个评论 扫描二维码
转至:http://liyu1981.github.io/github-prose-blog/



Why github pages + prose.io?

一句话:github jekyll 静态页面自动生成,沉浸式的书写体验,git 版本控制,夫复何求?

写 Blog 是一个很随意的行为,通常人们对写得要求也不高,所以从 WordPress 到轻博客再到微博,写的是越来越轻,越来越容易。

但是维护 Blog 并不容易。

对于向我这样的人来说,一个可以维护的 Blog 系统需要

  1. 用简单的数据格式存储

    想要找到某片 Blog 的文章时,无需翻箱倒柜将后台数据库大卸八块。Come on,blog 本来不应该就是些 txt 文件么?Grep 一把为什么就不行?

  2. 有一个沉浸式的编写工具

    这个很重要。写东西的时候总是需要没有干扰,左右两边不要不停的有“齐 x 短裙热卖 9 元起”这样的东西飞来飞去。

  3. 能打草稿,能版本控制。

    人就是这么懒,想起来一点写一点,但是如果有个工具激励,事情或许会不同一点。

所以 github pages 是个貌似理想的选择:存储就是文本文件,加上一点简单 Markdown;版本控制用 git,没有更好的了。

但是 github pages 缺少一个简单的编写工具。或者说,没有一个简单的可以在 Web 上使用的工具。clone 到本地,动用 jekyll server 再加 vim,显得太重量,适合做一些比较有创造性的事情,不适合随便写写。

于是 prose.io 弥补了这个空缺,提供了一个很好的在线 github pages 编辑工具,问题解决了。

看起来怎样

以你现在看到的这个 blog 为例吧,看起来是这样的

abbeyokgo

点击左上角的 Edit 之后,进入在线编辑器,是这样的

abbeyokgo2

完成编写,提交是这样的 abbeyokgo3

点击完毕提交,boom,commit 到 github,github pages 通过 hook 就自动生成了静态页面,就这么简单。

当然,因为它是 github pages,所以 clone,vim 随便写一个很复杂的演示什么的都很容易,无比强大。

想备份,git clone,想观察更改记录,github 的 web 界面就可以用

总之,如果你是程序猿,没有比这个更加合适的了。

怎样弄一个

基本上,包含两个步骤

  1. 弄好一个 jekyll 设置好的 github pages
  2. 设置好 prose.io

设置好 github pages

怎样设置好 github pages,再把 jekyll 配置好,教程已有不少,比如这个,还有这个,以及我参考的这个

看起来都很简单,实际上做起来往往又不是那么尽如人意,你懂得。

老湿,能不能再给力一点?copy paste 如何?

这个要求不是不可以满足,如果实在对个性化没什么要求,这儿有个 123 的方案

  1. 我准备了一个模板,fork 它

    首先当然你要有一个 github 账号,没有也没有关系,会提示你创建的。

  2. 去 github 界面上把 repo 的名字改成 <你的名字>.github.io

    github 修改 repo 名字就是在 repo 页面上点那个 setting,第一个选项卡就有。这里有图有真相

  3. 修改一下 repo 根目录下 _config.yml 里面 myblog 组下的一些信息
Key说明
gavatar你 email 地址的 md5 值,用于模板里 gavatar 头像显示。给个在线计算工具,注意全用小写
gpnamegithub 账号的名字
linkedinlinkedin 链接
githubgithub 链接
coverimgsindex 页右侧的背景图数组,替换下 http 那部分,没有就留个[]
postbgimgblog post 页的背景图 url

做人不是很讲究的话,这就算是搞完了(当然,美化这种事情是永恒的,我懂得,以后随意改)

设置 prose.io

不用 prose.io,直接在 github 的 online edit 也是可以的,prose.io 提供了一个稍好的编辑环境,所以可以一试。

prose.io 总的来说没什么配置的,不配置也行,直接访问http://prose.io ,授权就行了。

如果要配置,基本上就是在 _config.yml 里面添加一些个 prose.io 用的配置,基本上可以参考这里

如果是从我给的模板 fork 的,那就不用修改了,已经配置好了。

Prose.io 使用上的注意事项

  1. Prose.io 的 markdown 默认不显示 jekyll metadata,需要点击右边的对应 button 显示和编辑。
  2. 配置了 jekyll 之后,prose.io 默认的标题就不在是xxxx-xx-xx-yyy-zzz.md这样的格式,而是做为真正的 title。英文的习惯下,commit 到 github 的文件名会将这个 title 拆字后用-组合形成文件名,例如hello world最后会组合成2014-03-27-hello-world这样。使用中文的情况下,这个机制就不怎么灵光了。所以如果要避免生成一些2014-03-27-.md这样的名字,先在 title 里面用英文关键字写,commit,然后再修改成中文。这样就行。
  3. 如果用我模板里面的配置,prose.io 里面的文章默认是 unpublished,所以大可以慢慢写完再说,要发布的时候点击工具栏转成 published,再 commit 就会自动生成。
  4. prose.io 当前支持插入图片,会自动上传到 github 里面(在 _config.yml 里面配置)。但是太过于彪悍的文件名,比如很黄很暴力的,很多火星文的,有中国特色中文的,都会导致各种各样的问题。因此,为了世界和平,拖进去之前还是自己改个人畜无伤的名字吧。

好 IT, 版权所有丨如未注明 , 均为原创丨本网站采用BY-NC-SA协议进行授权 , 转载请注明GithubPages+Prose 搭建一个静态博客
喜欢 (0)
发表我的评论
取消评论
表情 贴图 加粗 删除线 居中 斜体 签到

Hi,您需要填写昵称和邮箱!

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址