Hexo静态博客搭建

准备工作

-Git
-Node.js

小提示

      按照提示正确安装上述软件即可~如果不懂可以直接一直下一步傻瓜式安装
个人初次安装环境为 Windows 8.1,后续由于更换平台在 Windows 10 、macOS Sierra 做过类似安装工作,除安装路径不要存在中文外,其他类似。

​ 另:在 Linux 或者 Mac 下安装,如果熟悉终端操作,通过命令行感觉上会方便一些。


详细过程

一 安装Hexo

1
npm install -g hexo-cli

三 初始化Hexo

初始化Hexo到指定路径:

1
hexo init <folder>

也可以到相应的路径下:

1
hexo init

四 生成静态界面

1
hexo g

​ 命令必须在init目录下执行,否则不成功,但是也不报错。
当你修改文章Tag或内容,不能正确重新生成内容,可以删除hexo\db.json 后重试,还不行就到 public 目录删除对应的文件,重新生成。

五 本地启动

执行如下命令,启动本地服务,进行文章预览调试:  
1
hexo s
执行之后可以在浏览器输入[localhost:4000](localhost:4000)进行预览调试  

      ps:建议使用高版本浏览器,否则可能……

六 主题更换

      Hexo提供了很多的博客主题供大家更换,详情可以登录Hexo官网点击Themes选项,或者网友提供的主题
1、主题安装(一行git命令):

1
git clone https://github.com/#主题地址

2、安装完成后,打开 hexo_config.yml ,修改主题为:

1
theme: #选择的主题名

3、hexo\themes\modernist 目录,编辑主题配置文件 _config.yml:
      根据相应的主题介绍可以自行修改,每个主题的某些代码会有出入。

4、更新主题

1
2
cd themes/#主题根目录
git pull

七 后期优化

部分插件:

站点地图
install hexo-generator-sitemap --save
1
npm install hexo-generator-sitemap --save
RSS 订阅

用来生成配置文件中经常看到的那个 /atom.xml

1
npm install hexo-generator-feed@1.0.3 --save

问题总结

  • 在 yml 文件中,代码之后要有一个空格,否则会报错。
  • ERROR Deployer not found:git,即部署到Git时候出错。

问题原因:在 Hexo 3.0版本后 deploy git 被分开的,所以需要安装 deploy git

安装命令:

1
npm install hexo-deployer-git --save
  • 因更换笔记本,将博客迁移到 Mac 下,需要注意的是:要安装 Xcode ,Hexo 需要用到其中的命令行工具编译。

重新搭建中,下载 Hexo 后执行 Hexo init 遇到:

1
2
ERROR Local hexo not found in ~
ERROR Try running: 'npm install hexo --save'

发生上面的问题,我们很容易发现 Hexo 并没有正确的安装,发生原因可能是因为某些网络原因,导致未能正确下载完整的 Hexo ,所以我们可以换用淘宝源 ,或者使用:

1
npm install -g hexo-cli --no-optional
  • 文章之前写了不少关于 添加文章目录、多说动态评论框、CDN 加速等,现在很多主题都在集成这些服务,所有这次更新直接删掉,之后有遇到问题会陆续在此文章更新。

###

坚持原创技术分享,您的支持将鼓励我继续创作!
0%