×

Mac上搭建基于GitHub的Hexo博客

96
与佳期
2016.02.03 15:55* 字数 2728

原文 : 与佳期的个人博客(gonghonglou.com)

这是一篇详细文章来讲述用Mac搭建Hexo博客于Github上的完整历程, 也是踩了无数的坑搭起来的,现在写下些经验来分享,希望能帮大家少踩些坑。

曾买过一款阿里的云虚拟主机,后来才发现不能自己装软件只能上传网站程序,除非另买ECS,对于第一个月的实习工资还没拿到手的我想想还是算了,先用Wordpress搭起来玩玩吧。然而在上传网站程序中几次失败,本就觉得没劲,遂一怒转向Github。好了,废话少说,开始吧。

<h2 id="1">环境配置</h2>

Hexo官网上本就有对Hexo安装及使用的详细介绍,墙裂推荐。这里来讲述自己安装的亲身步骤,或有区别。

<h3 id="1.1">1.Node.js</h3>

用来生成静态页面。移步Node.js官网,下载v5.5.0 Stable 一路安装即可。

<h3 id="1.2">2.Git</h3>

用来将本地Hexo内容提交到Github上。Xcode自带Git,这里不再赘述。如果没有Xcode可以参考Hexo官网上的安装方法。

<h2 id="2">安装Hexo</h2>

当Node.js和Git都安装好后就可以正式安装Hexo了,终端执行如下命令:

$ sudo npm install -g hexo      

输入管理员密码(Mac登录密码)即开始安装 (sudo:linux系统管理指令 -g:全局安装)

注意坑一:Hexo官网上的安装命令是$ npm install -g hexo-cli,安装时不要忘记前面加上sudo,否则会因为权限问题报错。

<h3 id="2.1">初始化</h3>

终端cd到一个你选定的目录,执行hexo init命令:

$ hexo init blog

blog是你建立的文件夹名称。cd到blog文件夹下,执行如下命令,安装npm:

$ npm install

执行如下命令,开启hexo服务器:

$ hexo s

此时,浏览器中打开网址http://localhost:4000,能看到如下页面:

http://localhost:4000

本地设置好后,接下来开始关联Github。

<h2 id="3">关联Github</h2>

<h3 id="3.1">1.创建仓库</h3>

登录你的Github帐号,新建仓库,名为用户名.github.io固定写法,如gonghonglou.github.io即下图中1所示:

本地的blog文件夹下内容为:

_config.yml 
db.json 
node_modules 
package.json
scaffolds
source
themes

终端cd到blog文件夹下,vim打开_config.yml,命令如下:

$ vim _config.yml

打开后往下滑到最后,修改成下边的样子:

deploy:
  type: git
  repository: https://github.com/gonghonglou/gonghonglou.github.io.git
   branch: master     

你需要将repositorygonghonglou换成你自己的用户名,地址在上图2位置获取。hexo 3.1.1版本后type:值为git

注意坑二:在配置所有的_config.yml文件时(包括theme中的),在所有的冒号:后边都要加一个空格,否则执行hexo命令会报错,切记 切记

blog文件夹目录下执行生成静态页面命令:

$ hexo generate     或者:hexo g  

<pre>此时若出现如下报错:
ERROR Local hexo not found in ~/blog
ERROR Try runing: 'npm install hexo --save'

则执行命令:
npm install hexo --save

若无报错,自行忽略此步骤。</pre>

再执行配置命令:

$ hexo deploy           或者:hexo d

注意坑三:若执行命令hexo deploy仍然报错:无法连接git或找不到git,则执行如下命令来安装hexo-deployer-git

  $ npm install hexo-deployer-git --save      

再次执行hexo generatehexo deploy命令。

若你未关联Github,则执行hexo deploy命令时终端会提示你输入Github的用户名和密码,即

Username for 'https://github.com':
Password for 'https://github.com':

hexo deploy命令执行成功后,浏览器中打开网址http://gonghonglou.github.io(将gonghonglou换成你的用户名)能看到和打开http://localhost:4000时一样的页面。

为避免每次输入Github用户名和密码的麻烦,可参照第二节方法

<h3 id="3.2">2.添加ssh key到Github</h3>

<h4 id="3.2.1">1.1.检查SSH keys是否存在Github</h4>

执行如下命令,检查SSH keys是否存在。如果有文件id_rsa.pubid_dsa.pub,则直接进入步骤1.3将SSH key添加到Github中,否则进入下一步生成SSH key。

$ ls -al ~/.ssh

<h4 id="3.2.2">1.2.生成新的ssh key</h4>

执行如下命令生成public/private rsa key pair,注意将your_email@example.com换成你自己注册Github的邮箱地址。

$ ssh-keygen -t rsa -C "your_email@example.com"

默认会在相应路径下(~/.ssh/id_rsa.pub)生成id_rsaid_rsa.pub两个文件。

<h4 id="3.2.2">1.3.将ssh key添加到Github中</h4>

Find前往文件夹~/.ssh/id_rsa.pub打开id_rsa.pub文件,里面的信息即为SSH key,将这些信息复制到Github的Add SSH key页面即可。

进入Github --> Settings --> SSH keys --> add SSH key:

Title里任意添一个标题,将复制的内容粘贴到Key里,点击下方Add key绿色按钮即可。

<h3 id="3.3">3.发布文章</h3>

终端cd到blog文件夹下,执行如下命令新建文章:

hexo new "postName" 

名为postName.md的文件会建在目录/blog/source/_posts下。你当然可以用vim来编辑文章。我在用Mou编辑器,支持预览,虽然其预览主题并非我喜欢,如果你有好用的markdown编辑器请推荐给我,感激不尽!

