About Hexo

Quick start

hexo 官方文档安装简略步骤：

首先确保安装了 node.js 以及 git
然后用npm安装hexo，执行npm install -g hexo-cli 或者 npm install hexo（后者是局部安装）
安装完 hexo 后开始建站，执行
bash
1
2
3
$ hexo init
$ cd
$ npm install
Hexo 将会在指定文件夹中新建所需要的文件
接着配置根目录下的配置文件 _config.yml ，详细配置信息见官方文档
配置完毕后执行 hexo generate 生成静态页面至 public 目录，此时再执行 hexo server 可以就在本地预览网站
选择好 deployer 后开始部署（以git为例）
- 修改配置
  必须先在 _config.yml 中修改参数：
  yml
  1
  2
  3
  4
  5
  deploy:
  type: git
  repo: #https://github.com/yourname/yourname.github.io.git
  branch: [branch]
  message: [message]
  - 安装 hexo-deployer-git
    Code
    1
    $ npm install hexo-d-eployer-git --save
  - 在 github 新建一个 repo 用于存放网站代码，repo 的名字必须为用户名.github.io，如Bessss-zyw.github.io（此用户名为 github 的用户名，最终部署网站网址）
  - 生成站点文件并推送至远程库。执行 hexo clean && hexo generate && hexo deploy
  - 将 github 上 repo 的默认分支设置为配置文件中的默认分支，over

换主题

在hexo主题库中选定一个，基本操作是在博客根目录里执行git clone命令把相应的theme文件复制下来，然后在根目录的_config.yml配置文件里把主题修改为theme: Butterfly（新主题的名称）。
我在更换主题（从原始的landscape到Butterfly）的时候碰到了本地运行结果正常，部署后浏览器上运行不正常的情况，后来执行了hexo clean之后恢复正常，问了dl后说可能是依赖冲突, emmm我查了一下看也太不懂也就暂时不管了。

Tips

使用 vscode 编辑md文件时：
vscode 默认支持 markdown 文件预览，使用 control + K(Windows) 或者command + K(mac) 然后按 V 就可以在右侧打开一个新的窗口用来实时预览markdown文件了

常用命令

hexo 常用指令

bash

hexo new post "postName" #新建文章
hexo new page "pageName" #新建页面
hexo generate/g #生成静态页面至public目录
hexo server #开启预览访问端口（默认端口4000，'ctrl + c'关闭server）
hexo deploy/d #将.deploy目录部署到GitHub
hexo help # 查看帮助
hexo version #查看Hexo的版本

git 常用指令

bash

1 2	git config --global user.name "Bessss-zyw" #设置全局用户名 git config --global user.email "123456789@qq.com" #设置全局邮箱

常见报错

出现 error deployer not found:git 或者 error deployer not found:github 的错误
解决办法：在本地执行 npm install hexo-deployer-git --save
出现 fatal: unable to auto-detect email address (got 'mac@macdeMBP-2.(none)') 或者 Please tell me who you are.
解决办法：未设置用户，可尝试执行git config --global user.name "bryan sun" #设置全局用户名 或者git config --global user.email "hitsjt@gmail.com" #设置全局邮箱
出现类似 FATAL can not read a block mapping entry; a multiline key may not be an implicit key at line 70, column 1: ... 错误
解决办法：_config.yml中配置项的冒号后面要用空格隔开，再跟内容；还有一种可能是在配置文件_config.yml中出现了形如'It sucks. But you'll love it.'单引号中套单引号的问题（亲身经历），记得去掉单引号中的单引号或者把句子外面的单引号去掉
中文乱码问题
解决办法：将文件的内容编码改为UTF8格式
'hexo sever'能够成功运行，但是localhost:4000无法访问
解决办法：执行hexo s -p 5000，改用其他端口启动

附

hexo 指令

bash

Usage: hexo <command>

Commands:
  clean     Remove generated files and cache.
  config    Get or set configurations.
  deploy    Deploy your website.
  generate  Generate static files.
  help      Get help on a command.
  init      Create a new Hexo folder.
  list      List the information of the site
  migrate   Migrate your site from other system to Hexo.
  new       Create a new post.
  publish   Moves a draft post from _drafts to _posts folder.
  render    Render files with renderer plugins.
  server    Start the server.
  version   Display version information.

Global Options:
  --config  Specify config file instead of using _config.yml
  --cwd     Specify the CWD
  --debug   Display all verbose messages in the terminal
  --draft   Display draft posts
  --safe    Disable all plugins and scripts
  --silent  Hide output on console

For more help, you can use 'hexo help [command]'for the detailed information, or you can check the docs: http://hexo.io/docs/.

资料来源

https://www.jianshu.com/p/8681ab76da08，作者比德鲁滨逊