欢迎来到 Hexo! This is 一篇引导文章. Check documentation - 文档 for more info. If you get any problems when using Hexo, you can find the answer in troubleshooting - 故障排除 or you can ask me on GitHub.

Quick Start - 快速上手

Create a new post - 创建一个新帖子

1
2
$ hexo new "My New Post"
$ hexo new "xxx"

More info: Writing

Run server - 运行服务器

1
2
$ hexo server
$ hexo s

More info: Server - 服务器

Generate static files - 生成静态文件

1
2
$ hexo generate
$ hexo g

More info: Generating - 生成

Deploy to remote sites - 部署到远程站点

1
2
$ hexo deploy
$ hexo d

More info: Deployment - 部署

补充：确定部署过程没问题你便可以一步到位：

1
$ hexo c && hexo g && hexo d

注意事项：
如果上传遇到了问题，很有可能是网络问题（

Hexo自定义原理
Hexo 系列的博客中的文章都是经Hexo的主题渲染的静态网页。所以Hexo博客大部分都呈现出一种高度的统一化与规范化。不过 Hexo 提供了跳过渲染功能，使得我们可以直接在博客中放入自定义网页。

比如在博客中放入图片、自定义404.html、自定义About页面、简历等
创建自定义网页
网页可以是自己编写的，也可以是别人现成的源码（下载喜欢的页面）。

网页编写完成后，在Hexo\source目录下创建一个文件夹（文件夹名称任意，比如我创建的是about这个文件夹，部署完成后，访问http://mrlsm.github.io/about即可看到效果，依此类推）

将 html 文件放置于此文件夹，并重命名为 index.html 。
跳过渲染
跳过渲染有下述两种方法：
1.在自定义页面的开头添加如下：

---
layout: false
---

  • 1
  • 2
  • 3

添加该指令后，执行 hexo g命令时便会跳过该 index.html文件，使得index.html不受当前 hexo 主题影响，完全是一个独立的网页，如果网页引用了 css 或 js，css 和 js 需使用外链或者将css js 文件放入index.html同目录下引用。

引用图片亦是如此

2.在_config.yml文件中设置skip_render
使用编辑器打开 Hexo 目录下的_config.yml文件，找到skip_render

skip_render一般有以下四种常用参数：

  • 跳过source目录下的 test.html: skip_render: test.html
  • 跳过source目录下 test 文件夹内所有文件：skip_render: test/*
  • 跳过source目录下 test 文件夹内所有文件包括子文件夹以及子文件夹内的文件：skip_render: test/**

跳过多个路径：

skip_render:
 - test.html
 - test/*

  • 1
  • 2
  • 3

最后执行：

hexo g -d

  • 1
---

Hexo 部署中遇到的问题以及相应的解决方案

Hexo错误：spawn failed的解决方法

Hexo错误：spawn failed的解决方法 | 张洪Heo (zhheo.com)

解决方案：

在C盘——用户——你的主机名文件夹中找到.ssh文件夹；（此前配置SSH时会生成该文件夹）
在.ssh文件夹中新建文件 config,不带后缀（可以新建文本文档，去掉.txt后缀）
使用notepad++（或其他方式）打开config文件，输入以下内容，保存后即可

1
2
3
4
5
6
Host github.com
User YourEmail（你的邮箱）
Hostname ssh.github.com
PreferredAuthentications publickey
IdentityFile ~/.ssh/id_rsa
Port 443

Hexo d 时显示 CRLF LF Warning 问题、

1
2
git config --global core.autocrlf false
# Git 配置命令：全局 自动转换换行符 禁止

更新日志：

2024：

  • 2.16 网站初建
  • 3.5 初步解决不能稳定上传数据的问题，网站复活
  • 3.7 导入第一篇文章
  • 3.11 实现图片加载
  • 3.12 修改网站图标
    更正文章链接
    修改主页标题
  • 3.13 实现GIF加载
  • 3.14 优化网站文章的永久链接格式
    导入了B站视频（测试中
  • 3.18 尝试引入JavaScript网页小游戏
  • 3.21 创建了github图床，方便了撰写文章时图片的引用
  • 3.22 实现指定篇目取消渲染，添加README
  • 3.26 实现从网站下载文件
    汉化Hexo引导文章
    更换域名为顶级域名 opentap.top
  • 3.27 初步配置Netlify（还在研究
  • 3.28 接入萌ICP备
  • 4.1 发布霜晴的避风港.apk
  • 4.2 优化网站图表样式(方形圆角,192x192,png)
  • 4.30 接入Vercel，使用vercel部署
  • 5.11 新增域名 opentap.cn
  • 7.24 在 stellar 主题中配置网站logo、补上友链
  • 9.5 稍微修改了一下页脚
  • 10.16 使用 uptimebot 增加网站状态监控
  • 10.28 在阿里云服务器上部署Alist，开启网盘服务
  • 10.31 使用HTTPS+域名访问Alist服务
  • 11.2 本地部署Llama3:8b模型