Hello Hexo

心血来潮重新搭建了一次 Hexo,过程还算顺利。本想着其实网上教程已经足够多了,随便搜一搜就能找到各种详尽的资料和教程,但是当我想起之前看到那条 Twitter 的时候,还是抱以分享的态度去试着写点东西。再此引用全文以激励阅读本文的读者和没有习惯更新博客的自己。

ruanyf ‏@ruanyf 3 月 25 日
不管你干什么,我都建议经常写作。随便写什么,不一定文辞优美,只需包含对自己领域的一些体会。不要低估写作的力量,它能让你从日常琐事抽身出来,透彻思考心中的问题。最重要的是,写给别人看时,你就成为更广阔世界的一部分。发表文字就是在宣称自己是社会一员,愿意做一些有意义的贡献。# 书摘

申请 GitHub Page

  1. 申请 GitHub 账号
  2. 登录 GitHub 后在主页点击 New repository,在 Repository name 中输入前缀与自己 GitHub 用户名一致的仓库名称 [用户名].github.io。例如,你的用户名为 helloworld,则创建仓库名称为 helloworld.github.io
  3. 勾选 Initialize this repository with a README 并创建仓库

PS:

  • 仓库名称前缀若与用户名不一致则无法成功申请 GitHub Page。
  • 仓库属性必须为公开,即必须为 Public

环境准备

  1. 安装所需的 Git BashNode.js 程序
  2. 按照 Github 官方教程 生成并添加 SSH 密钥到 Github 设置中。

安装&部署 Hexo

  1. 运行 Git Bash,使用如下命令安装 Hexo:

    $ npm install -g hexo-cli
  2. 安装完成后对 Hexo 进行部署,创建一个文件夹作为 Hexo 工作目录。为避免不必要的麻烦,建议使用英文路径。

  3. 运行 Git Bash 并进入 Hexo 工作目录,使用如下命令对 Hexo 进行初始化:

    $ hexo init
    $ npm install
  4. 安装 Hexo 插件,详细信息可以访问插件页面查看相关内容

    $ npm install hexo-generator-index --save      #首页生成插件
    $ npm install hexo-generator-archive --save #归档页生成插件
    $ npm install hexo-generator-category --save #分类页生成插件
    $ npm install hexo-generator-tag --save #标签页生成插件
    $ npm install hexo-renderer-marked --save #Markdown 语法渲染插件
    $ npm install hexo-renderer-stylus --save #Stylus 渲染插件
    $ npm install hexo-renderer-ejs --save #ejs 渲染插件
    $ npm install hexo-server --save #Hexo 本地服务器插件

    $ npm install hexo-deployer-git --save #git 部署插件(选装 推荐)
    $ npm install hexo-generator-feed --save #feed 生成插件(选装 推荐)
    $ npm install hexo-generator-sitemap --save #sitemap 生成插件(选装 推荐)
    $ npm install hexo-hey --save #hey 可视化后台编辑插件(选装 推荐)
    $ npm install hexo-tag-owl --save #Owl 多媒体插件(选装)
    $ npm install hexo-ruby-character --save #萌娘百科注音插件(选装)
    $ npm install hexo-generator-search --save #Search 生成插件(选装)
    $ npm install hexo-git-backup --save #使用 Github 备份博客(选装)
  5. 执行如下命令,访问 http://localhost:4000 即可本地预览 Hexo 页面

    $ hexo server

HEXO 基本操作

HEXO 命令需要在 Hexo 工作目录内运行。

新建文章

$ hexo new "My New Post" #创建一篇新文章,引号内为标题

More info: Writing

本地预览 Hexo 页面

$ hexo server
$ hexo s #命令简写

More info: Server

生成静态文件

$ hexo generate
$ hexo g #命令简写

PS:Hexo 是静态播客生成器,故修改博客内容后都需重新生成静态文件

More info: Generating

部署静态文件到远程站点

$ hexo deploy
$ hexo d #命令简写

More info: Deployment

生成静态文件并部署到远程站点

$ hexo g -d

清除 public 文件夹和数据库

$ hexo clean
$ rm db.json -f

参考资料

  1. Hexo 官方文档
  2. Hello Hexo by MeteoriteY