【Blog】Gitbub搭建自己的博客

本文主在记录github上搭建属于自己的blog,环境配置过程中跳过的一些坑。
环境:Mac OS
如果是win系统,因为需要用到gem包管理工具,请先下载安装ruby注意为了避免不必要的麻烦建议安装在非中文且不包含空格下划线等特殊字符的目录下面!


1.创建静态私人站点

按照github pages中的操作配置完毕,你就可以访问自己的静态站点了,之所以称为静态站点,是因为它不包含数据库。标题链接是一个详细参考文档,你也可以参考快速开始文档
个人推荐先阅读快速开始文档了解大概流程后,参考详细文档创建一个私人静态站点!

注意:仓库的username必须跟自己的github用户名相同

2.配置jekyll

Jekyll 是一个简单的博客形态的静态站点生产机器。它有一个模版目录,其中包含原始文本格式的文档,通过一个转换器(如 Markdown)和我们的 Liquid 渲染器转化成一个完整的可发布的静态网站,你可以发布在任何你喜爱的服务器上。Jekyll 也可以运行在 GitHub Page 上,也就是说,你可以使用 GitHub 的服务来搭建你的项目页面、博客或者网站,而且是完全免费的。
更多请前往jekyll中文官网

注意:
当使用 sudo gem install jekyll bundler 后报错 /usr/bin Operation not permitted

这是因为El Capitan 加入了Rootless机制不再能够随心所欲的读写很多路径下了。设置 root 权限也不行,Rootless 机制将成为对抗恶意程序的最后防线,所以我们可以尝试暂时关闭Rootless.

重启按住 Command+R,进入恢复模式,打开Terminal

$ csrutil disable

这时候再安装jekyll就会成功了.

如果需要打开Rootless

重新进入恢复模式,打开Termial

$ csrutil enable

3.基本用法

3.1效果预览

首先clone我们前面在github上创建的blog仓库。jekyll自带了一个站点服务器,类似于appatch,可以帮助我们动态在浏览器中查看网站效果,进入到本地仓库目录,$ jeykll server,就可以在127.0.0.1:4000端口预览效果,而不用每次都上传到github.

当然我们还需要安装bundler,它可以帮助我们管理Ruby gem的依赖库,处理jekyll的编译错误信息,输出配置环境相关的一些bugs,帮助提高工作效率。

Bundler manages Ruby gem dependencies, reduces Jekyll build errors, and prevents environment-related bugs. To install Bundler, you must installRuby.

使用如下命令安装bundler

$ bundle install
安装完成后就可以预览站点了

进入站点目录,使用下面两种方法启动默认站点预览服务器

  • $ bundle exec jekyll serve
  • $ jekyll serve

然后在浏览器中输入http://localhost:4000/预览效果

3.2个性化配置

jekyll自动生成博客框架中有较多的默认值,并且比针对github有特殊处理所以我们在把自己的第一版博客发布到github之前需要做一些个性化配置(博客名,个人信息等)。当然,如果你觉得留着这些默认值也可直接跳过这一段,直接进行发布:) 个性化配置主要在_config.yml中进行


好了完成了以上的配置工作,我们就可以将项目从github上clone到本地,进一步开发自己的私人博客了,具体的项目结构和开发事项这里不做介绍,如需了解更多请移步jeykll官方网站

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,378评论 6 481
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,356评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 152,702评论 0 342
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,259评论 1 279
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,263评论 5 371
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,036评论 1 285
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,349评论 3 400
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,979评论 0 259
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,469评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,938评论 2 323
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,059评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,703评论 4 323
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,257评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,262评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,485评论 1 262
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,501评论 2 354
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,792评论 2 345

推荐阅读更多精彩内容