hexo博客使用手册

本文介绍利用hexo写博客的常用命令和功能

包括创建博客,预览文章,部署博客,文章加密,更换主题,免费图床

新建文章

文章

在博客目录下输入以下命令时,会默认使用post布局,然后自动在source\_posts目录生成一个文章名.md文件:

hexo n 文章名 # 例如 hexo n hexo博客使用手册

另外如果在_config.yml配置文件中将有设置文章的目录post_asset_folder: true

则上述命令还会创建同名文件夹

当然你还可以指定布局:

$ hexo n [layout_name] draft1

该命令创建了一个使用特定布局的名为draft1的文章。

打开之前创建的text1.md文件,我们可以看到文章开头包含以下内容:

1
2
3
4
5
6
---
title: text1
date: 2022-05-23 13:29:36
tags: hexo
categories: blog
---

你显示的内容可能未必与我一样,不必担心, 这是可以自定义的。只需要知道,上面的内容在hexo被称作Front-matter,实际上就是该文章的一些变量,用于实现一些特定的功能。比如使author: yuting,那么渲染后的文章中将显示文章作者为yuting

如何自定义布局呢?实际上,布局是一个markdown文件,它们保存在scaffolds/目录下,可以看到hexo自带的三种布局其实就是三个.md文件:

而每一个文件中的内容实际只包含一个Front-matter。

因此,你可以在这里修改布局或者建立新的布局,然后创建文章时使用这些布局。

草稿

使用hexo n draft draft1命令将在source\目录下创建_drafts目录,并生成一个draft1.md文件。

当你编辑完草稿后,可以把文章推送到_posts目录下,通过下面的命令:

1
hexo publish <file_name>

可以使用hexo --draft命令可以查看已有草稿。

编辑文章

以下将介绍一些markdown语法。由于markdown在不同平台的实现略有不用,因此下面的内容只会介绍hexo默认支持的语法。此外,由于主题不同,不同机器显示效果也有会一定差异。

以下是本人操作的环境:

编辑器:typora(可以自行去下载)

hexo主题:Fluid

操作系统:mac

插入图片

![]() 小括号()里添加图片链接 []添加图片名称,也可以不写

标题

##### 标题 #一个表示一级标题,注意文字和#之间有空格

加粗

**加粗**

代码块

``` ```

插入视频
1
2
3
<video width="480" height="320" controls>
<source src=video_path>
</video>
引用区块
1
2
3
4
5
> 这也是引用
>
> 引用1
>
> 饮用2

预览文章

编写好markdown文章后接下来就需要渲染、生成静态文件,启动本地端口查看效果了。

启动本地端口命令:hexo serverhexo s

生成静态文件之后,便要启动本地端口。然后localhost:4000

删除静态文件命令:hexo clean

生成静态文件命令:hexo generatehexo g

部署静态文件命令:hexo d

文章加密

安装hexo-blog-encrypt插件

在hexo目录下 npm install hexo-blog-encrypt

/Hexo/_config.yml文件中添加内容:

encrypt:

​ enable:true

使用插件

在想要使用加密功能的Blog头部加上对应文字

1
2
3
4
5
---    
password: smile
abstract: Welcome to my blog, enter password to read.
message: 密码输入框上描述性内容
---
  • password: 该Blog使用的密码
  • abstract: Blog摘要文字(少量)
  • message: 密码框上的描述性文字

更换主题

以fluid主题举例子

1.在GitHub上克隆你喜欢的hexo主题到本地博客的根目录的theme文件夹下

获取最新版本

方式1⃣️:

Hexo 5.0.0 版本以上,推荐通过 npm 直接安装,进入博客目录执行命令:

npm install --save hexo-theme-fluid

然后在博客目录下创建 _config.fluid.yml,将主题_config.yml内容复制过去

当同时存在 _config.fluid.yml_config.yml时,_config.yml配置无效

方式2⃣️:(我博客目前是这种方法)

下载 最新 release 版本解压到 themes 目录,并将解压出的文件夹重命名为 fluid

2.指定主题

如下修改 Hexo 博客目录中的 _config.yml

1
2
3
theme: fluid  # 指定主题

language: zh-CN # 指定语言,会影响主题显示的语言,按需修改

参考fluid主题操作手册 https://hexo.fluid-dev.com/

Fluid 是基于 Hexo 的一款 Material Design 风格的主题,由

Fluid-dev负责开发与维护。

主题 GitHub:

预览网站:Fluid’s blog, zkqiang’s blog

免费图床

在尝试通过 Coding 持续集成自动将 GitHub 仓库实时同步到 Coding 仓库 失败后,果断采用 PicGo + GitHub 搭建个人图床工具,并且成功了。呜呜呜

Coding 持续集成我一直构建失败

Coding构建可以参考:Coding构建 ,我就不做介绍了,我都没构建成功😩

PicGo + GitHub 搭建个人图床工具

1.Github仓库设置

流程:新建 public 仓库 -> 创建 token -> 复制 token 备用

新建 public 仓库 :

​ 点击 git 主页右上角的 + 创建 New repository

​ 填写仓库信息,例如我就创建了一个 PicGo 的仓库。这里注意,仓库得设置为 Public 因为后面通过客户端访问算是外部访问,因此无法访问 Private ,这样的话图片传上来之后只能存储不能显示。所以要设置为 Public

创建 token并复制保存

此时仓库已经建立,点击右上角头像,然后进入设置;

在页面最下找到 Developer settings,点击进入;

Personal access tokens 创建 token

填 description(也是随心填),勾选复选框 repo ,接着到页面底部 Generate token 就完成了;

然后复制生成一串字符 token,这个 token 只出现一次,所以要保存一下(我一般记在微信收藏)。

2.PicGo 客户端配置

下载&安装 PicGo

配置

仓库名 即你的仓库名
分支名 默认 master
Token 就是刚刚复制的那一串字符
存储路径 这个可以填也可以不填,填了的话图片就上传到 git 中 data 这个文件夹
域名 https://raw.githubusercontent.com/yefcion/cloudimg/master

域名要改一下 格式 https://raw.githubusercontent.com/[username]/[仓库名]/master

然后点确定就可以了。

然后关于上传的快捷键设置。默认的是 Mac 按键,推荐改成 Ctrl + alt +c

综上,操作完成。

本方案唯一缺点,不能私人。但是考虑到 GitHub 上传的图在列表里没法预览,应该没人会闲着没事翻记录。。


觉得不错的话,给点打赏吧 ୧(๑•̀⌄•́๑)૭



wechat pay



alipay

hexo博客使用手册
http://yuting0907.github.io/2022/05/23/hexo博客使用手册/
作者
Echo Yu
发布于
2022年5月23日
许可协议