Hexo搭建个人博客


Hexo搭建个人博客

Hexo is a fast, simple and powerful blog framework. You write posts in Markdown (or other languages) and Hexo generates static files with a beautiful theme in seconds.

大致解释是:Hexo是一个快速,简单和强大的博客框架。你写的Markdown(或其他语言)的帖子Hexo在几秒钟内就能生成静态文件;

环境配置

安装Hexo非常容易。但是,你需要先安装几个其他的东西:

Node.js
作用:用来生成静态页面的 到Node.js官网下载相应平台的最新版本,一路安装即可。官网入口

Github账号
作用:用来做博客的远程创库、域名、静态资源服务器。怎么申请github的账号和ssh key等,请大家自行搜索,网络上资源还是很丰富的。

关联Github

添加ssh key到Github

检查SSH keys是否存在Github

执行如下命令,检查SSH keys是否存在。如果有文件id_rsa.pubid_dsa.pub,则直接进入步骤1.3将SSH key添加到Github中,否则进入下一步生成SSH key。

1
$ ls -al ~/.ssh

生成新的ssh key

执行如下命令生成public/private rsa key pair,注意将`your_email@example.com`换成你自己注册Github的邮箱地址。

1
$ ssh-keygen -t rsa -C "your_email@example.com"

默认会在相应路径下(~/.ssh/id_rsa.pub)生成id_rsa和id_rsa.pub两个文件。

将ssh key添加到Github中

Find前往文件夹~/.ssh/id_rsa.pub打开id_rsa.pub文件,里面的信息即为SSH key,将这些信息复制到Github的Add SSH key页面即可。

进入Github –> Settings –> SSH keys –> add SSH key:

Title里任意添一个标题,将复制的内容粘贴到Key里,点击下方Add key绿色按钮即可。

正式安装Hexo

nodejs和git都安装好后,可执行如下命令安装hexo:

1
$ sudo npm install -g hexo

初始化

创建一个文件夹,如:Blog,进入到Blog里分别执行init命令和安装依赖命令:

1
2
$ hexo init blog
$ npm install

生成静态页面

继续再Blog目录下执行如下命令,生成静态页面:

1
$ hexo generate      或 hexo g

安装hexo-server插件

1
$ sudo npm install hexo-server

本地启动

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

1
$ hexo server     或 hexo s

浏览器输入localhost:4000进行预览博客网站,是不是很简陋呢,但是好歹有一个自己的家园了,也是很兴奋呢。但是现在都是在本地进行的,需要和github进行关联。

配置Github

建立与你用户名对应的仓库,仓库名必须为【your_user_name.github.io】,固定写法 然后建立关联,例如我的是:luojinghui.github.io,此时,你的目录应该是这样子:

Blog
 |
 |-- _config.yml
 |-- node_modules
 |-- public
 |-- source
 |-- db.json
 |-- package.json
 |-- scaffolds
 |-- themes

现在我们需要修改_config.yml文件,用编辑器打开,翻到最后,改成这个样子(注意冒号后面的空格):

1
2
3
4
deploy:
type: git
repository: https://github.com/liyilian/liyilian.github.io
branch: master

执行如下命才能使用git部署(只需要执行一次):

1
$ npm install hexo-deployer-git --save

执行这个命令进行部署:

1
$ hexo deploy

然后在浏览器中输入 http://liyilian.github.io 就行了,我的 github 的账户叫 liyilian ,把这个改成你 github 的账户名就行了

备注

每次部署的步骤,可按以下三步来进行:

1
2
3
$ hexo clean
$ hexo generate
$ hexo deploy

简写:

1
2
$ hexo clean
$ hexo g -d

一些常用命令:

1
2
3
4
5
6
7
$ 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的版本

主题

这里面有很多主题,可以参考: Hexo官网主题页

图片路径

1.文章在 source/_posts下新建以.md为结尾的文件,编辑器可以用Webstrom、Sublime,支持 markdown 语法
2.修改头像可以直接在主题里的 _config.yml 文件里面修改,友情链接,之类的都在这里
3.创建文章的文件开头格式,可以用我现用的格式去写:

1
2
3
4
5
6
7
8
9
10
---
title: 填写标题
tags:
- tag1
- tag2
date: 2016/6/06 12:20:25
reward: 是否支持打赏,填写true或者false
keywords: 关键词1 关键词2...
description: 填写描述
---

4.如果想引用本地图片路径,以根路径作为起始点,就可以了。例如: /img/logo.png
开始打理你的博客吧,有什么问题下面留言,我会回复的。

Q&A

问:如何让文章想只显示一部分和一个 阅读全文 的按钮?
答:在文章中加一个 <!--more--><!--more--> 后面的内容就不会显示出来了。


问:如何添加多说评论?
答:在主题里的 _config.yml中找到duoshuo:,冒号后面填写你在多说申请用的域名,例如,我申请的是liyilian.duoshuo.com,那么,在这里就填写liyilian,就好了

转载请注明原地址,liyilian的博客:https://liyilian.github.io/ 谢谢!