创建hexo博客 | Readfere

安装 hexo

前置条件

安装 nodejs 和 git
Node.js
Git

hexo 安装步骤

安装

1	npm install -g hexo-cli

初始化新建文件夹

1	hexo init <folder>

切换到新建的文件夹

1	cd <folder>

安装后的文件夹目录结构：

├── _config.yml
├── package.json
├── scaffolds
├── source
|   ├── _drafts
|   └── _posts
└── themes

网站的配置文件为：_config.yml

安装 hexo 主题

以 solitude 主题为例

安装命令

1	git clone -b main https://Github.com/DuoSco/Hexo-theme-solitude.git themes/solitude

Gitee 稳定版：

1	git clone -b master https://gitee.com/yife68/hexo-theme-solitude.git themes/solitude

应用主题

修改 hexo 根目录配置文件 _config.yml，把主题改为 solitude

1	theme: solitude

mac:

1	cp -rf ./themes/solitude/_config.yml ./_config.solitude.yml

windows:
复制 /themes/solitude/_config.yml
文件到 hexo 根目录，并重命名为 _config.solitude.yml

安装主题所需插件：

安装 pug 和 stylus 渲染插件

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

1 2	npm un hexo-renderer-marked # 卸载默认 markdown 解析插件 npm install hexo-renderer-markdown-it # 安装另一个markdown解析器

本地启动 hexo（hexo三连）

1
2
3

hexo cl #清除已生成文件
hexo g #生成新文件
hexo s #开启本地服务

更新主题

cd 到主题目录

git pull

安装 hexo-algolia 搜索

hexo-algoliasearch（这个比较新）：
Github - LouisBarranqueiro/hexo-algoliasearch:

安装这个 Hexo 插件之后还要去 algolia 网站注册账号来配置获取以下信息：

algolia:
  appId: "Z7A3XW4R2I"
  apiKey: "12db1ad54372045549ef465881c17e743"
  adminApiKey: "40321c7c207e7f73b63a19aa24c4761b"

local search【本地搜索】(我没用这个)

Github - next-theme/hexo-generator-searchdb: 🔍 Seach data generator plugin for Hexo.

Github - wzpan/hexo-generator-search: A plugin to generate search data for Hexo.

安装豆瓣页面

Github - mythsman/hexo-douban

案例：阅读书虫 | 七鳄学习格

配置 twikoo 评论系统

我使用 MongoDB 配合 Netlify 搭建的

教程在下面：
云函数部署 | Twikoo 文档

发布到Github pages

新建Github仓库

注册Github账号
新建一个名叫 “用户名.github.io” 的仓库

绑定域名

在Github右上角 “点击头像-settings-左边菜单栏pages-add a domain” 添加你的根域名，就是没有前缀的域名,点击add domain
会弹出 “add a verified domain” 接下来去你的域名商网站添加一个txt record进行域验证，把Github给你的域名前缀和txt record填写进去，点击verify验证域名所有权
在项目根目录建立一个CNAME文件里面填写要绑定的根域名xxx.com
在项目repo页面点击 “settings-pages-custom domain” 添加要绑定的根域名，点save
过一段时间勾选下面的Enforce HTTPS

修改hexo根目录的 _config.yml 配置文件

添加：

# Deployment
## Docs: https://hexo.io/docs/one-command-deployment
deploy:
  type: 'git'
  repo: https://github.com/用户名/用户名.github.io.git 
  # https://bitbucket.org/JohnSmith/johnsmith.bitbucket.io
  branch: main

部署命令

1 2	hexo cl && hexo g && hexo algolia # 清除已生成文件+生成新文件+生成搜索缓存

1 2	hexo deploy # 部署到github可能要求输入密码