Hexo博客 新手安装及使用教程


title: Hexo博客 新手安装及使用教程
date: 2017-10-07 14:46:55
tags: 教程


这是一篇基于Github搭建Hexo博客的基础教程,内容有:资源下载、安装步骤、发布更新文章、更换主题

资源下载

node.js

  • node.js ,官网下载地址,下载完成,双击打开,选择下一步安装即可。注:尽量下载最新版本,避免报错。

Git

  • Xcode自带Git

安装步骤

更换npm源

Node Package Manager 是node.js的模块依赖管理工具,由于国内有墙,使用时多有不便,国内有很多优秀的npm镜像。例如:

淘宝npm

cnpmjs

配置npm

1 . 临时使用

* npm --registry https://registry.npm.taobao.org install express

2 . 持久使用

* npm config set registry https://registry.npm.taobao.org
// 配置后可通过下面方式来验证是否成功

* npm config get registry
// 或npm info express

3 . 使用cnpm

* npm install -g cnpm --registry=https://registry.npm.taobao.org
// 使用cnpm install expresstall express

安装Hexo

1 . 终端执行

$ sudo npm install -g hexo

输入管理员密码(Mac登录密码)即开始安装 (sudo:linux系统管理指令 -g:全局安装)

2 . 创建博客文件夹

这里可以选择一个固定的位置建立一个文件夹,例如我在‘文档’下建立一个‘MyselfBlog’的文件,以后所有操作都在这个文件下进行。

cd 到选择的目录,执行:

$ hexo init MyselfBlog

cd 到MyselfBlog,安装npm,执行:

$ npm install

开启hexo 服务器,执行:

$ hexo s

浏览器中打开http://localhost:4000

没有问题就会显示如下页面:

如果,页面打开显示为空,4000端口被占用,终端执行:

$ hexo server -p 5000

如果是其他类型的错误,到官网排查。

关联Git

  • 登录github,新建仓库,注意命名规则‘用户名.github.io’,例如我的仓库名字就是‘SunShiLong.github.io’。仓库建立成功如下图:
  • cd 回到‘MyselfBlog’目录,打开_config.yml文件,找到下面这段代码:
deploy:
    type: git
    repository: https://github.com/XXX/XXX.github.io.git
    branch: master

注意:冒号后面有一个空格,把“XXX”换成自己仓库的名字。

  • 生成静态页面,执行:
$ hexo generate        或者:hexo g
// 此时若出现如下报错:
ERROR Local hexo not found in ~/blog
ERROR Try runing: 'npm install hexo --save'

// 则执行命令:
$ npm install hexo --save
// 若无报错,自行忽略此步骤。
  • 配置页面,执行:
$ hexo deploy            或者:hexo d

注意:若执行命令hexo deploy报错:无法连接git或找不到git,则执行如下命令来安装hexo-deployer-git:

 $ npm install hexo-deployer-git --save
  • 输入git账号和密码

打开网页地址

浏览器打开网址http://SunShiLong.github.io

本地打开http://localhost:4000 页面一致

发布文章

  • cd 到‘MyselfBlog’目录,新建文章,执行
$ hexo new "NewBlog"
  • 可以看到新建一个名为“NewBlog.md”的文件目录在MyselfBlog/source/_posts下,这里推荐使用markdown编辑博客,Mac端好用的编辑器有Mou和MacDown,但是Mou目前最高支持MacOS10.11,我的电脑系统是10.12,所有只好用MacDown。当然喜欢Vim的不受影响啦。

MacDown编辑器效果如下:

还不错吧,可以边码字边预览。

  • 文章编辑完成,接下来就可以发布了,还是执行下面两句:
$ hexo generate          //生成静态页面

$ hexo deploy            //部署到Github

NOW, Hexo博客搭建教程就告一段落了

更换主题

所有基于github建立的hexo博客,默认主题都是landscape,可以自定义的,到主题官网选好自己喜欢的主题,例如主题Ada

cd 到‘MyselfBlog‘目录,执行:

$ git clone https://github.com/shuiRong/hexo-theme-Ada.git themes/Ada
// 将MyselfBlog目录下_config.yml里theme的名称landscape修改为Ada

$ hexo clean         //清除缓存文件 (db.json) 和静态文件 (public)
$ hexo g             //生成缓存和静态文件
$ hexo d             //重新部署到服务器

每个主题都有详细的介绍,包括使用方法和内容修改,可以替换,名字、标题、图片、网址等。

原文地址

推荐阅读更多精彩内容