Welcome to Hexo! This is your very first post. Check documentation for more info. If you get any problems when using Hexo, you can find the answer in troubleshooting or you can ask me on GitHub.

Quick Start

Install Hexo

1
2
$ npm install hexo -g #安装  
$ npm update hexo -g #升级

Hexo Upgrade

1
2
3
4
5
6
7
8
9
10
$ hexo -v                       #查看目前版本
$ npm install -g npm-check #安装npm-check
$ npm-check #查看系统插件是否需要升级
$ npm install -g npm-upgrade #安装npm-upgrade
$ npm-upgrade #更新package.json

#在执行npm-upgrade命令后会要求输入yes或者no,直接输入Yes或Y即可
$ npm update -g #更新全局插件
$ npm update --save #更新系统插件
升级成功之后继续输入:hexo -v #查看版本是否升级成功

输入hexo server查看是否存在警告,存在则按照提示信息进行解决即可
然后把node_modules目录删除后重新npm i就可以啦。
如果出错的话可以把package-lock.json文件删除再做这个操作。
支持_config.[theme].yml自定义配置覆盖功能,优先级如下:

1
theme_config > _config.[theme].yml > themes/[theme]/_config.yml

如果你也因为一顿命令行猛敲而将hexo弄没了,那么再次运行下面的命令你会发现hexo又回来了(不行就多输入几次):

1
$ npm install hexo-cli -g  #全局升级hexo

Create a new post

1
$ hexo new "My New Post"  == hexo n #新建文章

More info: Writing

Run server

1
$ hexo server == hexo s #启动服务预览

More info: Server

Generate static files

1
$ hexo generate == hexo g #生成 

More info: Generating

Deploy to remote sites

1
$ hexo deploy == hexo d #部署

More info: Deployment

Publish

1
$ hexo publish == hexo p #发布

监视文件变动

1
2
$ hexo generate          #使用 Hexo 生成静态文件快速而且简单
$ hexo generate --watch #监视文件变动

草稿

1
$ hexo publish [layout] <title>

模版(Scaffold)

1
2
3
$ hexo new [layout] <title>
$ hexo new photo "My Gallery"
$ hexo new "Hello World" --lang tw
变量 描述
layout 布局
title 标题
date 文件建立日期

设置文章摘要

  1. title: 使用Hexo搭建个人博客
  2. layout: post
  3. date: 2014-03-03 19:07:43
  4. comments: true
  5. categories: Blog
  6. tags: [Hexo]
  7. keywords: Hexo, Blog
  8. description: 再瞎折腾,我感觉要废。

写作

1
2
hexo new page <title>
hexo new post <title>
变量 描述
:title 标题
:year 建立的年份(4 位数)
:month 建立的月份(2 位数)
:i_month 建立的月份(去掉开头的零)
:day 建立的日期(2 位数)
:i_day 建立的日期(去掉开头的零)

推送到服务器上

1
2
3
$ hexo n #写文章
$ hexo g #生成
$ hexo d #部署 #可与`hexo g`合并为 `hexo d -g

报错

1.找不到git部署

1
ERROR Deployer not found: git

解决方法

1
npm install hexo-deployer-git --save

3.部署类型设置git

hexo 3.0 部署类型不再是github_config.yml 中修改

1
2
3
4
5
6
7
8
9
10
11
# Deployment

## Docs: http://hexo.io/docs/deployment.html

deploy:

type: git

repository: git@***.github.com:***/***.github.io.git

branch: master

4. xcodebuild

xcode-select: error: tool ‘xcodebuild’ requires Xcode, but active developer directory ‘/Library/Developer/CommandLineTools’ is a command line tools instance

1
$ npm install bcrypt