Hexo博客搭建(Mac)

系统环境配置

• Node.js
• Git

配置Github

1. 创建代码库

2. 开启GitHub Pages功能

点击Automatic page generator，Github将会自动替你创建出一个Github pages的页面。你可以通过http://username.github.io 来访问你的个人主页。

安装Hexo

在自己认为合适的地方创建一个文件夹（以blog）为例，cd进该文件夹，在命令行中输入：

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

如果出现了以下情况，Hexo下载不下来：

可以尝试使用cnpm代替npm（后面的操作中如有类似问题，都可沿用此方法，后文不再赘述）

• 安装cnpm

• 使用sudo命令获取权限

这里会要求输入用户密码，之后便可成功安装。

接下来可以输入$ hexo -v查看是否安装成功：

（如果对我的“终端”感兴趣，可以戳这里：iTerm2 + oh my zsh )

初始化Hexo

接着输入$ hexo init
然后输入$ npm install，之后npm将会自动安装你需要的组件，只需要等待npm操作即可。

使用Hexo

配置Hexo

可以直接在_config.yml中进行修改，也可以在命令行中输入$ vi _config.yml直接进行修改，修改的内容可以参考官方文档

这里贴上一些必要的配置(记得改lwxwl）：

常用的命令

$ hexo generate (hexo g)   // 生成静态文件，会在当前目录下生成一个新的叫做public的文件夹
$ hexo server (hexo s)     // 启动本地web服务，用于博客的预览
$ hexo deploy (hexo d)     // 部署播客到远端（比如github, heroku等平台）
$ hexo new "postName"      // 新建文章
$ hexo new page "pageName" // 新建页面

// 常用的组合
$ hexo d -g                // 生成部署
$ hexo s -g                // 生成预览

更换主题

相关推荐

官网上收录了常用的一些主题，可以自行查找。
以下列出Github上Star较多的一些主题：

NexT

yilia

Material Theme

Ochuunn

还有很多好看又好用的主题，这里就不一一列举了……

相关操作（以NexT为例）

还是先cd进你的博客文件夹，参考对应主题所给出的下载方法，如：

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

接着修改_config.yml，找到theme字段，将其修改为对应的主题名称。

一些更加详细的配置要参考你所使用的主题和你的个人喜好而定。
最后走一遍流程：

$ hexo g
$ hexo s
$ hexo d

常见问题

这里推荐一个博客，里面整理的问题比较全面。

下面列出我搭博客时遇到的一些问题：

1. 页面没有渲染（partial转义失败）

解决方案：cd进博客所在目录下，执行$ npm install用以安装插件。

2.

解决方案：执行$ npm install hexo-deployer-git --save安装对应的deploy模块，检查_config.yml中deploy板块是否配置好了，若未配置好，参考上文配置Hexo板块进行配置。

相关链接

这里给出我搭博客时看到的一些比较好的链接，部分已在上文提及。

Hexo官网

Hexo博客搭建图文教程

Hexo + Github Pages搭建个人独立博客

Hexo常见问题解决方案

希望能帮助到大家٩(∗ ›ω‹ ∗)و
我的Github：https://github.com/lwxwl