Hexo的使用
Tamako

前置

Git

通过淘宝镜像找到最新的版本进行下载。

配置用户信息

1
2
git config --global user.name "v_hiker"
git config --global user.email "v_hiker@qq.com"

如果用了--global选项,那么更改的配置文件就是位于你用户主目录下的那个,以后你所有的项目都会默认使用这里配置的用户信息。如果要在某个特定的项目中使用其他名字或者电邮,只要去掉--global选项重新配置即可,新的设定保存在当前项目的.git/config文件里。

要检查已有的配置信息,可以使用:

1
git config --list

删除配置,使用:

1
git config --unset user.name

代理

Clash为例:

1
git config http.proxy=http://127.0.0.1:7890

配置SSH

1
ssh-keygen -t rsa -C "v_hiker@qq.com"

一路回车即可。在C:\Users\wangy\.ssh这个路径下会生成两个文件:id_rsaid_rsa.pub

网页进入Github,找到Settings=>SSH and GPG keys=>New SSH key,添加id_rsa.pub中的内容。

Node.JS

nvm

Windows上通过三方管理工具进行管理node.Js版本,这里使用nvm

  1. 根据官方文档在PowerShell中输入安装脚本进行安装。
    1
    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
  2. 重新打开终端,检查nvm安装情况。
    1
    nvm --version
  3. 查看所有可供安装的node.Js版本。
    1
    nvm ls available
  4. 选择自己想要的版本进行安装。
    1
    nvm install v11.11.0
  5. 查看本地已安装的node.Js
1
nvm ls

安装完nvm之后,通过命令可以很简单地切换node.Js版本

1
nvm use 18.13.0

npm配置

国内配置淘宝镜像加速下载:

1
npm config set registry "https://registry.npmmirror.com/"

恢复:

1
npm config set registry "https://registry.npmjs.org/"

查看是否更改成功:

1
npm config get registry

使用npm查看包版本:

1
npm ls -g --depth 0

其中,-g代表全局,不查看全局去除即可。

检查更新:

1
npm outdated

需要更新模块,首先得更新package.json文件,可使用npm-check-updates依赖包

1
2
3
4
5
6
7
8
9
10
# 安装"npm-check-updates"模块
npm install -g npm-check-updates

# 安装后,检查可更新的模块
ncu
# 或
npm-check-updates

# 更新package.json的依赖包到最新版本
ncu -u

安装

按照官方文档很详细

1
npm install -g hexo-cli

安装 Hexo 完成后,执行下列命令,Hexo 将会在指定文件夹中新建所需要的文件。

1
2
3
hexo init <folder>
cd <folder>
npm install

这里hexo要求为空文件夹,所以版本控制需要后面进行关联.

安装完成后进入文件夹,执行预览命令,即可预览效果:

1
hexo s

根据输出打开链接即可:

1
2
3
4
INFO  Validating config
INFO Start processing
INFO Hexo is running at http://localhost:4000/ . Press Ctrl+C to stop.
INFO Catch you later

插件

hexo-deployer-git

用于 一键部署Github Pages,参考官方文档

1
npm install hexo-deployer-git --save

hexo-generator-searchdb

支持本地搜索, 安装命令:

1
npm install hexo-generator-searchdb --save

hexo-generator-sitemap

部署时生成sitemap文件, 安装命令:

1
npm install hexo-generator-sitemap --save

hexo-generator-baidu-sitemap

百度所需sitemap生成器, 安装命令:

1
npm install hexo-generator-baidu-sitemap --save

hexo-symbols-count-time

统计文章字数, 安装命令:

1
npm install hexo-symbols-count-time

生成永久链接

Add plugin to Hexo:

1
npm install hexo-abbrlink --save

Modify permalink in config.yml file:

1
permalink: posts/:abbrlink/

There are two settings:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
alg -- Algorithm (currently support crc16 and crc32, which crc16 is default)
rep -- Represent (the generated link could be presented in hex or dec value)
# abbrlink config
abbrlink:
alg: crc32 #support crc16(default) and crc32
rep: hex #support dec(default) and hex
drafts: false #(true)Process draft,(false)Do not process draft. false(default)
# Generate categories from directory-tree
# depth: the max_depth of directory-tree you want to generate, should > 0
auto_category:
enable: true #true(default)
depth: #3(default)
over_write: false
auto_title: false #enable auto title, it can auto fill the title by path
auto_date: false #enable auto date, it can auto fill the date by time today
force: false #enable force mode,in this mode, the plugin will ignore the cache, and calc the abbrlink for e

具体使用时根据相关官方页面进行配置。

主题

主题市场中进行选择,并按照文档安装。
为了保持配置的备份和方便修改,可以在Hexo根目录创建独立的_config.[theme].yml文件。
Hexo在合并主题配置时,Hexo配置文件中的theme_config的优先级最高,其次是_config.[theme].yml文件,最后是位于主题目录下的_config.yml文件。

备份

  1. 新建私有仓库,复制远程地址,以下以hexo-source作为仓库名。
  2. 关联Git仓库
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    cd <folder>

    #初始化本地仓库
    git init

    #新建本地分支
    git checkout -b master

    #关联远程仓库
    git remote add origin git@github.com:v-hiker/hexo-source.git

    #获取远程信息
    git fetch --all

    #commit到本地
    git add .
    git commit -m "init"

    #设置远程分支
    git branch --set-upstream-to=origin/hexo hexo

    #强制推送,这里以本地的文件为准,直接强制推送,覆盖远程仓库即可
    git push --force

后续对于修改的内容直接执行Git提交流程即可。

Hexo常用命令

1
2
3
4
5
6
7
8
hexo new "postName" #新建文章
hexo new page "pageName" #新建页面
hexo clean #删除本地已创建的网页
hexo generate #生成静态页面至public目录
hexo server #开启预览访问端口(默认端口4000,'ctrl + c'关闭server)
hexo deploy #部署到GitHub
hexo help # 查看帮助
hexo version #查看Hexo的版本

设置文章摘要的长度: 在合适的位置加上<!--more-->即可

一键部署和备份

新建脚本

1
2
3
4
5
6
7
8
9
#hexo部署 
hexo clean
hexo g
hexo d

#备份源码
git add .
git commit -m "update blog"
git push origin master