Mac 上 Hexo 的安装、使用和常见问题

Hexo 是一款基于 node.js 的静态博客框架,也是目前非常流行的个人博客框架。截至本文发布,在 GitHub 上已有 7846 个 Star 和 1306 个 Fork。

https://LeoDev.me

我的博客也是基于 Hexo 搭建而成的,在此谨向 Hexo 的作者表示感谢。


特性

  1. 风一般的速度
    Hexo 基于 node.js,支持多进程,几百篇文章也可瞬间生成。

  2. 流畅的撰写
    支持 GitHub Flavored Markdown 和所有 Octopress 的插件。

  3. 可扩展性
    Hexo 支持 EJS、Swig 和 Stylus。通过插件支持 Haml、Jade 和 Less.

下面将介绍如何在 Mac 上安装和使用 Hexo,也附上一些常见问题。

安装

  1. 安装 BrewHome

    1
    ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

    命令如果失效,请前往 BrewHome 官网 http://brew.sh(中文:http://brew.sh/index_zh-cn.html)查看最新命令。

  2. 安装 node.js

    1
    brew install node
  3. 安装 Hexo

    建议 不要在主目录下面执行后续操作,先创建一个文件夹再操作,如:

    1
    2
    mkdir ~/Documents/hexo
    cd ~/Documents/hexo

    然后执行安装:

    1
    npm install hexo --save

    至此 安装完成!

  4. 升级 Hexo

    1
    npm update hexo -g
  5. 卸载 Hexo

    1
    npm uninstall hexo

写新博客

  1. 创建 Markdown 文件

    1
    2
    3
    4
    5
    # 新建文章
    hexo new "Your Note's Name"

    # 新建页面
    hexo new page "About"
  2. 根据命令行提示去往当前目录下的 source/_posts/ 文件夹下,即可看到新创建的博客。

    推荐使用 Atom 编辑 Markdown 文件。

发布到 GitHub

  1. 清除历史文件

    1
    hexo clean
  2. 渲染新文件

    建议每次渲染前都执行一次 hexo clean

    1
    hexo g

    这一步你可以简单理解为把你的 Markdown 文件生成 HTML 文件。

  3. 发布到 GitHub

    1
    hexo d

    至此 发布完成!

  4. 本地预览

    1
    hexo s

    打开浏览器,输入网址 http://localhost:4040,回车即可看到预览。

    预览是个不错的功能。建议每次写完新文章,先不要急着发布到 GitHub,先本地预览下效果,适度修改,修改合适了再执行发布。

常见问题

  1. 有朋友反应在搭建 Hexo 时,在执行 hexo deploy 后,出现 ERROR: Deployer not found: git 的错误:

    By 老王

    怎么解决呢?很简单,在 vim 输入以下命令,回车即可:

    1
    npm install hexo-deployer-git --save

    耐心等待片刻,然后你应该能看到如下提示:

    By Leo

    搞定!

    继续尝试 hexo d,这下就能成功了!

拓展

  1. 生成 sitemap 站点地图

    百度站长:http://zhanzhang.baidu.com
    谷歌站点地图:https://www.google.com/webmasters/tools/sitemap-list

    1. 安装插件
    1
    2
    # google sitemap
    npm install hexo-generator-sitemap --save
    1
    2
    # baidu sitemap
    npm install hexo-generator-baidu-sitemap --save
    1. 在站点目录的 _config.yml 中添加如下代码:
    1
    2
    3
    4
    5
    sitemap:
    path: sitemap.xml

    baidusitemap:
    path: baidusitemap.xml
    1. 运行 hexo d 命令,在 public 目录下就能看到生成的 sitemap.xml 和 baidusitemap.xml。
  2. RSS

    1
    npm install hexo-generator-feed --save

一些想说的

GitHub Pages 作为一个开放的、免费的博客后台,给我们的才华和抱怨一个不错的施展和发泄空间。它和 GitHub 一样在天朝还能正常访问,希望各位同仁抱着一份感恩的心,不谈守护,请至少不要影响这篇乐土。

敬请遵守当地政府的法律法规,和谐发展,谢谢!

联系与捐赠

  • Mail: echo bGVvZGF4aWFAZ21haWwuY29tCg== | base64 -D
  • GitHub: iTofu
  • 如果你想对我的开发或是开源项目进行支持捐助,请扫描下方二维码,谢谢!👇

    LEO

🍭 支持一根棒棒糖!