hexo+anzhiyu主题+github+cloudflare

Hexo

安装 Hexo

所有必备的应用程序安装完成后,即可使用 npm 安装 Hexo.

npm install -g hexo-cli

建站

安装 Hexo 完成后,请执行下列命令,Hexo 将会在指定文件夹中新建所需要的文件.

hexo init <folder>
cd <folder>
npm install
  • _config.yml

网站的 配置 文件. 您可以在此配置大部分的参数.

  • package.json

应用程序的信息. EJS, Stylus 和 Markdown 渲染引擎 已默认安装,您可以自由移除. 如果您想,可以稍后卸载它们.
package.json

{
  "name": "hexo-site",
  "version": "0.0.0",
  "private": true,
  "hexo": {
    "version": ""
  },
  "dependencies": {
    "hexo": "^7.0.0",
    "hexo-generator-archive": "^2.0.0",
    "hexo-generator-category": "^2.0.0",
    "hexo-generator-index": "^3.0.0",
    "hexo-generator-tag": "^2.0.0",
    "hexo-renderer-ejs": "^2.0.0",
    "hexo-renderer-stylus": "^3.0.0",
    "hexo-renderer-marked": "^6.0.0",
    "hexo-server": "^3.0.0",
    "hexo-theme-landscape": "^1.0.0"
  }
}
  • scaffolds

模版 文件夹. 当您新建文章时,Hexo 会根据 scaffold 来创建文件.

  • source

资源文件夹. 是存放用户资源的地方. 除 _posts 文件夹之外,开头命名为 _ (下划线)的文件 / 文件夹和隐藏的文件将会被忽略. Markdown 和 HTML 文件会被解析并放到 public 文件夹,而其他文件会被拷贝过去.

  • themes

主题 文件夹. Hexo 会根据主题来生成静态页面.

anzhiyu主题

文档: 📖 anzhiyu Docs

创建.gitmodules文件,将以下代码复制到.gitmodules中并进行修改,远程主题是不可控的,无法进行详细修改,可使用Fork将主题仓库复制到你自己的Github中,这里的主题是在cloudflare中使用.(这个比较关键,没有添加会导致部署时报错)

[submodule "themes/anzhiyu"]
    path = themes/anzhiyu
    url = https://github.com/anzhiyu-c/hexo-theme-anzhiyu.git

主题安装

温馨提示

Anzhiyu主题拥有Main(稳定版)和Dev(测试版)两种版本, 我们推荐您安装使用Github(稳定版)以获得最佳的主题体验

  • Github
git clone -b main https://github.com/anzhiyu-c/hexo-theme-anzhiyu.git themes/anzhiyu

如遇安装不上可以使用以下url代理安装

git clone -b main https://ghproxy.com/https://github.com/anzhiyu-c/hexo-theme-anzhiyu.git themes/anzhiyu

应用主题

打开 Hexo 根目录下的 config.yml, 找到以下配置项,把主题改为anzhiyu

# Extensions
## Plugins: https://hexo.io/plugins/
## Themes: https://hexo.io/themes/
theme: anzhiyu

安装 pug 和 stylus 渲染插件

npm install hexo-renderer-pug hexo-renderer-stylus --save

无法安装可以使用cnpm进行安装

npm install hexo-renderer-pug hexo-renderer-stylus --save --registry=http://registry.npmmirror.com

覆盖配置

覆盖配置可以使主题配置放置在 anzhiyu 目录之外,避免在更新主题时丢失自定义的配置.

通过 Npm 安装主题的用户可忽略,其他用户建议学习使用.

  • macos/linux 在博客根目录运行
cp -rf ./themes/anzhiyu/_config.yml ./_config.anzhiyu.yml
  • windows 复制/themes/anzhiyu/_config.yml此文件到 hexo 根目录,并重命名为_config.anzhiyu.yml

以后如果修改任何主题配置,都只需修改 _config.anzhiyu.yml 的配置即可.

注意:

只要存在于 _config.anzhiyu.yml 的配置都是高优先级,修改原 _config.yml 是无效的.
每次更新主题可能存在配置变更,请注意更新说明,可能需要手动对 _config.anzhiyu.yml 同步修改.
想查看覆盖配置有没有生效,可以通过 hexo g –debug 查看命令行输出.
如果想将某些配置覆盖为空,注意不要把主键删掉,不然是无法覆盖的

本地启动 hexo


hexo cl
hexo g
hexo s

此时就能在看到效果了.

Cloudflare部分

在Cloudflare上部署hexo

登录到Cloudflare然后将语言切换到中文,接着导航到Workers和Pages,选择Pages连接到的GitHub仓库.以下是关键步骤
项目名称:自定义这里随意些只要记住这是做什么的.
框架预设:无
构建命令:npm run build
输出目录:public
最后点击:开始部署
等待Cloudflare构建完成会随机分配一个Cloudflare提供的官方域名,后期可以绑定自己的域名,部署完成后打开Cloudflare自动分配的域名预览是否安装正确.
域名类似hexo-e0o.pages.dev