搭建Hexo博客中碰到的坑

前段时间上网查资料时看到了好几个很不错的个人博客,感觉很棒,自己也想搭建一个玩一下,刚好在万网查到自己的域名niujiajun.com没被注册,就搜集资料准备开干了。虽然现在早就不再是博客的时代了,但本来也没想着靠这个干什么,只是说能有个专属自己地方能分享记录自己的思考,资源和学习成果,可以把琐碎的东西总结归纳然后写出来,毕竟写出来>说出来>想出来。

不简单的介绍

好了费话不多说了,开始复盘博客搭建的整个过程。首先简单介绍一下,我的博客由Hexo作为博客框架,Github提供的300M免费空间作为服务器,Next作为博客的主题。Next主题中又集成了多说的评论、分享系统和热评文章功能,百度统计服务和Swiftype站内搜索服务。
反正就是一锅乱炖吧,其实我也不太了解这些功能和服务,就一步步按教程走就好了。整个搭建耗时4天,其实1天就能把基本的东西搭建好,剩下的三天都在处理问题和完善细节。如题,这篇文章的目的并不是讲解如何搭建一个Hexo博客,而是记录我在搭建博客过程中遇到的问题,并给出我的解决方法。

搭建博客的准备

先放几个Windows环境下搭建Hexo博客的教程:

这类教程网上一搜一大把,这里给的是我觉得写得可以的。还有一个比较作弊一些的自动化搭建工具:

这个是我快搭好的时候发现的,不喜欢太傻瓜式的,且不想前功尽弃,所以我是没用过的,疗效如何我也不知道。
然后如果每个教程都大概看一下的话,可以发现每个教程的步骤不太一样,这就很讨厌了。其实上上周我就尝试过搭建,就是因为看的教程不对,所以刚开始就碰到了问题,于是放弃,拖了两周又重头再来。可见一个好的教程是成功他妈,下面是我看了几篇教程后自己的步骤:

  • 注册github账号,创建一个yourname.github.io的仓库
  • 买个喜欢的域名
  • 下载Node.jsGit
  • 利用Git安装Hexo,并进行本地测试
  • 部署本地文件到Github进行查看
  • Github Pages绑定域名
  • 安装Next主题,并进行优化
  • 博客搜索引擎推广

这里要进行注解的是,有的教程会让配置SSH密钥,SSH密钥可以为了防止其他人恶意部署文件到你的仓库,使用以后每次部署文件都需要登录Github账号,可以不配置。
有的教程中还会要求下载Github客户端,但我觉得没什么卵用。


曲折的路和路上的坑

路很长,慢慢来。

仓库的名字

仓库的名字的正确格式是github用户名.github.io,之前没仔细看,随便起了个,果断报错。

关于Git

Git是Git Bash不是Github更不是Github Shell,是一个命令行工具,长这个样子。
git-bash-image

我刚开始就搞错了,然后Hexo的安装就失败了。

Hexo本地测试的时候要注意:

1.Git要运行在本地Hexo的根目录下。
2.Git中Ctrl + C是stop的快捷键,不要使用Ctrl + CCtrl + V的快捷键,用右键。
3.优化主题时,修改Hexo根目录下的_config.yml站点配置目录后,要重新启动Hexo再刷新,修改next主题目录下的_config.yml主题配置目录则只需刷新即可.
4.本地测试是Hexo is running,Git显示如下,其他状态便无法连接

$ hexo s
INFO  Start processing
INFO  Hexo is running at http://localhost:4000/. Press Ctrl+C to stop.

如何绑定域名

绑定域名是个大坑,我有两天的时间卡在了这上面,所以这里要详细讲一下绑定的过程

ping出Github Pages的IP

具体方法是打开win的命令行工具CMD,输入

ping yourname.github.io

如图

ping

返回的23.235.47.133就是Github Pages的IP,我拿到这个IP后直接在浏览器输入,结果就是404

ip-404

我就很费解,为什么返回的ip找不到对象,然后我再次ping了一下
ping-error

WHAT THE FUCK?IP变成了185.31.18.133,是不是在玩我
biaoqing1

然后上网查教程,没错啊,就是这样啊,可为什么会出问题呢?然后就一直卡着,最后加了个Hexo群问了下,也没有人说出原因,根据后面的尝试觉得可能每个结果都是对的,也就是说填哪个都行

把获取的IP绑定到域名上

上一步有点混乱,我也不知道该绑定哪个IP,只好先试一下。看了网上的教程,很多人在DNSpod去绑定,如继利用github创建自己的博客(二)---绑定域名,我觉得在哪设置都行,就直接在阿里云的控制台设置了。
首先找到控制台-->产品与服务-->域名-->域名列表

aliyun

