hexo+github博客搭建

引言

个人之前用的是django加阿里云服务器搭建的个人博客，但是我发现这样的博客还是太麻烦了，费钱又费力(毕竟在使用的过程中也需要更新迭代)，所以有了hexo+github的这种简单省事的搭建博客。

环境准备

1. node.js
2. git

这两个应用windows用户直接搜索下载安装就可以。 如果习惯了使用linux命令的朋友，推荐windows神器cmder。 可以直接在windows环境下使用linux命令，样式可调，再也不要用黑乎乎的cmd了，而且自带git，完全可以不用下载windows git。

正式安装hexo

hexo官方中文文档

在node.js安装好的前提下，全局安装hexo 如何判断node.js是否安装成功？执行以下命令，如果能够看到版本号则说明安装成功了

node -v

安装hexo

npm install -g hexo-cli

自选合适的目录，新建文件夹

cd <folder>
hexo init
npm install

不再赘述，直接看官方文档。

配置github

新建仓库，仓库名必须为**[your_name.github.io]**

补充：本地配置github ssh连接，方便自动部署，以及clone你喜欢的主题(theme)

windows用户直接在c:/用户/youername/.ssh/下查看是否有id_rsa.pub文件。 没有的话命令行执行命令ssh-keygen -t rsa -C "your eamil"，会自动生成id_rsa.pub文件，打开后复制。

github->头像->Settings→SSH kyes→Add SSH key，粘贴复制的内容。

配置本地账户

git config --global user.name “your_username” #设置用户名
git config --global user.email “your_email” #设置邮箱地址,最好使用注册邮箱地址

测试是否配置成功

ssh -T git@github.com

hexo配置以及使用

有两个配置文件：

• 一个是根目录下的_config.yml称为站点配置文件
• 一个是themes/landscape/_config.yml称为主题配置文件(默认主题：landscape)

站点配置如下：

url: https://yourname.github.io/
theme: landscape #选择你想用的主题，我用的是indigo
deploy:
    type: git # 不要使用github
    repo: git@github.com:pengwenwu/pengwenwu.github.io.git # 使用ssh连接
    branch: master # 默认master分支
    message: add new blog # 自动部署commit备注，可不填

hexo常用命令

hexo命令参考

hexo n "我的博客" == hexo new "我的博客" #新建文章
hexo p == hexo publish
hexo g == hexo generate #生成
hexo s == hexo server #启动服务本地预览
hexo d == hexo deploy #部署
hexo clean #清除缓存 网页正常情况下可以忽略此条命令

hexo server #Hexo 会监视文件变动并自动更新，您无须重启服务器。
hexo server -s #静态模式
hexo server -p 5000 #更改端口
hexo server -i 192.168.1.1 #自定义 IP

在执行之前，记得安装自动部署 (–save 加不加的区别在于是否写入到依赖文件package.json中)

npm install hexo-deployer-git --save

正常本地预览，直接执行hexo s,如果要发布话最好执行clean命令，会去删除生成的public文件，完整部署命令:hexo clean && hexo g && hexo d。或者直接hexo d -g

注意问题

安装完自动部署后，是不需要本地git init新建仓库的。执行hexo g会在根目录生成public文件夹，自动部署， 本质是将public文件夹内容全部提交到仓库中去，默认会访问编译好的index.html。

如果部署完，访问your_name.github.io 404,可能有下面几个原因

1. 首先检查仓库文件，是不是全都是public的文件内容，如果整个本地blog文件夹都提交了，首先清空 仓库，然后删除本地.deploy_git文件夹，再重新部署
2. 文件有报错，本地hexo s观察是否有报错。

不喜欢原主题的朋友，可以github去找喜欢的主题。执行命令

git clone XXXX.next.git themes\next

这个会将新的主题下载到themes下对应的next目录，next为主题的名字。

主题的配置，可以看文档，修改对应的主题配置文件。
我使用的主题是fluid,详细文档fluid

markdown不会使用的朋友，参考链接markdown中文文档
如果没有ide的话，可以使用在线预览Cmd Markdown