HEXO+Github,搭建属于本身的博客

hexo是一款基于Node.js的静态博客框架, hexo github连接 ,这篇教程是针对与Mac的，参考连接，因为原文讲到的hexo是之前的老版本，因此如今的版本配置的时候会有些改动。

以前是想着写博客，一方面是给本身作笔记，能够提高本身的写做、总结能力，一个技术点咱们会使用，并不难，可是要作到让让别人也能听懂咱们讲得，仍是须要必定的技巧和经验的。不少相似于CSDN、博客园也均可以写文章，可是页面的样式我，不是太喜欢，简书还算好点得。最近看到一些大神们的博客,貌似都是用hexo写得,我也依葫芦画瓢的搭建了一个。不罗嗦了，直接上搭建步骤。

配置环境

安装Node（必须）

做用：用来生成静态页面的

到Node.js官网下载相应平台的最新版本，一路安装便可。

安装Git（必须）

做用：把本地的hexo内容提交到github上去.

安装Xcode就自带有Git，我就很少说了。

申请GitHub（必须）

做用：是用来作博客的远程创库、域名、服务器之类的，怎么与本地hexo创建链接等下讲。

github帐号我也再也不啰嗦了,没有的话直接申请就好了，跟通常的注册帐号差很少，SSH Keys，看你本身了，能够不配制，不配置的话之后每次对本身的博客有改动提交的时候就要手动输入帐号密码，配置了就不须要了，怎么配置我就很少说了，网上有不少教程。

正式安装Hexo

Node和Git都安装好后,首先建立一个文件夹,如blog,用户存放hexo的配置文件,而后进入blog里安装Hexo。

执行以下命令安装Hexo：

sudo npm install -g hexo

初始化而后，执行init命令初始化hexo,命令：

hexo init

好啦，至此，所有安装工做已经完成！blog就是你的博客根目录，全部的操做都在里面进行。

生成静态页面

hexo generate（hexo g也能够）

本地启动

启动本地服务，进行文章预览调试，命令：

hexo server

浏览器输入http://localhost:4000

我不知道大家能不能，反正我不能，由于我还有环境没配置好

配置Github

创建Repository

创建与你用户名对应的仓库，仓库名必须为【your_user_name.github.io】，固定写法

而后创建关联，个人blog在本地/Users/leopard/blog，blog是我以前建的东西也全在这里面，有：

    _config.yml    node_modules    public      source

    db.json        package.json    scaffolds  themes

如今咱们须要_config.yml文件，来创建关联，命令：

vim _config.yml

翻到最下面，改为我这样子的

deploy:

     type: git

     repo: https://github.com/leopardpan/leopardpan.github.io.git

     branch: master

而后执行命令：

npm install hexo-deployer-git --save

网上会有不少说法，有的type是github, 还有repository最后面的后缀也不同，是github.com.git，我也踩了不少坑，我如今的版本是hexo: 3.1.1，执行命令hexo -vsersion就出来了,貌似3.0后所有改为我上面这种格式了。

忘了说了，我没用SSH Keys若是你用了SSH Keys的话直接在github里复制SSH的就好了，总共就两种协议，相信你懂的。

而后，执行配置命令：

hexo deploy

而后再浏览器中输入http://leopardpan.github.io/就好了，个人github的帐户叫leopardpan,把这个改为你github的帐户名就好了

部署步骤

每次部署的步骤，可按如下三步来进行。

    hexo clean

    hexo generate

    hexo deploy

一些经常使用命令：

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的版本

报错总结

ERROR Deployer not found: git 或者 ERROR Deployer not found: github

解决方法： npm install hexo-deployer-git --save

如发生报错： ERROR Process failed: layout/.DS_Store , 那么进入主题里面layout和_partial目录下，使用删除命令：

rm-rf.DS_Store

ERROR Plugin load failed: hexo-server

缘由：

Besides,utilities are separated into a standalone module.hexo.util is not reachable anymore.

解决方法，执行命令：

sudo npm install hexo-server

执行命令hexo server，提示：Usage: hexo ....

缘由：

我认为是没有生成本地服务

解决方法，执行命令：

npm install hexo-server --save

提示：hexo-server@0.1.2 node_modules/hexo-server

....

表示成功了参考

这个时候再执行：

hexo-server

获得:

INFOHexois running at http://0.0.0.0:4000/.PressCtrl+C to stop.

这个时候再点击http://0.0.0.0:4000，正常状况下应该是最原始的画面，可是我看到的是：

白板和Cannot GET / 几个字

缘由：

因为2.6之后就更新了，咱们须要手动配置些东西，咱们须要输入下面三行命令：

npm install hexo-renderer-ejs --save

npm install hexo-renderer-stylus --save

npm install hexo-renderer-marked --save

这个时候再从新生成静态文件，命令：

hexo generate（或hexo g）

启动本地服务器：

hexo server（或hexo s）

再，点击网址http://0.0.0.0:4000OK终于能够看到属于你本身的blog啦，😄，虽然很简陋，但好歹有了一个属于本身的小窝了。参考连接，本地已经简单的设置好了，可是如今域名和服务器都是基于本身的电脑，接下来须要跟github进行关联。

主题推荐

这里有大量的主题列表使用方法里面

都有详细的介绍，我就很少说了。

我这里有几款我的认为不错的主题，免去大家，一个一个的选了，欢迎吐槽个人审美，😄

Cover- A chic theme with facebook-like cover photo

Oishi- A white theme based on Landscape plus and Writing.

Sidebar- Another theme based on Light with a simple sidebar

TKL- A responsive design theme for Hexo. 一个设计优雅的响应式主题

Tinnypp- A clean, simple theme based on Tinny

Writing- A small and simple hexo theme based on Light

Yilia- Responsive and simple style 优雅简洁响应式主题，我用得就是这个。

Pacman voidy- A theme with dynamic tagcloud and dynamic snow

一些基本路径

文章在source/_posts, 文章支持Markdown语法，可使用一些MarkDown渲染工具。若是想修改头像能够直接在主题的_config.yml文件里面修改，友情连接，之类的都在这里。开始打理你的博客吧，有什么问题或者建议，均可以提出来，我会继续完善的。

修改头像

我当前的路径/Users/leopard/blog/themes/yilia，ls 你能够看到

Gruntfile.js    _config.yml package.json

README.md  layout      source

vim _config.yml 进去，找到 #你的头像url avatar: 后接一个URL就好了，头像就修改为功了

修改主题和做者名字

我当前的路径/Users/leopard/blog，ls 你能够看到

_config.yml  node_modules    public      source      themes

db.json        package.json     scaffolds   ssh-keygen

vim _config.yml 进去，找到 author: 潘柏信，修改为你本身的名字就好了

修改主题，而后继续往下找到

# Extensions

## Plugins: http://hexo.io/plugins/

## Themes: http://hexo.io/themes/

theme:yilia

改为theme: yilia，theme:后面接你本身的主题名字就好了,而后分别执行

部署 hexo g

提交 hexo d

你的主题，和名字就修改为功了

Markdown语法参考连接

连接一

原文地址：https://www.jianshu.com/p/465830080ea9