hexo使用笔记

hexo
hexo
发布日期:   2021-07-31
更新日期:   2023-08-05
文章字数:   1.4k
阅读次数:  

1.前提工作

  • github(本文针对github，其他如gitee类似)
  • node.js、npm
  • git客户端
  • hexo(本文会介绍怎么安装)

2.搭建博客项目(h5)

  • 创建github仓库
    新建一个名为 {用户名}.github.io的仓库
  • 在settings-pages可以看到博客部署的地址

3.如何使用hexo

3.1 install(安装)

npm install -g hexo

3.2 hexo init(初始化)

随便找一个目录放代码(后面发博客内容等需要修改) 如d:/hexo
并初始化为hexo项目
cd d:/hexo
hexo init
这时候会自动生成一些文件
hexo init

3.3 hexo g(生成)

hexo g是hexo generate的缩写，用于在public文件夹生成最终的文件(.md文件会被生成.html文件)
hexo g

3.4 hexo s(启动服务)

hexo s是hexo server的缩写，用于本地启动服务，可以通过http://localhost:4000访问
hexo s

3.5 重要目录/文件的作用

文件夹 作用
source 存放静态文件的文件夹(包括md、图片等)
themes 模板库(可以网上下载到这里)
_config.yml 全局配置(如username等)

4.使用主题并写博客

一般我们下载网上的主题，就可以直接修改配置文件(_config.yml)来自定义页面内容

5.如何部署到远程{username.github.io}

5.1 配置git账户信息

deploy:
type: git
repository: git@github.com:GaryLeeeee/garyleeeee.github.io.git
branch: master

5.2 安装deployer插件

npm install hexo-deployer-git --save
如果没安装的话hexo d一般会报错”Deployer not found: github”或者”Deployer not found: git”

5.3 hexo d(部署)

hexo d是hexo doploy的缩写，用来部署服务到远程

6.如何写博客

6.1 hexo new xxx(新建博客)

通过hexo new ‘my-first-blog’即可创建一个名字为my-first-blog的微博文件

6.2 hexo new page xxx(新建页面)

与new不同的是他是生成一个页面，并不会以一个博客显示在目录中

6.3 博客配置

属性 作用
title 博客名
date 创建日期
tags 标签名(后面有讲)
categories 分类名(后面有讲)

7.常见问题

matery主题如果没有tags/categories/about页面？

新增标签tags页面(categories/about类似)
tags页是用来展示所有标签的页面，如果在你的博客source目录下还没有tags/index.md文件，那么你就需要新建一个，命令如下：

hexo new page “tags”

并且在生成的md文件中加上type和layout，如下

title: tags
date: 2021-07-31 16:40:30
type: “tags”
layout: “tags”

部署远程后没更新

删除本地.deploy_git目录，重新执行hexo d -g

如何上传本地图片

在source目录新建一个图片目录(如images)，然后在博客里引用(参考https://zhuanlan.zhihu.com/p/104996801)
![img.png](/images/img.png)

如何代码格式化

img.png
代码高亮优化后

部署异常（鉴权失败）

执行指令hexo d -g报错

On branch master
nothing to commit, working tree clean
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@    WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED!     @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
IT IS POSSIBLE THAT SOMEONE IS DOING SOMETHING NASTY!
Someone could be eavesdropping on you right now (man-in-the-middle attack)!
It is also possible that a host key has just been changed.
The fingerprint for the RSA key sent by the remote host is
SHA256:uNiVztksCsDhcc0u9e8BujQXVUpKZIDTMczCvj3tD2s.
Please contact your system administrator.
Add correct host key in /c/Users/Administrator/.ssh/known_hosts to get rid of this message.
Offending RSA key in /c/Users/Administrator/.ssh/known_hosts:1
RSA host key for github.com has changed and you have requested strict checking.
Host key verification failed.
fatal: Could not read from remote repository.

Please make sure you have the correct access rights
and the repository exists.
FATAL {
  err: Error: Spawn failed
      at ChildProcess.<anonymous> (E:\workplace\lee-blog\node_modules\hexo-util\lib\spawn.js:51:21)
      at ChildProcess.emit (node:events:513:28)
      at cp.emit (E:\workplace\lee-blog\node_modules\cross-spawn\lib\enoent.js:34:29)
      at ChildProcess._handle.onexit (node:internal/child_process:291:12) {
    code: 128
  }
} Something's wrong. Maybe you can find the solution here: %s https://hexo.io/docs/troubleshooting.

检查了本地ssh和远程github的ssh匹配，排除不匹配的可能性
执行ssh -T git@github.com，验证主机是否与github网站之间的ssh通信是否连接成功

Administrator@243Z59L59Q55VQT MINGW64 /e/workplace/lee-blog (master)
$ ssh -T git@github.com
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@    WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED!     @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
IT IS POSSIBLE THAT SOMEONE IS DOING SOMETHING NASTY!
Someone could be eavesdropping on you right now (man-in-the-middle attack)!
It is also possible that a host key has just been changed.
The fingerprint for the RSA key sent by the remote host is
SHA256:uNiVztksCsDhcc0u9e8BujQXVUpKZIDTMczCvj3tD2s.
Please contact your system administrator.
Add correct host key in /c/Users/Administrator/.ssh/known_hosts to get rid of this message.
Offending RSA key in /c/Users/Administrator/.ssh/known_hosts:1
RSA host key for github.com has changed and you have requested strict checking.
Host key verification failed.

发现known_hosts文件异常，尝试删除文件，并重新生成

Administrator@243Z59L59Q55VQT MINGW64 /e/workplace/lee-blog (master)
$ ssh -T git@github.com
The authenticity of host 'github.com (20.205.243.166)' can't be established.
ECDSA key fingerprint is SHA256:p2QAMXNIC1TJYWeIOttrVc98/R1BUFWu3/LiyKgUfQM.
Are you sure you want to continue connecting (yes/no)? y
Please type 'yes' or 'no': yes
Warning: Permanently added 'github.com,20.205.243.166' (ECDSA) to the list of known hosts.
Hi GaryLeeeee! You've successfully authenticated, but GitHub does not provide shell access.

Administrator@243Z59L59Q55VQT MINGW64 /e/workplace/lee-blog (master)
$ ssh -T git@github.com
Hi GaryLeeeee! You've successfully authenticated, but GitHub does not provide shell access.

可以看到校验成功了，重新执行hexo d -g

Administrator@243Z59L59Q55VQT MINGW64 /e/workplace/lee-blog (master)
$ hexo d -g
INFO  Validating config
INFO  Start processing
INFO  Files loaded in 640 ms

...

On branch master
nothing to commit, working tree clean
Counting objects: 1167, done.
Delta compression using up to 4 threads.
Compressing objects: 100% (738/738), done.
Writing objects: 100% (1167/1167), 7.87 MiB | 254.00 KiB/s, done.
Total 1167 (delta 397), reused 0 (delta 0)
remote: Resolving deltas: 100% (397/397), done.
To github.com:GaryLeeeee/garyleeeee.github.io.git
 + 06ab1b8...af6b499 HEAD -> master (forced update)
Branch master set up to track remote branch master from git@github.com:GaryLeeeee/garyleeeee.github.io.git.
INFO  Deploy done: git

搞定！

文章作者: GaryLee
文章链接: https://garyleeeee.github.io/2021/07/31/hexo-shi-yong-bi-ji/
版权声明: 本博客所有文章除特別声明外，均采用 CC BY 4.0 许可协议。转载请注明来源 GaryLee !
hexo
赏
  目录