Docs

🚀 使用 Hexo 搭建简单技术文档分享平台并发布至 Cloudflare

本项目将指导你使用 Hexo 搭建一个简单的技术文档分享平台，并将其发布到 Cloudflare。同时，还会介绍一系列技术文章，涵盖 n8n 更新、Google AI Studio 使用、设计模式学习等内容。

🚀 快速开始

安装需求

你需要安装 Node.js 与 Git。

安装 Hexo

npm install hexo-cli -g

查询当前安装的 Hexo 版本号，测试是否安装成功：

hexo version

或

hexo -v

建立 Hexo 项目

hexo init <文件夹名称>

你可以将新建的文件夹复制到项目目录，这样就无需执行 cd <文件夹名称>，可直接初始化 Hexo 项目：

npm install

启动 Hexo 项目

hexo server

通常访问地址为 http://localhost:4000/，点击即可在浏览器中浏览网页。 若报错：

FATAL Permission denied. You can't use port 4000.

可以使用以下指令更换端口：

hexo server -p 5000

清除静态文件与缓存

hexo clean

生成静态文件

hexo generate

新增文章

hexo new <title>

发布到远端

hexo deploy

发布到 Cloudflare

• 注册一个 Cloudflare 账号。
• 选择左边菜单“计算(Workers)”，创建“Worker 和 Pages”。

组件配置

• 组件命令：

npm run build

• 组件输出目录：

public

• 变量与秘密：

NODE_VERSION 20.11.0

发布网址：https://docs-axs.pages.dev

✨ 主要特性

• Hexo：基于 Node.js 开发的博客框架，易于搭建和使用。
• 文章丰富：包含 "全面了解 n8n v1.88.0 的重磅更新 —— MCP Server"、"教会你用 Google AI Studio 提早结束工作回家"、"C# 设计模式学习笔记与代码范例"、"JavaScript 设计模式学习笔记与代码范例"、"Functional Design Pattern 是一个结合函数式程序设计和设计模式的概念" 等技术文章。

📦 安装指南

安装需求

你需要安装 Node.js 与 Git。

安装 Hexo

npm install hexo-cli -g

查询当前安装的 Hexo 版本号，测试是否安装成功：

hexo version

或

hexo -v

建立 Hexo 项目

hexo init <文件夹名称>

你可以将新建的文件夹复制到项目目录，这样就无需执行 cd <文件夹名称>，可直接初始化 Hexo 项目：

npm install

💻 使用示例

基础用法

启动 Hexo 项目

hexo server

通常访问地址为 http://localhost:4000/，点击即可在浏览器中浏览网页。

新增文章

hexo new <title>

高级用法

更换端口

若启动项目时端口被占用，报错：

FATAL Permission denied. You can't use port 4000.

可以使用以下指令更换端口：

hexo server -p 5000

清除静态文件与缓存

hexo clean

生成静态文件

hexo generate

发布到远端

hexo deploy