安装安装 Hexo 完成后,请执行下列命令,Hexo 将会在指定文件夹中新建所需要的文件。
123$ hexo init <folder>$ cd <folder>$ npm install
初始化后,您的项目文件夹将如下所示:
123456789.├── _config.yml├── package.json├── scaffolds├── source| ├── _drafts| └── _posts└── themes_config.yml
网站的 配置 文件。 您可以在此配置大部分的参数。
package.json应用程序的信息。 EJS, Stylus 和 Markdown 渲染引擎 已默认安装,您可以自由移除。 如果您想,可以稍后卸载它们。
123456789101112131415161718192021package.json{ "name": "hexo-site", "version": "0.0.0", "private&q ...
图床配置从 2.0.0 开始, Qexo 支持了模块化的图床接入方法, 先前的 S3、FTP、Custom 文档合并至此
远程 APIQexo 提供了自定义 API 图床功能, 在配置完成图床设置后即可在文章/页面编辑界面上传图片
API 地址图床图片上传的 API
1https://7bu.top/api/upload
POST 参数名图床图片上传 API 参数中图片文件的参数名
1image
JSON 路径图床 API 返回数据中 图片 URL 所在的路径, 若为整个返回值请留空示例:
1data.url
自定义请求头POST 请求时附带的请求头, 需要标准 JSON 格式, 若不需要请留空
1{"key":"value"}
自定义 BODYPOST 请求时额外的请求主体, 需要标准 JSON 格式, 若不需要请留空
1{"key":"value"}
自定义前缀返回 URL 所需要添加的前缀, 若不需要请留空
1some_text_or_ur ...
服务商设置Qexo 在 2.0 版本支持了服务商拓展
Github
Gitlab
本地
获取文件
√
无Size数据
√
获取目录
√
√
√
保存文件
√
√
√
删除文件
√
√
√
Webhook
自动
手动
×
自动部署
Action
Action
命令行
博客程序设置Qexo 在2.6版本开始支持多博客程序(截止2.6已支持Hexo、Hugo和Valaxy)
使用 Github如果部署中遇到问题, 可以访问 HPP校验助手 自检配置 仅支持Github, 若确认无误, 可检查仓库内是否有已经发布的文章
Github 仓库您 博客源码 自动化部署所在的仓库
1username/repo
参考文献:
https://blog.cyfan.top/p/e626cb30.html
https://oplog.cn/archives/24998.html
https://crazywong.com/posts/74006f42
项目分支您 博客源码 自动化部署所在仓库的分支
1master
Github 密钥于 Github 设置 生成的 To ...
Hexo
未读常见问题什么是 API 密钥在您完成初始化之后可在设置界面修改/创建 API 密钥, 用于 Webhook 中的身份验证。若留空系统会随机生成一个 API 密钥
为什么我新建的文章没有显示 | Qexo 如何保证文件最新Qexo 为了加快访问速度引进了缓存机制, 你可以在设置清除缓存 & 设置 Webhook自动清除缓存
Webhook 是什么Qexo 中的 Webhook 指 /api/webhook 用于自动化操作, 目前可用于自动清除缓存
安装后出现 504 Time out
您的数据库没有正确配置或没有允许所有 IP 白名单访问, 可在 MongoDB 控制台进行修改, 修改完成后一定要重新部署
删除并重建数据库, 注意区域一定要选择 AWS / N. Virginia (us-east-1)
安装/更新后出现 5xx 错误Qexo 每个 Release 都经过 Dev 分支的测试, 一般情况下不会出现较大问题, 如果你遇到了500等错误, 请尝试以下步骤
检查数据库配置
清除浏览器缓存 / 程序缓存
在 ...
部署程序得益于 Python 强大的跨平台功能, Qexo 支持在各种平台进行部署, 受支持的部署方式为 Vercel 或 Docker 部署。本地源码部署只建议高级用户使用。
值得注意的一点是, 如果你使用的是 Vercel 部署, 我不建议你自备数据库, 因为你往往无法保证与 Vercel 的连接质量。
Docker 部署建议使用 Docker 随时随地一键部署 Qexo 应用
Qexo 已经支持使用 ghcr.io 或 cnb.cool 制品库提取镜像, 如果你是国内用户, 建议将下文中的 abudulin/qexo 替换为 docker.cnb.cool/qexo/qexo 以加快部署
1234567docker run -d \ --restart=unless-stopped \ -v $(pwd)/db:/app/db \ -p 8000:8000 \ -e TIMEOUT=600 \ --name="qexo" \ abudulin/qexo:latest
其中 $(pwd)/db 为数据存储目录, 你可以改 ...
Hexo
未读Welcome to Hexo! This is your very first post. 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 StartCreate a new post1$ hexo new "My New Post"
More info: Writing
Run server1$ hexo server
More info: Server
Generate static files1$ hexo generate
More info: Generating
Deploy to remote sites1$ hexo deploy
More info: Deployment
快速开始Qexo 是一个快速、强大、美观的在线 静态博客编辑器。使用 GPL3.0 开源协议。支持包括且不限于在 Vercel 等平台部署, 为您的静态博客添加动态的元素
特色功能
文章管理~全新界面
3.0版本的 Qexo 重新设计了文章编辑页面, 您可以更优雅地进行文章编辑
支持多种图床上传, 上传尽在弹指之间
缓存功能~速度至上
支持将文章、页面、配置索引一键缓存至数据库, 保证您的高速访问
Webhook 全自动清除缓存, 时刻保持数据最新
麻雀虽小~五脏俱全
模块化架构
支持多种 Hexo、Hugo、Valaxy 托管商 Github、Gitlab、本地
多种图床协议支持 Github、S3、FTP、远程API
Markdown 语法 + 多种编辑界面, 所见即所得
全新界面 黑夜/白天 一键切换
多形式推送 Bark、Telegram、Pushdeer、Wechat…
reCaptcha 防止垃圾信息侵害
友情链接 前端申请, 一键接入
自动更新 简单方便, 保持最新
自定字段 / 站点统计 / 页面管理 / 配置编辑
评论通知 ...
.video-container { position: relative; padding-top: 56.25%; } .video-container iframe { position: absolute; top: 0; left: 0; width: 100%; height: 100%; }
🌟前提条件:- ✅ 已部署 Hexo 项目
- 🔗 安装教程参考:Hexo站点搭建 | GitHub部署 | Cloudflare Pages发布 | 保姆级教程
🎨 安装 Butterfly 主题🔽 下载主题(推荐方式:Git 克隆)- 国内用户建议使用 Gitee:
1git clone -b master https://gitee.com/immyw/hexo-theme-butterfly.git themes/butterfly
- 网络环境较好可使用 GitHub:
1git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfl ...
主题安装搭建 Hexo 博客如果你还没有 Hexo 博客,请按照 Hexo 官方文档 进行安装、建站。
作者的话请注意_config.anzhiyu.yml中的配置优先级大于_config.yml,所以更新主题后需要比对主题文件夹中的theme/anzhiyu/_config.yml 文件内容,一般在release 的说明里会特别提示或给出配置文件版本对比diff,同步修改原配置文件即可。
:::tip致主题的新用户:
本指南经过数个版本打磨,绝大部分的功能都有详细说明,请仔细阅读,节约自己和他人的时间;
本指南中提到的:”站点配置“ 指的 Hexo 博客目录下的 _config.yml,”主题配置“ 指的是 theme/anzhiyu/_config.yml 或者 _config.anzhiyu.yml ,注意区分;
本指南中提到的 source 目录都指的是博客目录下的 source 文件夹,不推荐修改主题内 source 目录;
每次无论 hexo g 或 hexo s,都最好先使用 hexo clean 清除本地缓存;
页面结果以本地 hexo s ...

