建站 | Jekyll -＞ mkdocs -＞ hexo on github

• 使用docsify预览项目

Jekyll

之前是用的jekyll，但是没找到我想要的全局搜索功能，有兴趣的还是可以看下：Jekyll建站

---

mkdocs

其实Jekyll已经省去了很多麻烦了，但是我真的真的很烦每个md开头要写一大段乱七八糟的配置，不方便迁移，所以就转到mkdocs了，虽然模板的页面效果没有Jekyll丰富，但是对懒人还是极其友好的。

本来想用mkdocs的，毕竟还是挺省事儿的，文件结构也很清晰，学神点拨下我发现hexo可以全局搜索，跟mkdocs的标题搜索等级比起来，更香了！
简单学了下，后续可能考虑用mkdocs做一些项目文档手册，作为子网址吧，做手册挺合适的。

目前就是服务器上的文件删除.git，但是本地文件保留.git ，利用服务器的hexo环境创建新的draft之类

ref

• 蛮详细的，尤其是关于yml配置文件相关的
• 配置也很详细，尤其有一些关于mkdocs的冷知识
• 列了一些注意事项，which我也觉得很重要
• 这个没仔细看，但是感觉很高贵的样子 将 Jupyter 自动发布到 GitHub Pages

配置中遇到的问题

py37下字符编码遇到的问题

---

hexo

我的两个config.xml（_config.next.xml是对应next主题的配置）都做了比较详细的注释，大家改起来也会很方便，欢迎在我的基础上修改！（虽然我本来也就是改学神的 

ref

1. 环境配置请参考：linux下使用hexo建站

• 安装的时候提示8.x已经deprecated，所以我按照提示安装了12.x
• 在服务器上跑npm install -g hexo-cli等命令的时候，会遇到权限不够，根据提示给sudo就行

2. 推送过程和基本配置网上已经很多了

• next主题的仓库已经过期，我用的是学神给的这个：https://github.com/theme-next/hexo-theme-next
• next主题的基本设置
• hexo主题进阶设置

3. 其他trivial的可选功能

• Hexo添加Disqus评论
• hexo添加google-analytic功能 （ 不想做了2333累了

4. 我的踩坑记录

hexo博客构建细节

基本命令

hexo new ‘文章标题’
hexo new draft
hexo cl # clean

清除缓存文件 (db.json) 和已生成的静态文件 (public)。在某些情况（尤其是更换主题后），如果发现您对站点的更改无论如何也不生效，您可能需要运行该命令。

hexo g # generate
hexo s # server 默认端口4000
hexo d # delpoy

本来是要用这种繁琐的方式的，但是使用了github Actions之后，直接push过去就行

hexo publish [layout] filename # change draft into post

---

mkdown+图床 获取 永久链接 （ 香

可以参考我之前写的文章：typora+gitee图床

---

Actions

• 简单入个门
• hexo+Actions保姆教程

本来想自己写的，结果学神也用的actions，哈哈作业一抄到底 （ docker确实不太精通啊… - -||| ）

---

miscelleous

• 添加多个部署源

deploy:
- type: git
  repo:
- type: heroku
  repo: