# 简单搭建 Hexo 博客站点

# Hexo 基本安装和使用

$ hexo new "My New Post"

$ hexo server  # 或者 hexo s

$ hexo generate

$ hexo deploy

主题以 https://github.com/amehime/hexo-theme-shoka 为例

git clone https://github.com/amehime/hexo-theme-shoka.git ./themes/shoka

yaml 格式问题，未对齐
参考：https://github.com/amehime/hexo-theme-shoka/issues/24

Function yaml.safeLoad is removed in js-yaml 4. Use yaml.load instead, which is n

替换 yaml.safeLoad 为 yaml.load
参考：https://blog.csdn.net/weixin_45149481/article/details/116609116

Prism's Diff Highlight plugin requires the Diff language definition (prism-diff.js).

Make sure the language definition is loaded or use Prism's Autoloader plugin.

向你购买的域名的 DNS 配置中添加 3 条记录，同时在 source 目录添加 CNAME 文件，文件里写上域名

@          A             192.30.252.153
@          A             192.30.252.154
www      CNAME         username.github.io.

设置 valine 评论，获取 APP ID 和 APP Key
https://valine.js.org/quickstart.html
这个参考文档进去注册，支付宝实名认证后即可

https://www.algolia.com/
从上面官网菜单找到 indices 建个索引（根据提示操作 4 步）
找到 API Keys 菜单，在 All API Keys 新建 API Key 绑定上面的索引即可

	algolia:
	appId: xxx
	apiKey: xxx
	adminApiKey: xxx
	chunkSize: 5000
	indexName: xxx
	fields:
	- title #必须配置
	- path #必须配置
	- categories #推荐配置
	- content:strip:truncate,0,4000
	- gallery
	- photos
	- tags

	algolia_search:
	enable: true
	hits:
	per_page: 10
	labels:
	input_placeholder: Search for Posts
	hits_empty: "我们没有找到任何搜索结果: ${query}"
	hits_stats: "找到${hits}条结果（用时${time} ms）"

博客文章提交到 github 上 source 分支触发 github actions 脚本，自动发布文章

	name: Hexo Deploy

	# 只监听 source 分支的改动
	on:
	push:
	branches:
	- source

	# 自定义环境变量
	env:
	POST_ASSET_IMAGE_CDN: true

	jobs:
	build-and-deploy:
	runs-on: ubuntu-latest

	steps:
	# 获取博客源码和主题
	- name: Checkout
	uses: actions/checkout@v2

	# - name: Checkout theme repo
	# uses: actions/checkout@v2
	# with:
	# repository: printempw/hexo-theme-murasaki
	# ref: master
	# path: themes/murasaki

	# 这里用的是 Node.js 14.x
	- name: Set up Node.js
	uses: actions/setup-node@v1
	with:
	node-version: '14'

	# 设置 yarn 缓存，npm 的话可以看 actions/cache@v2 的文档示例
	- name: Get yarn cache directory path
	id: yarn-cache-dir-path
	run: echo "::set-output name=dir::$(yarn cache dir)"

	- name: Use yarn cache
	uses: actions/cache@v2
	id: yarn-cache
	with:
	path: $<!--swig0-->
	key: $<!--swig1-->-yarn-$<!--swig2-->
	restore-keys: \|
	$<!--swig3-->-yarn-

	# 安装依赖
	- name: Install dependencies
	run: \|
	yarn install --prefer-offline

	# 从之前设置的 secret 获取部署私钥
	- name: Set up environment
	env:
	DEPLOY_KEY: $<!--swig4-->
	run: \|
	sudo timedatectl set-timezone "Asia/Shanghai"
	mkdir -p ~/.ssh
	echo "$DEPLOY_KEY" > ~/.ssh/id_rsa
	chmod 600 ~/.ssh/id_rsa
	ssh-keyscan github.com >> ~/.ssh/known_hosts

	# 生成并部署
	- name: Deploy
	run: \|
	npx hexo deploy --generate

https://github.com/oncletom/hexo-algolia
https://blog.csdn.net/qq_35479468/article/details/107335663
https://segmentfault.com/a/1190000017986794

记录下 git 基本操作

	echo "# SincerelyUnique.github.io" >> README.md
	git init
	git add README.md
	git commit -m "first commit"
	git branch -M main
	git remote add origin https://github.com/SincerelyUnique/SincerelyUnique.github.io.git
	git push -u origin main


	git remote add origin https://github.com/SincerelyUnique/SincerelyUnique.github.io.git
	git branch -M main
	git push -u origin main