本网站(指水博客)采用 Hexo 框架和 Yume Shoka 主题搭建,这里要感谢琉璃大人的贡献。
本简明教程提供一组安装命令供 GNU/Linux 发行版和 macOS 用户使用~~(免去了复制的麻烦)~~。
# 安装依赖
# 安装 git
使用包管理器安装 git
。
Debian 系:
1 | sudo apt update |
RedHat 系:
1 | sudo yum clean all |
Arch Linux:
1 | sudo pacman -Syyuu git |
Gentoo:
1 | sudo emerge --sync |
macOS:
1 | brew install git |
# 安装 Node.js
访问 Node.js 官网以下载 Node.js。
# 安装并配置 Hexo
# 选择位置
# 切换目录
挑选一个你喜欢的、易于访问的文件夹,这可能是你的个人目录 ~
,也可能是你的文档 ~/Documents
或根目录 /
。切换工作目录至此目录:
1 | cd <博客目录所在目录> |
# 创建目录
为你的博客文件夹命名,如 blog
或 MyBlog
,新建该目录并切换:
1 | mkdir <博客目录> |
# 安装 hexo
# 处理安装问题
禁用 npm
包管理器的 SSL 严格检查机制:
1 | sudo npm config set strict-ssl false |
更换源为淘宝镜像:
1 | sudo npm config set registry https://registry.npm.taobao.org |
# 安装 hexo-cli
和 hexo
包
在博客目录下执行命令:
1 | sudo npm install -g hexo-cli hexo |
# 初始化博客目录
1 | sudo hexo init |
# 配置_config.yml 文件
用文本编辑器如 nano
和 VS Code 打开 _config.yml
文件进行编辑,保持主题为 landscape 不变。
# 可选:配置 CNAME
文件
在 source
目录下新建文本文件 CNAME
,在该文件中输入你已解析 DNS 到 GitHub Pages 的域名。
# 第一次部署
# 安装 hexo-deployer-git
包
hexo-deployer-git
包用于帮助用户使用 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
包
1 | sudo npm un hexo-renderer-marked --save |
# 安装各所需包
1 | sudo npm i hexo-renderer-multi-markdown-it --save --ignore-scripts |
# 第二次部署
1 | sudo hexo cl && sudo hexo g && sudo hexo d |
等待约 5 分钟查看你的网站。
# 善后事宜
# 配置 _config.shoka.yml
文件
打开 _config.shoka.yml
文件进行编辑。根据需要添加各项功能,如 Alogolia 等。
# 学习 Markdown
学习 Markdown 语法进行写作。
# 总结
1 | cd ~/Documents |