Jekyll
之前是用的jekyll,但是没找到我想要的全局搜索功能,有兴趣的还是可以看下:Jekyll建站
mkdocs
其实Jekyll已经省去了很多麻烦了,但是我真的真的很烦每个md开头要写一大段乱七八糟的配置,不方便迁移,所以就转到mkdocs了,虽然模板的页面效果没有Jekyll丰富,但是对懒人还是极其友好的。
本来想用mkdocs的,毕竟还是挺省事儿的,文件结构也很清晰,学神点拨下我发现hexo可以全局搜索,跟mkdocs的标题搜索等级比起来,更香了!
简单学了下,后续可能考虑用mkdocs做一些项目文档手册,作为子网址吧,做手册挺合适的。
ref
- 蛮详细的,尤其是关于yml配置文件相关的
- 配置也很详细,尤其有一些关于mkdocs的冷知识
- 列了一些注意事项,which我也觉得很重要
- 这个没仔细看,但是感觉很高贵的样子 将 Jupyter 自动发布到 GitHub Pages
配置中遇到的问题
py37下字符编码遇到的问题
hexo
我的两个config.xml(_config.next.xml是对应next主题的配置)都做了比较详细的注释,大家改起来也会很方便,欢迎在我的基础上修改!(虽然我本来也就是改学神的 :)
ref
环境配置请参考:linux下使用hexo建站
- 安装的时候提示8.x已经deprecated,所以我按照提示安装了12.x
- 在服务器上跑
npm install -g hexo-cli
等命令的时候,会遇到权限不够,根据提示给sudo就行
推送过程和基本配置网上已经很多了
- next主题的仓库已经过期,我用的是学神给的这个:https://github.com/theme-next/hexo-theme-next
- next主题的基本设置
- hexo主题进阶设置
其他trivial的可选功能
- Hexo添加Disqus评论
- hexo添加google-analytic功能 ( 不想做了2333累了
基本命令
hexo new ‘文章标题’
hexo new draft
hexo clean
清除缓存文件 (db.json) 和已生成的静态文件 (public)。在某些情况(尤其是更换主题后),如果发现您对站点的更改无论如何也不生效,您可能需要运行该命令。
hexo g
hexo s
hexo d
mkdown+图床 获取 永久链接 ( 香
可以参考我之前写的文章:typora+gitee图床
Actions
- 简单入个门
- hexo+Actions保姆教程
本来想自己写的,结果学神也用的actions,哈哈作业一抄到底 ( docker确实不太精通啊… - -||| )
miscelleous
- 添加多个部署源
1
2
3
4
5deploy:
- type: git
repo:
- type: heroku
repo: