怎么使用hexo在github上面搭建个人博客

Created at 2016-09-04 Updated at 2017-07-15 Category 2016年9月 Tag 杂文

简要说明

本篇博客是记录自己怎么搭建起这个博客，以及过程中遇到什么问题，如何解决这些问题。

了解Hexo

hexo

安装GIT

GitHub Windows

安装Node.JS

Node.JS

安装hexo

在安装完GIT后，桌面上会出现Git Shell，打开后，输入npm命令就可以安装

1 2	$ npm install hexo-cli -g $ npm install hexo --save

hexo的配置

根据自己的习惯，选择把hexo配置在哪里（比如：C:\OTHER\Program\GitHub\hexo），通过Git Shell,切换到该路径下面：

1	$ hexo init

或者可以

1
2
3

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

安装hexo插件

npm install hexo-generator-index --save
npm install hexo-generator-archive --save
npm install hexo-generator-category --save
npm install hexo-generator-tag --save
npm install hexo-server --save
npm install hexo-deployer-git --save
npm install hexo-deployer-heroku --save
npm install hexo-deployer-rsync --save
npm install hexo-deployer-openshift --save
npm install hexo-renderer-marked@0.2 --save
npm install hexo-renderer-stylus@0.2 --save
npm install hexo-generator-feed@1 --save
npm install hexo-generator-sitemap@1 --save

本地查看效果

1	$ hexo server

部署到github上面

申请一个github账号（怎么创建仓库，以及使用可以阅读官网文档GitHub）
打开之前下载安装在桌面的Github，点击左上角的+，自己取一个名字，然后把Local Path选择自己习惯的位置（比如：C:\OTHER\Program\GitHub\MBlog），个人放在hexo的旁边。
git Shell回到hexo文件夹下执行hexo g命令，会生成一个Public文件夹。
PS:
$ hexo g == hexo generate（生成静态文件）
$ hexo s == hexo server（启动服务器）
$ hexo d == hexo deploy(部署到github上面。)
把public文件夹里面的东西拷贝到之前Local Path的根目录下面。
在桌面Github上面确定提交信息后，点又上角的syn同步
可以到网页的Github中心查看，并且知道自己的网址（比如：https://xmhuster.github.io/MBlog/
这样就发布完成了

主题

hexo提供了很多主题可以供选择，主题点击进去都有模板可以参考修改，官网也有很好的文档。

写文章

怎么写文章呢，这里是用Markdown，语法真的非常简单，只要看一下就能使用。参考文档
注意：Markdown目前还不支持Win10，但是解决办法肯定还是有的。如果是Win10系统需要下载安装一下awesomium

怎么使用Disqus安装评论

1.首先到Disqus官网注册一下。
2.GetStart->I want to install Disqus on my site->create a new site(填写一些名称和自己的网站地址)->save。这样子就完成了并且生成了一个shortname。
3.在hexo目录下的config.yml里面配置一下。我的版本是有这个disqus_shortname: 之前把之前的shortname写上去就可以了。

问题

Q：为什么本地的Localhost:4000页面能很好的显示主题，但是发布到Github上面却显示不了，没有渲染成功？
A：有几种可能性：
1，_config.yml里面的url没有配置好。
2.没有安装主题所需要的插件,下面是hexo官方原话，大家可以在themes文件夹里面主题文件夹（比如说:jacman）的Layout里面可以看到是以Swig结尾的还是Ejs结尾的，如果是EJS结尾的需要另外安装插件。(具体可以点击下面的EJS查看)

Layout folder. This folder contains the theme’s template files, which define the appearance of your website. Hexo provides the Swig template engine by default, but you can easily install additional plugins to support alternative engines such as EJS, Haml or Jade. Hexo chooses the template engine based on the file extension of the template.

3.在网页版的Github上面，需要建分支，合并提交等。（不清楚的看官方文档）

总结感悟

1.这次从搭建到发布到github上面大概只用了一两个小时，相比于之前用了很多个晚上都没有搭建起来，我觉得是我所参考的资料不一样的原因，这次用谷歌查到的资料，思路清晰，步骤详细，方法正确。
推荐一个最近刚使用并且效果不错的翻墙工具：Lantern
2.可以通过别人的博客了解到一个东西，但是想真正使用掌握一个知识，个人认为还是看官方文档最受益