在你要设置的域名中点击解析
jiexi

如果首次修改可以选择新手引导设置,不是首次就只能选择修改了,修改的时候只要修改两个记录类型为A,主机记录分别为@www的行就可以了。
dns-set

新手引导设置只需修改网址解析
new

PS:有的教程中说要新建CNAME,然后指向yourname.github.io,我试了,并不行,和已建的有冲突
好了,域名设置好了,在浏览器输入

niujiajun.com

好了,接下来就是见证奇迹的时刻了


404

excuse me?怎么还是404,到底是哪出了问题,然后我又ping了一次拿新的ip绑定还是404,重新部署了文件直接无法显示网页了,重新申请个Github账号,然后重新绑定,还是404。


biaoqing2

搞了很久还是不行,后面在网上和群里问出,到这里域名绑定并没有结束,还差关键一步。

在yourname.github.io的根目录下添加CNAME

具体就是在Hexo目录里的source文件下添加一个名为CNAME的文件,注意这个文件是没有后缀的,千万不要设置成.txt文本文件,文件的内容就是域名,格式如:

niujiajun.com

添加后部署文件,这个时候再试,应该就成功了。


biaoqing3

其他步骤就按教程就行了。

搜索引擎推广时的注意

HTML验证文件

下载了验证文件后,部署到根目录下,点击完成验证,却发现


baidu

google

这是因为hexo编译文件时,会给下载的HTML文件中添加其他的内容,导致验证失败。
比如本机内google文件的原内容是

google-site-verification: google28a167413f7cb18a.html

Github里google文件的内容却是

<!doctype html>


<html class="theme-next mist use-motion">
<head>
  <meta charset="UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1" />
<meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1"/>

......

等等一大堆,所以需要在Github里手动修改验证HTML文件,或者不编译,只需执行

hexo c
hexo d

打开HTML文件只有一串字符


yanzheng

提交sitemap站点地图

教程中说需要在在博客目录的_config.yml中添加如下代码

#自动生成sitemap
sitemap:
path: sitemap.xml
baidusitemap:
path: baidusitemap.xml

然后编译,就会在博客根目录的public下面发现生成了sitemap.xml以及baidusitemap.xml。但我的情况是,不添加可以生成,添加后反而不能生成。
然后,我生成的文件如下

<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">

  <url>
    <loc>http://yoursite.com/2016/04/13/hello-world/</loc>
    <lastmod>2016-04-16T07:39:13.917Z</lastmod>
    <data>
        <display>
        <title>Hello World</title>
        <pubTime>2016-04-13T07:00:20.947Z</pubTime>

        </display>
    </data>
    </url>
</urlset>

可以看到,编译器并没有把yoursite.com改为niujiajun.com,这里需要手动修改,但有一点要注意的是修改后部署文件不能再编译(hexo g)了,因为编译了以后又会变回yoursite.com,所以写了新的文章后记得修改sitemap.xml。
然后把sitemap文件提交给搜索引擎就行了。

一些补充

hexo 命令

hexo new "postName" #新建文章
hexo new page "pageName" #新建页面
hexo generate #生成静态页面至public目录
hexo server #开启预览访问端口(默认端口4000,'ctrl + c'关闭server)
hexo deploy #将.deploy目录部署到GitHub
hexo help  # 查看帮助
hexo version  #查看Hexo的版本
hexo deploy -g  #生成加部署
hexo server -g  #生成加预览
命令的简写
hexo n == hexo new
hexo g == hexo generate
hexo s == hexo server
hexo d == hexo deploy

部署文件需要三步

hexo c
hexo g
hexo d

有时不需要hexo g

设置题目、分类、标签

在Markdown文件的开头添加

---
title: 你的题目
tags: 你的标签
category: 你的分类
---

如果使用hexo new命令新建文章则会自动生成

多个标签的设置

方式一:仿照Hexo配置文件中的写法

tags:
  - 前端
  - Hexo
  - HTML
  - JavaScript

方式二:伪JavaScript数组写法

tags: [前端,Hexo,HTML,JavaScript]

多个分类也是如此

设置索引目录里的图片

因为索引设置为提取文档前150个字符,所以想在索引目录中插入图片,就在文章开头插入图片即可。

首页只显示一篇文章

这好像是Next主题的一个bug,出现这种状况可以两次编译试一下

hexo c
hexo g
hexo g
hexo s

我也有过这种错误,但后面发现是自己md文件有错误,tags:后没加空格。注意命令行里错误信息

gitbash-error

这个错误就是在提示我md文件的tags标签处出现了错误。


回看一下好像也没什么难的,一步步按着教程来就可以了,有什么不懂的网上查一下就OK了。

end

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

推荐阅读更多精彩内容