hexo初体验

node.js

安装node.js

去官网现在并安装，这里安装路径选到D:\nodejs

改变原有的环境变量

我们要先配置npm的全局模块的存放路径以及cache的路径，例如我希望将以上两个文件夹放在NodeJS的主目录下，便在NodeJs下建立”node_global”及”node_cache”两个文件夹，输入以下命令改变npm配置

npm config set prefix "D:\nodejs\node_global"
npm config set cache "D:\nodejs\node_cache"

这个不配置也可以？（在系统环境变量添加系统变量NODE_PATH，输入路径D:\nodejs\node_global\node_modules）
此后所安装的模块都会安装到改路径下

安装淘宝npm（cnpm）

输入以下命令

npm install -g cnpm --registry=https://registry.npm.taobao.org

输入cnpm -v输入是否正常

cnpm -v

安装部署hexo + github page

初体验

npm install -g hexo-cli

本地目录 hexo 文件夹，进去这个文件夹，依次执行下面的命令

cd hexo
hexo init
# Hexo随后会自动在目标文件夹建立网站所需要的文件
npm install

启动本地Hexo服务

hexo server

Create a new post

hexo new 'blog name'

在hexo new文章时，需要stop server，否则会出现2次这个文章

执行下面的命令，将markdown文件生成静态网页

hexo generate

更换主题

cd themes
git clone https://github.com/litten/hexo-theme-yilia.git

配置主题 _config.yml 文件，修改里面的 theme 为 hexo-theme-yilia

配置github仓库

在_config.yml 文件最后添加如下内容

# Deployment
## Docs: http://hexo.io/docs/deployment.html
deploy:
  type: git
  repository: https://github.com/xxx/xxx.github.io.git
  # ssh模式
  #repository: https://github.com/xxx/xxx.github.io.git
  branch: master

配置好后，依次执行

hexo clean
hexo g
hexo d

出现 Deploy done: git 说明配置成功

如果提示 ERROR Deployer not found: git，则要安装 hexo-deployer-git 插件

cd hexo
npm install hexo-deployer-git --save

部署到github，每次部署可以执行一下命令

hexo clean
hexo generate
hexo deploy

绑定域名

在你本地的 hexo 项目根目录的 source 目录下创建 CNAME 文件，并在 CNAME 中输入绑定的域名

使用问题

hexo d出现错误

执行hexo clean && hexo g && hexo d出现一下错误，多试几次又成功了，之后没有继续追查问题

fatal: TaskCanceledException encountered.
   ▒▒ȡ▒▒һ▒▒▒▒▒▒
bash: /dev/tty: No such device or address
error: failed to execute prompt script (exit code 1)
fatal: could not read Username for 'https://github.com': No error
FATAL Something's wrong. Maybe you can find the solution here: http://hexo.io/docs/troubleshooting.html
Error: fatal: TaskCanceledException encountered.
   ��ȡ��һ��������
bash: /dev/tty: No such device or address
error: failed to execute prompt script (exit code 1)
fatal: could not read Username for 'https://github.com': No error

    at ChildProcess.<anonymous> (D:\Workspace\foreveryang321.github.io\node_modules\hexo-util\lib\spawn.js:37:17)
    at emitTwo (events.js:106:13)
    at ChildProcess.emit (events.js:191:7)
    at ChildProcess.cp.emit (D:\Workspace\foreveryang321.github.io\node_modules\cross-spawn\lib\enoent.js:40:29)
    at maybeClose (internal/child_process.js:886:16)
    at Process.ChildProcess._handle.onexit (internal/child_process.js:226:5)

hexo d出现 TypeError 错误

TypeError [ERR_INVALID_ARG_TYPE]: The "mode" argument must be integer. Received an instance of Object
    at copyFile (node:fs:2821:10)
    at go$copyFile (/Users/yl/Documents/workspace/github/foreveryang321.github.io/node_modules/graceful-fs/graceful-fs.js:181:14)
    at copyFile (/Users/yl/Documents/workspace/github/foreveryang321.github.io/node_modules/graceful-fs/graceful-fs.js:178:12)
    at tryCatcher (/Users/yl/Documents/workspace/github/foreveryang321.github.io/node_modules/bluebird/js/release/util.js:16:23)
    at ret (eval at makeNodePromisifiedEval (/Users/yl/.nvm/versions/node/v16.19.1/lib/node_modules/hexo-cli/node_modules/bluebird/js/release/promisify.js:184:12), <anonymous>:13:39)
    at /Users/yl/Documents/workspace/github/foreveryang321.github.io/node_modules/hexo-deployer-git/node_modules/hexo-fs/lib/fs.js:181:12
    at tryCatcher (/Users/yl/Documents/workspace/github/foreveryang321.github.io/node_modules/bluebird/js/release/util.js:16:23)

解决方案：node版本过高导致的，切换到 v10.x 或者 v12.x 版本即可

hexo: 3.9.0
hexo-cli: 4.3.1
os: darwin 21.6.0 12.7.1

node: 16.19.1
v8: 9.4.146.26-node.24
uv: 1.43.0
zlib: 1.2.11
brotli: 1.0.9
ares: 1.18.1
modules: 93
nghttp2: 1.47.0
napi: 8
llhttp: 6.0.10
openssl: 1.1.1t+quic
cldr: 41.0
icu: 71.1
tz: 2022f
unicode: 14.0
ngtcp2: 0.8.1
nghttp3: 0.7.0

图片显示问题

使用hexo-abbrlink和`hexo-asset-image@0.0.3`会导致图片路径问题。

hexo-asset-image@0.0.5版本已经修复该问题

或者参考：https://github.com/foreveryang321/hexo-asset-image