What’s this?

Hexo is a “快速、简洁且高效的博客框架”(Copied from offical site)

Get Started

Requirements

需要准备这些东西喵:

从 Hexo 8.0 开始,请使用Windows 10及以上版本运行,否则可能会引起严重的兼容性问题!

Set up

  1. 检查前置状态,结果参考下图

    • npm:npm -v
    • Git:git -v
    • NodeJS:node -v
      2.png
  2. 安装Hexo-CLI
    通过终端执行 npm install hexo-cli -g
    3.png

  3. 初始化Hexo
    生成Hexo工作区:

    1
    2
    3
    hexo init <folder>
    cd <folder>
    npm install

    构建Hexo&启动本地服务器

    1
    hexo cl&&hexo g&&hexo s

效果:
5.png

Configuration

  1. 检查文件夹结构
    7.png
    功能对应?
File Name Usage
_config.yml 站点主要配置信息
_config.landscape.yml 默认主题LandScape的配置文件,如果你不使用LandScape,留空即可
*.json 构建配置,一般无需修改
source/* 资源文件(夹),里面可以装你的文章/草稿/自定义文件之类的
themes/* 主题文件夹,用于存放主题
scaffolds/* 可以理解成模板文件夹,但非必要尽量不要修改
public/* 构建目录,后面会讲到,这里存放着你站点构建产物
node_modules/* Node包文件夹,存放站点构建所用的工具/依赖包,切记:若要安装/卸载包,请使用 npm操作,万不可手动删除

node_modules: 举个例子,如果你正在使用Butterfly主题,对于使用 npm的用户来讲,你的 PugStylus就会存储在这里(pnpm另论),用途你自己品

  1. 配置站点信息

    官方文档https://hexo.io/zh-cn/docs/configuration

    不是我懒,是这字太多码起来把我的猫爪码坏了咋办,你说呢,喵~

    截图摘要:
    1-1.png
    1-2.png
    1-3.png
    1-4.png
    1-5.png
    1-6.png
    1-7.png

    1. 安装主题
      • 前往https://hexo.io/themes/选择你喜欢的主题
      • 点击主题名转至GithHub下载主题
      • 把主题文件夹解压到 ~/themes/
      • 依据主题官方文档配置主题,比如Butterfly

Make it online

现在,让我们把它送到云端。

  1. 登录到GitHub/Gitee(此处以Gitee为例)
    a1.png

  2. 创建远程仓库,随便填一个只有英文和连字符的仓库名
    a2.png

  3. 创建本地仓库并连接至远程仓库
    执行:

    1
    2
    3
    cd /PATH/
    git init
    git remote add origin https://gitee.com/<username>/<repo>.git

这里的远端url (https://...)请根据你仓库上所提示的url填写,具体如下图:

a3.png

执行:

1
2
3
git add .
git commit -m My-Blog # 这里的`My-Blog`是提交信息,可根据自己实际需求修改,下同
git push origin master # 若无法上传,请现在本地Git登录你的GitHub、Gitee帐户

输出

a4.png
a5.png
a6.png

  1. 上传资源

    刚刚我们是把整个文件夹(可能)包括构建物在内的所有文件全上传了,但是构建物会影响后续站点部署,所以我们还得再加工一下

执行:

1
2
3
4
hexo cl
git add .
git commit -m make-it
git push origin master

如果看不到本地和远端都看不见 public目录了就是可以了,这种情况不用再次清理和提交

  1. 登录EdgeOne
  2. 转到Makers选项卡,点击蓝色的 Create Project按钮,选择 Import from Git repository,链接到Git帐户(取决于你的代码托管在哪),选择并导入
    B1.png
  3. 配置部署
    注意以下高亮的设置是否一致
    B2.png

    除非你知道你在做什么,请不要随意修改框架预设的各类设置,即 Build settings区块内的非高亮设置

  4. 启动部署
  • 单击 Start development启动部署
  • You Made It!!!
    B3.png
  • 点击Preview按钮,你的站点就在那里

Writing

非常简单,运行以下命令

1
2
hexo new post [name] # 新博文
hexo new page [name] # 新页面

直接编辑 *.md文件就可以用Markdown写作啦

Add-ons

绑定域名

  1. 转到 Domains选项卡
    C1.png
  2. 点击 Add custom domain,在弹出的窗口里输入所绑定的域名
    C2.png
  3. 添加DNS记录,验证收场
    C3.png
    C4.png
    C5.png
  4. 尽情享用喵~

    这里展示的是我的博客
    C6.png
    C7.png


好啦,又到了我瞎BB的环节了.
这篇文章之前就说好重写的,今天终于给它翻新了,至少现在不会再用不来Markdown了

今天是2026年7月27日
那天是2023年7月27日

非常可以,建站之旅的第一篇文章是小升初暑假写的,却没想到我会在初升高暑假再写一遍

EdgeCat Network 这么算下来就三岁了呢

这时间过得可真快

HURRY UP,EdgeCat!