HEXO+Github搭建博客

2016-10-17

文章目录

1. 配置环境
2. Github新建仓库和连接
3. 正式安装Hexo
4. Mac篇
5. Hexo下mathjax的转义问题

hexo是一款基于Node.js的静态博客框架。

之前是想着写博客，一方面是给自己做笔记，可以提升自己的写作、总结能力，这里记录一下linux下面Hexo搭建的步骤。

配置环境

安装Node.js
安装Git

Github新建仓库和连接

新建repository(仓库)

登陆Github账号后，点击右上角的“+”号按钮，选择“New repository”

在Create a new repository界面填写仓库名必须为【your_user_name.github.io】固定写法

填写完成点Create repository创建完成

生成SSH Keys：

我们如何让本地git项目与远程的github建立联系？这时候就要用到SSH Keys

使用ssh-keygen命令生成密钥对

1	ssh-keygen -t rsa -C"这里是你申请Github账号时的邮箱"

然后系统会要你输入密码：（我们输入的密码会在你提交项目的时候使用）

1 2	Enter passphrase (emptyforno passphrase):<输入加密串> Enter same passphrase again:<再次输入加密串>

（终端提示生成的文件路径）找到你生成的密钥找到id_rsa.pub用终端进入编辑，复制密钥。

添加你的SSH Key到ssh-agent

登陆Github,点击右侧用户按钮，选择Settings

点击 Add SSH key 按钮，将复制的密钥粘贴到 Key 栏

测试能不能链接成功

1	ssh -T git@github.com

执行结果

Permanently addedtheRSA host keyforIP address ‘192.30.252.130’tothelistofknown hosts.Are you sure you wanttocontinueconnecting (yes/no)?<输入yes>Hi username! You’ve successfully authenticated,butGitHubdoesnot

现在你已经可以通过SSH链接到Github了

正式安装Hexo

Node和Git都安装好后,首先创建一个文件夹,如blog,用户存放hexo的配置文件,然后进入blog里安装Hexo。我安装的是hexo 3.0以上的版本。

执行如下命令安装Hexo：

1	sudo npm install -g hexo-cli

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

hexo init

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

生成静态页面

1	hexo generate（hexo g也可以）

本地启动

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

1	hexo server

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

然后建立关联，blog文件夹下有：

_config.yml node_modules public source

db.json package.json scaffolds themes

现在我们需要修改_config.yml文件，翻到最下面，改成像我这样：

deploy:
     type: git
     repo: https://github.com/**gyh75520**/**gyh75520**.github.io.git
     branch: master

加粗的部分替换成前面的配置的your_user_name

然后执行命令：

1	npm install hexo-deployer-git --save

然后，执行配置命令：

1	hexo deploy

到这里项目已经部署到了github pages上

访问https://your_user_name.github.io

查看自己的博客吧O(∩_∩)O

备注：没有权限的话记得在命令前加上sudo

Mac篇

在mac配置，执行如下命令安装Hexo：

1	sudo npm install -g hexo-cli

报错:

npm ERR!

解决：把官方的源替换成淘宝的源，替换的方法

1 2	npm install -g cnpm --registry=https://registry.npm.taobao.org cnpm install -g hexo-cli

Hexo下mathjax的转义问题

我们平时使用markdown写文档的时候，免不了会碰到数学公式，好在有强大的Mathjax,可以解析网页上的数学公式，与hexo的结合也很简单，可以手动加入js，或者直接使用hexo-math插件.大部分情况下都是可以的，但是Markdwon本身的特殊符号与Latex中的符号会出现冲突的时候:

— 的转义，在markdown中，_是斜体，但是在latex中，却有下标的意思，就会出现问题。
\\\的换行，在markdown中，\\\会被转义为\\,这样也会影响影响mathjax对公式中的\\\进行渲染

解决办法：
参考 https://segmentfault.com/a/1190000007261752