Hexo部署指南及踩坑记录


为什么选择 Hexo

Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown(或其他渲染引擎)解析文章,在几秒内,即可利用靓丽的主题生成静态网页。

从上面的介绍我们可以注意到这个东西:

即可利用靓丽的主题生成静态网页。

也就是说,我们可以很容易的将基于 Hexo 搭建的博客系统运行在 Github Pages 上

这意味着:能白嫖!能白嫖!(参见:《如何用最少的钱开一个网站?》

初始化 Hexo

您需要先准备以下环境:

  1. Node.js(>=12)
  2. Git

使用 npm 安装 hexo

1
2
3
4
# Windows
npm install -g hexo-cli
# Linux
sudo npm install -g hexo-cli

之后,使用 hexo init 命令初始化您的博客

1
hexo init [目录名称]

如果不传入[目录名称]参数,hexo-cli 在当前目录下初始化博客

创建完成后,目标目录看起来像这样

1
2
3
4
5
6
7
8
.
├── _config.yml
├── package.json
├── scaffolds
├── source
| ├── _drafts
| └── _posts
└── themes

您需要按自己需求修改 hexo 站点配置(_config.yml)文件,参考 配置 | Hexo

一般来说,您只需要修改以下配置项:

  1. title:站点标题
  2. subtitle:站点副标题
  3. author:作者名,也就是您的名字
  4. language:语言,可直接设为zh-CN
  5. timezone:时区,可直接设为Asia/Shanghai
  6. url:站点网址
测试您的配置

您可以在站点根目录使用hexo server指令启动 hexo 自带的服务器,之后使用浏览器访问 127.0.0.1:4000 查看您的更改

修改主题

您可以前往这里选择您的主题

部分主题可以直接用 npm 安装

部分主题需要您下载压缩包并解压到themes目录下

随后,修改 hexo 站点配置,将them项改为您的主题

部分主题可能会拥有自己的配置文件,主题配置在博客根目录下的_config.主题名.yml内(可能需要您手动复制/创建),具体参见主题的 README.md 文件

部署到 github

具体部署方法详见在 Github 上部署 Hexo

注意事项

如果您是使用 git 创建仓库或您修改了设置,您的仓库的默认分支名称可能为master或其他而不是main

请修推送改指令为:

1
git push -u origin 您分支的名称,如master

.github/workflows/pages.ymlon.push.branches

1
2
3
4
5

on:
push:
branches:
- 您的分支名称,如master # default branch

在每次推送后,github 会自动执行编译任务

如果您的仓库名不是用户名.github.io,默认请在用户名.github.io/仓库名访问您的博客

配置评论

因为 Hexo 是静态,所以 Hexo 默认不带有评论

可以使用gitalkgitment等将issue作为您博客的评论,具体参考其项目主页

但是此处有大坑需要注意

上文提到的两个评论插件会要求您申请 OAuth APP以登录github帐号,进入 Strring>Developer strring 创建

  • Application name:您的站点名
  • Homepage URL:您的博客首页URL
  • Authorization callback URL:回调URL

回调URL 需要填您的博客所使用的协议(一般是https://)+所在的域名(一般不含二级域名)

比如本博客的主页地址为:https://blog.thisisxd.top/index.html

则 回调URL 为:https://thisisxd.top

如果 回调URL 错误,登录就会返回error

具体多试试,不成功可以在下面发评论问

常见异常

Error: Not Found

此错误可能是由于以下原因引起的:

  1. 仓库未公开
  2. 仓库未开启issue
  3. 仓库未初始化issue

初始化 issue

  1. 在仓库设置中,勾选Issue,保存并刷新页面
  2. 打开仓库Issues,点击New Issue,编辑内容并提交,即可初始化Issue

Error: Validation Failed.

此错误可能是由于以下原因引起的

  1. 文章标题过长导致url过长

您可以 [修改][8] 文章 [永久链接][7] 以消除此错误

建议阅读

Hexo官方文档

IT Craft QCli


属性
仓库名 This-is-XiaoDeng/qcli
简介 能运行在 Linux TTY 中的第三方 QQ
许可证 GPL-3.0 license

README.md

一款能正常运行在 Linux TTY 中的第三方 QQ

搭建步骤

  1. 克隆仓库
  2. 安装 Python3
  3. 安装依赖库
  4. 修改程序配置
  5. 启动程序

提示:如果您不是Linux x86_64系统,需要您自行前往go-cqhttp官网下载对应系统的go-cqhttp并放入go-cqhttp/中!

许可证

IT Craft QCLI
Copyright (C) 2022 This is XiaoDeng

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <https://www.gnu.org/licenses/>.

View on GitHub

XDCloud 又——炸——了——


可能最近已经有人发现 XDCloud 访问会出现Origin is unreachable Error code 523错误。经排查发现,XDCloud 主机又双叒叕到期了……

买主机的不在,然后就没人续了.jpg

这次炸如果运气好可能会在寒假(大概是1月初)恢复,稍安勿躁

您也可以通过赞(给)助(我)通(打)道(钱)加速站点恢复进度

Sponsor me!

XDbot 项目公告(12月10日)


XDbot 目前已经回复运行,主机由 XieXiLin 提供。

为了避免 XDbot 部分功能在部分群聊造成刷屏,我们组建了 XDbot用户群(159910125)

同时,因为期末考临近,XDbot 将暂停开发直到寒假。

喜报:XDbot 又双叒叕 寄∽了∽


别看了已经欠费了 -_-||

我也不知道我是如何半个月把 500GB 流量跑炸的

总之就是莫名其妙就炸了

go-cqhttp重连了一个星期》

xxtg(主机提供方)说要下个月才能恢复………

公告

因为主机又双叒叕 tmd 炸掉了,XDbot 官号将停止服务一段时间,预计恢复时间为 2022年12月1日晚,恢复后会进行通知

This-is-XiaoDeng/XDbot

XDChat Release 1.2.0


属性
项目名 XDChat
版本 Release 1.2.0
仓库 GitHub

简介

一个简单的跨平台聊天软件

依赖

  1. Python3
  2. rich

运行

1
2
3
4
git clone https://github.com/This-is-XiaoDeng/XDChat.git
cd XDChat
python3 -m pip install rich
python3 ./main.py

免责声明

禁止将 XDChat 用于违法违规用途,否则本人不会承担因此产生的任何责任

This-is-XiaoDeng/XDChat