Mac搭建Hexo博客流程记录,排雷完成

经过一天的辛苦作战,总算基础的东西出来了。踩了太多的坑,综合我踩坑的经过,明白到,选好一篇引导文很重要!有些步骤不要先做了,不然后面你都不知道怎么死的..

很多博客都已经详细讲述了Hexo博客框架的好处和怎么做,下面的推荐文章里会给出链接。但有些过于复杂,让初次配置的人有点雨里雾里;有些又太简单,出了问题就会不知道怎么回事。下面是自己的搭建记录,及所遇问题的解决。

在此感谢小马哥Markwingjay先前分享的教程,有些地方是从你们里借鉴来的,希望博主见谅,如有侵权,请联系我删除。

Ok,现在开始:

GitHub Pages

在不购买服务器的前提下,我们的网站需要挂在GitHub Pages上。GitHub Pages是面向用户、组织和项目开放的公共静态页面搭建托管服务,可用于搭建个人博客。

  • 首先你需要拥有一个GitHub账号。
  • 然后进入GitHub Pages,一步步做,完成后就能在浏览器打开http://username.github.io了。

至此,我们已经利用GitHub Pages搭建好了个人博客雏形了。下面要做的,就是个性化了。

注意:如果你http://username.github.io首页就要是博客首页的话,建议初次配置选择首页,就是这样。完成后可以把index.html给删了,因为到最后你发现那是没用的,它将会给你造成干扰。

前期准备

安装Hexo

参考中文文档英文文档。完成该步后,你的电脑便拥有了Git、Node.js和Hexo。

测试安装状态

$ node -v
 v4.2.4

$ npm -v
2.14.12

$ hexo -v

正式开始

确定拥有了Git、Node.js和Hexo后,进行下一步:

建站

安装 Hexo 完成后,请执行下列命令,Hexo 将会在指定文件夹中新建所需要的文件。

$ hexo init <folder>
$ cd <folder>
$ npm install

新建完成后,指定文件夹的目录如下:

.
├── _config.yml
├── package.json
├── scaffolds
├── source
|   ├── _drafts
|   └── _posts
└── themes

这样Hexo会在该文件夹创建本地博客所需的一切资源。这样本地博客就搭建好了,输入以下命令:

hexo s --debug // 启动本地hexo 服务器,默认localhost:4000可以访问,可以看到调试信息

这样就开启了一个本地博客服务器,打开浏览器,在地址栏输入localhost:4000,就可以查看本地博客了,hexo默认生成了一片hello world博客。出现问题可以看terminal终端错误信息。按control + c关闭调试。

注意:以上hexo开头的命令,执行目录必须是你创建的博客文件夹目录。使用hexo s 也可以,只是没有了调试信息。

同步Hexo博客到Github

现在你已经可以在本机查看你的博客了,但是要想让别人通过网络可以查看你的博客,还需要一步,那就是将你的博客发布到github仓库。在terminal终端,将当前目录切换到你的本地博客目录,执行以下命令:

npm install hexo-deployer-git --save

安装完成之后,打开本地博客目录的_config.yml文件,编辑其中的deploy节点:

deploy:
  type: git
  repo: https://github.com/youlookwhat/youlookwhat.github.io.git
  branch: master

注意:字段前需加空格,hexo有严格的格式规范。

保存配置之后,你可以不着急传到仓库,先刷新本地博客,看是否还是原样,如有问题可以看到terminal终端上的错误信息,然后检查没问题为止。

确认无误之后,在本地博客目录执行以下命令:

hexo clean // clean本地项目,防止缓存
hexo g // 全拼是:hexo generate,可以简写成 hexo g; 根据你编辑的md格式的博客,生成静态网页
hexo d  // 全拼是:hexo deploy,可以简写成 hexo d; 将本地博客发布到github

然后,在浏览器地址栏输入username.github.io就可以访问你的博客了,别人也可以通过这个地址访问你的博客。如果错误请重复看以前流程,或参考其他文章,也可以联系我.

NexT主题配置

Hexo主题非常多,可以参考丰富多彩的Hexo主题,本文选Next为主题,NexT主题是一套简约的主题,设置完成之后,就像我的博客现在的样子,里面有详细的配置说明,这里就不重述了。

配置后调试:

hexo clean
hexo g
hexo s --debug

确认无误后上传:

hexo clean
hexo g
hexo d

注意:因为hexo有严格的格式规范,所以建议配置时及时调试页面。

优化环节

域名设置

大家可以看:替换自己的域名 ,里面讲述的详细。

注意:在万网买了域名以后直接在里面配置,这里只是参考用的。

其它四条

大家可以看:其他遗漏的点

注意:配置后进入调试模式测试一下,这样错了就可以马上更正。

常用命令

cd 到仓库所在文件夹目录下:

hexo init       //在指定目录执行该命令,会将当前目录初始化为hexo站点,生成hexo站点所需的一切文件
hexo new “my new blog title”   //新建一篇文章。如果没有设置 layout 的话,默认使用 _config.yml 中的 default_layout 参数代替。如果标题包含空格的话,请使用引号括起来。
hexo s --debug    // 启动本地hexo 服务器,默认localhost:4000可以访问
hexo clean      // 清除缓存,如果对本地文件做了修改,同步到远程验证修改的效果之前,先clean,清除缓存
hexo generate   // 可以简写成hexo g 根据markdown文件生成静态文件
hexo deploy     // 或者简写成hexo d 将本地修改,部署到远端
hexo version    // 显示hexo版本

推荐文章

所遇问题

  • 按照步骤来,及时调试,确认无误后再执行下一步。有一句话说的好,步子跨大了容易扯着蛋。
  • 建议将基础的先搭建出来,主题细节可以之后再慢慢配置。
  • 编辑站点_config.yml文件其中的deploy节点时,注意repo的值。
  • 替换域名时:
    • 直接在万维网设置解析方式;
    • 在仓库Setting的要设置跳转链接;
    • CNAME会被覆盖,安装CNAME工具hexo-generator-cname
  • 为博客文章添加阅读量统计功能,参照这里,注意顺序,我在其中被坑过。
  • 设置网站图标时,就是上传“.ico”文件时,确认成功后浏览器会有缓存,显示不出来,关掉浏览器清除缓存就好了(可放在最后)。
  • 设置代码高亮主题测试时没事,上传后会有延迟,等等就好了(本人这样)。
  • 设置搜索栏,进入swiftype官网,注册不上,应该收费了- -.
  • 设置侧边栏社交链接时,social:下面字段前要有两个空格,切记

相关网址

NexT多说百度统计leancloud阿里云fork meico制作

联系我

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

推荐阅读更多精彩内容