本网站(指水博客)采用 Hexo 框架和 Yume Shoka 主题搭建,这里要感谢琉璃大人的贡献。

本简明教程提供一组安装命令供 GNU/Linux 发行版和 macOS 用户使用~~(免去了复制的麻烦)~~。

# 安装依赖

# 安装 git

使用包管理器安装 git

Debian 系:

使用包管理器安装git(Debian系)
1
2
3
sudo apt update
sudo apt upgrade
sudo apt install git

RedHat 系:

使用包管理器安装git(RedHat系)
1
2
3
sudo yum clean all
sudo yum makecache
sudo yum install git

Arch Linux:

使用包管理器安装git(Arch Linux)
1
sudo pacman -Syyuu git

Gentoo:

使用包管理器安装git(Gentoo)
1
2
3
4
5
6
7
8
9
10
11
sudo emerge --sync
#sudo emerge-webrsync
#sudo emerge portage
#sudo emerge python
#/usr/sbin/update-python
sudo emerge -auvDN @world
#sudo emerge -av --depclean
#sudo revdep-rebuild
#sudo dispatch-conf
#sudo emerge -e @world
sudo emerge --ask git

macOS:

使用包管理器安装git(macOS)
1
brew install git

# 安装 Node.js

访问 Node.js 官网以下载 Node.js。

# 安装并配置 Hexo

# 选择位置

# 切换目录

挑选一个你喜欢的、易于访问的文件夹,这可能是你的个人目录 ~ ,也可能是你的文档 ~/Documents 或根目录 / 。切换工作目录至此目录:

切换工作目录至博客目录所在目录
1
2
cd <博客目录所在目录>
# 如`cd ~/Documents`

# 创建目录

为你的博客文件夹命名,如 blogMyBlog ,新建该目录并切换:

新建博客目录并切换
1
2
3
4
mkdir <博客目录>
# 如`mkdir blog`

cd <博客目录>

# 安装 hexo

# 处理安装问题

禁用 npm 包管理器的 SSL 严格检查机制:

禁用SSL检查机制
1
sudo npm config set strict-ssl false

更换源为淘宝镜像:

禁用SSL检查机制
1
sudo npm config set registry https://registry.npm.taobao.org

# 安装 hexo-clihexo

在博客目录下执行命令:

安装hexo-cli和hexo
1
sudo npm install -g hexo-cli hexo

# 初始化博客目录

初始化博客目录
1
2
3
4
sudo hexo init

sudo chown -hR <用户名> .
#如sudo chown -hR scetayh .

# 配置_config.yml 文件

用文本编辑器如 nano 和 VS Code 打开 _config.yml 文件进行编辑,保持主题为 landscape 不变。

# 可选:配置 CNAME 文件

source 目录下新建文本文件 CNAME ,在该文件中输入你已解析 DNS 到 GitHub Pages 的域名。

# 第一次部署

# 安装 hexo-deployer-git

hexo-deployer-git 包用于帮助用户使用 git 来部署博客。

安装hexo-deployer-git包
1
sudo npm i hexo-deployer-git --save

# 部署测试

执行命令:

部署
1
sudo hexo cl && sudo hexo g && sudo hexo d

由于 GitHub Pages 有延迟,请等待约 5 分钟查看你的网站。

# 安装 Yume Shoka

# 克隆仓库

克隆仓库
1
git clone https://github.com/amehime/hexo-theme-shoka.git themes/shoka

# 配置 _config.yml 文件

打开 _config.yml 文件进行编辑,修改主题为 shoka。

# 配置 _config.shoka.yml 文件

打开 _config.shoka.yml 文件进行编辑。

# 安装所需包

# 卸载 hexo-renderer-marked

卸载hexo-renderer-marked包
1
sudo npm un hexo-renderer-marked --save

# 安装各所需包

安装各所需包
1
2
sudo npm i hexo-renderer-multi-markdown-it --save --ignore-scripts
sudo npm i hexo-autoprefixer hexo-algoliasearch hexo-symbols-count-time hexo-feed markdown-it-prism markdown-it-bracketed-spans markdown-it-attrs markdown-it-emoji markdown-it-ins markdown-it-spoiler markdown-it-container markdown-it-task-checkbox markdown-it-ruby furigana-markdown-it markdown-it-katex markdown-it-mermaid markdown-it-toc-and-anchor markdown-it-multimd-table

# 第二次部署

部署
1
sudo hexo cl && sudo hexo g && sudo hexo d

等待约 5 分钟查看你的网站。

# 善后事宜

# 配置 _config.shoka.yml 文件

打开 _config.shoka.yml 文件进行编辑。根据需要添加各项功能,如 Alogolia 等。

# 学习 Markdown

学习 Markdown 语法进行写作。

# 总结

总结
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
cd ~/Documents
mkdir blog
cd blog
sudo npm config set strict-ssl false
sudo npm config set registry https://registry.npm.taobao.org
sudo npm install -g hexo-cli hexo
sudo hexo init
sudo chown -hR scetayh .
#复制文件至source/_posts
#访达权限应用更改到全部项目
#配置_config.yml仅至deploy一行,且主题为landscape
#复制CNAME
sudo npm i hexo-deployer-git --save
sudo hexo cl && sudo hexo g && sudo hexo d
git clone https://github.com/amehime/hexo-theme-shoka.git themes/shoka
#配置_config.yml主题为shoka
sudo npm un hexo-renderer-marked --save
sudo npm i hexo-renderer-multi-markdown-it --save --ignore-scripts
sudo npm i hexo-autoprefixer hexo-algoliasearch hexo-symbols-count-time hexo-feed markdown-it-prism markdown-it-bracketed-spans markdown-it-attrs markdown-it-emoji markdown-it-ins markdown-it-spoiler markdown-it-container markdown-it-task-checkbox markdown-it-ruby furigana-markdown-it markdown-it-katex markdown-it-mermaid markdown-it-toc-and-anchor markdown-it-multimd-table
sudo hexo cl && sudo hexo g && sudo hexo d
#复制文件