【Hexo】Mac OS上使用Hexo + Github搭建博客教程

Hexo介绍

Hexo是一个快速、简洁且高效的博客框架,具体可以见Hexo官网,它在github上的star数现在已经到34.7k,Hexo主要有以下特点:

  1. 超快速度:Node.js所带来的超快生成速度,可以让上百个页面在几秒内完成渲染。

  2. 支持Markdown:Hexo 支持 GitHub Flavored Markdown 的所有功能,甚至可以整合 Octopress 的大多数插件。

  3. 一键部署:只需一条指令即可部署到 GitHub Pages, Heroku 或其他平台。

  4. 插件或可扩展性:强大的 API 带来无限的可能,与数种模板引擎(EJSPugNunjucks)和工具(BabelPostCSSLess/Sass)轻易集成。

安装环境

安装Node.js

下载地址:https://nodejs.org/en/

安装nodejs.png

安装淘宝镜像

// 使用命令安装淘宝镜像:
npm install -g cnpm --registry=https://registry.npm.taobao.org

安装Hexo

// 使用命令去安装Hexo
cnpm install -g hexo-cli 

安装成功

安装成功后,可以使用hexo -v命令查看一下hexo版本:

查看Hexo版本.png

初始化Hexo Blog

新建一个文件夹

我这里创建一个名为Blogs的文件夹,并进入该文件夹内:

初始化Hexo

// 初始化hexo
hexo init

初始化成功如下:


Hexo初始化成功.png

这时候Blogs下的目录结构如下:


Blogs目录下结构.png

本地启动Hexo

// 启动Hexo
hexo s
hexo_s.png

浏览器打开博客网站

hexo_local.png

创建博客文章

创建博客

// 创建一篇博客
hexo n "我的第一篇博客文章"

文章在Blogs目录下的结构如下:


hexo_new_post.png

清理项目缓存

新增博客文章或者修改博客文章内容,需要执行此命令:

// 清理之前生成的网站
hexo clean

重新生成博客

// 重新生成博客
hexo g

再次启动项目

// 再次启动博客网站
hexo s

浏览器页面展示如下:


hexo_first_post.png

修改网站主题

Hexo框架默认的是landscape主题,Hexo上有三百多种主题,大家可以上Hexo官网选择自己喜欢的主题,我这里以butterfly为例:

下载butterfly主题

// 下载butterfly
git clone https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly
下载butterfly主题.png

我们下载的主题都存放在Blogs/themes文件夹下:


0509_01.png

修改项目配置文件

主题下载下来之后,我们需要在项目配置文件_config.yml里面修改我们的主题:

0509_02.png

把默认的landscape修改为我们下载好的主题 butterfly

重新生成项目

这时候再执行我们Hexo三连:

// 清理项目缓存
hexo clean

// 重新生成项目
hexo g

// 本地启动项目
hexo s

Tips:重新生成项目和本地启动项目可以合并:hexo g & hexo s
再次打开项目,效果图如下:

0509_03.png

哈哈哈哈,惊不惊喜,意不意外,这是个什么鬼东西???
别慌,发现问题 - 找到问题 - 分析问题 - 解决问题:
原因其实也很简单,我们没有安装pug和stylus的渲染器,执行如下命令:

// 在Blogs目录下 安装pug 和 stylus渲染器
npm install --save hexo-renderer-jade hexo-generator-feed hexo-generator-sitemap hexo-browsersync hexo-generator-archive

安装完成后,重新生成项目:


0509_04.png

到这里,我们的主题修改就完成了,后期我们可以根据自己的需要去修改butterfly的配置文件,让我们的博客网站更加个性化。
下一篇文章我将说说如何修改主题让我们的博客网站更具个性化。

关于Hexo搭建博客到这里就讲得差不多了,下面我们就想怎么把博客部署到Github上。

部署博客到Github

首先,你得要有一个自己的Github账号吧,我相信99.99%的开发者都是有Github账号的,如果你是那0.01%,请前往Github自行注册。

创建仓库

在Github里创建一个存放博客项目的仓库,操作如下:


0509_05.png
0509_06.png

这里有两个注意点:

  1. 仓库的名称必须与你Github账号名相同
  2. 仓库必须以gitHub.io结尾

比如你Github账号名叫:zhangsan,那你新建的这个仓库名就叫:zhangsan.github.io
创建之后,我们就有了一个存放博客项目仓库:

0509_07.png

安装Hexo部署插件

进入到Blogs目录下,安装部署插件:

cnpm install --save hexo-deployer-git
0509_08.png

修改项目配置文件

好了,万事俱备,只欠修改_config.yml文件了,打开_config.yml文件,拖拽到最后,修改文件:

0509_09.png

修改为:
0509_11.png

注意:repo为你刚创建的Github项目的地址,如果你是使用的vim打开的_config.yml,记得修改了要:wq保存退出

重新生成项目

清理项目缓存:

hexo clean

重新生成博客:

hexo g

部署到云端(Github):

hexo d

注意:这里每次使用hexo d部署到Github为了安全都要求输入账号密码,如果你不希望每次都输入账号密码,可以跟博主一样设置Github的SSH Keys,以后每次发布到Github就不需要输入账号密码了。

访问云端博客主页

访问地址:https://博客仓库名.github.io
比如我的博客地址:https://happycodersunny.github.io

0509_12.png

最后

基本上到这里,属于我们自己的博客就搭建完成啦,撒花🎉🎉🎉~,整个搭建流程如果不出错半个小时之内其实是可以搞定的,但是这路哪里那么好走呢,每个人去搭建的过程中或多或少都会遇到一些问题,我自己在搭建的过程中也碰到了一些问题,我会抽空把遇到的问题详细整理出来,希望能够帮助大家如果要搭建博客的时候少踩点坑。

嘻嘻嘻,都看到这里了,不要吝啬你的小星星嘛,为博主点个赞呐~

更多关于Hexo框架和butterfly主题配置可以移步Sunny的个人技术博客

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

推荐阅读更多精彩内容