文章编辑完成后,终端cd到blog文件夹下,执行如下命令来发布:

hexo generate           //生成静态页面

<pre>hexo deploy //将文章部署到Github</pre>

至此,Mac上搭建基于Github的Hexo博客就完成了。下面的内容是介绍安装theme,添加评论功能和绑定个人域名,如果有兴趣且还有耐心的话,请继续吧。

<h2 id="4">安装theme</h2>

你可以到Hexo官网主题页去搜寻自己喜欢的theme。这里以hexo-theme-next为例

终端cd到 blog 目录下执行如下命令:

$ git clone https://github.com/iissnan/hexo-theme-next themes/next

blog目录下_config.ymltheme的名称landscape修改为next

终端cd到blog目录下执行如下命令(每次部署文章的步骤):

$ hexo clean           //清除缓存文件 (db.json) 和已生成的静态文件 (public)

<pre>$ hexo g //生成缓存和静态文件</pre>

<pre>$ hexo d //重新部署到服务器</pre>

至于更改theme内容,比如名称,描述,头像等去修改blog/_config.yml文件和blog/themes/next/_config.yml文件中对应的属性名称即可, 不要忘记冒号:后加空格。 NexT 使用文档里有极详细的介绍。

<h2 id="5">绑定个人域名</h2>

现在使用的域名是Github提供的二级域名,也可以绑定为自己的个性域名。购买域名,可以到GoDaddy官网,网友亲切称呼为:狗爹,也可以到阿里万网购买。我是在万网买的,可直接在其网站做域名解析。

<h3 id="5.1">1.Github端</h3>

/blog/themes/landscape/source目录下新建文件名为:CNAME文件,注意没有后缀名!直接将自己的域名如:gonghonglou.com写入。

终端cd到blog目录下执行如下命令重新部署:

$ hexo clean

<pre>$ hexo g</pre> <pre>$ hexo d</pre>

注意坑四:网上许多都是说在Github上直接新建CNAME文件,如果这样的话,在你下一次执行hexo d部署命令后CNAME文件就消失了,因为本地没有此文件嘛。

<h3 id="5.2">2.域名解析</h3>

如果将域名指向一个域名,实现与被指向域名相同的访问效果,需要增加CNAME记录。登录万网,在你购买的域名后边点击:解析 --> 添加解析

记录类型:CNAME

主机记录:将域名解析为example.com(不带www),填写@或者不填写

记录值:gonghonglou.github.io. (不要忘记最后的.gonghonglou改为你自己的用户名),点击保存即可,如下图:

域名解析

此时,点击访问http://gonghonglou.com和访问http://gonghonglou.github.io效果一致,大功告成!

------11.10更新 以下------------------------------------------------

1、解决 deploy 后博客空白问题

昨晚更新了一下 blog 做了个部署,结果blog就挂了,打开 gonghonglou.com 页面显示一片空白。然而 hexo s 开启本地服务器 localhost:4000 访问是没问题的。
上网查了一下,原来是 GitHub Pages 禁止了 source/vendors 目录的访问。Github 在 11 月 3 日更新了版本。其中包括升级了 Jekyll 到 3.3。Jekyll 为了加快构建速度,忽略 vendornode_modules 文件夹。所以部署到 GitHub 后,识别不到本地下的的这个文件夹 blog/themes/next/source/vendor,你只需要给这个文件夹换个名字再重新部署一次就 OK 了。nexT 在 GitHub 上的 isusses 已经给出了解决方案:#1214

#1214

还有另一种解决方案就是升级 nexT 主题,cd 到 blog/themes/next/ 下执行命令 git pull 更新。
然而,有可能升级后多说评论等第三方工具会失效,慎用。

2、将个人博客同时部署到 GitHub 和 Coding

1、首先到 Coding 上注册并开一个项目,项目名称和用户个性后缀相同(方便二级域名访问博客),拿到项目的 https 地址

2、打开本地 blog 目录下的 _config.yml 文件,修改如下

deploy:
  type: git
  repository: 
            github: https://github.com/gonghonglou/gonghonglou.github.io.git
            coding: https://git.coding.net/gonghonglou/gonghonglou.git
  branch: master

3、cd 到本地 blog/source 目录下执行如下命令新建 Staticfile 文件

$ touch Staticfile  #名字必须是Staticfile

原因是 coding.net 需要以这个文件来作为静态文件部署的标志,就是说看到这个 Staticfile 就知道按照静态文件来发布。

4、执行发布命令 hexo ghexo d

5、个人域名添加两条 CNAME 解析。将 gonghonglou.github.io. 解析为 [海外] ,将 gonghonglou.coding.me. 解析为 [默认]

这样就是为了从国内访问 gonghonglou.com 就是访问 Coding 上的博客项目,从国外访问 gonghonglou.com 就是访问 GitHub 上的博客项目。

6、到 Coding 上的博客项目主页,点击 Pages服务 输入部署分支 master 立即开启

这样就可以访问自己在 Coding 上的个人博客了 gonghonglou.coding.me/gonghonglou 如果像这样你的用户后缀名与博客项目名称相同你还可以省略项目名称直接访问 gonghonglou.coding.me

7、添加域名绑定,输入个人域名就 OK 了,可能需要耐心等待几分钟,这样在国内访问自己的博客就快得多了。

试了一下在国内访问 gonghonglou.com 拦不住 要飞起来了😂

------11.10更新 以上------------------------------------------------

<h2 id="6">后记</h2>

以上便是我搭建与佳期的个人博客(gonghonglou.com)的全过程,希望对大家有所帮助,欢迎吐槽~

转载请保留原文地址:http://gonghonglou.com/2016/02/03/firstblog

<h2 id="7">参考链接</h2>

日记本
Web note ad 1