搭建博客主要使用了Github Pages、Hexo 博客框架和Butterfly主题。

本地环境配置

安装Node.js

根据hexo官方文档的说明,Linux(DEB/RPM-based):从 NodeSource 安装。

根据下面命令行安装node.js,注意选择自己相符的系统

1
2
3
4
5
6
7
# Using Ubuntu
curl -sL https://deb.nodesource.com/setup_12.x | sudo -E bash -
sudo apt-get install -y nodejs

# Using Debian, as root
curl -sL https://deb.nodesource.com/setup_12.x | bash -
apt-get install -y nodejs

安装完成之后,输入node -v,得到版本号,我的是v12.16.0,无报错的话则安装成功。

安装Git

如果已经安装Git则不必安装,没有安装按照文档自行安装。

安装Hexo

  • 打开命令行,输入npm install -g hexo-cli
  • 待安装结束之后,输入hexo -v
  • 得到hexo-cli: 3.1.0等一连串数据,则安装成功

创建本地博客

  • 下载博客配置信息

    不需要重新生成,直接使用我上传到github的资源即可

    注意: github上的mathmodels.github.io是博客渲染后的静态网页文件,本地的mathmodels.github.io才是原生网页文件

    使用百度云下载:

    链接:https://pan.baidu.com/s/1-Q8c3-cTGDrhWSNSyZxTvQ
    提取码:sbsf

    记得把博客系统放到一个合适的路径

  • 解压刚刚下载的文件tar -xvf mathmodels.github.io.tar

  • 进入到项目目录中cd mathmodels.github.io

  • 输入 hexo g 生成(generate)网页。 生成的网页会展示 Hexo 里面自带了一个 Hello World 的博客。

  • 输入 hexo s 将生成的网页放在了本地服务器(server)。

  • 浏览器里输入 http://localhost:4000/ 。 就可以看到刚才的成果了。

  • 回到 Git Bash,按 Ctrl+C 结束。

  • 此时再看 http://localhost:4000/ 就是无法访问了。

发布一篇博客

  • 新增post:继续在mathmodels.github.io目录中,输入 hexo new "My First Post"
  • 编辑post:在mathmodels.github.io/source/_posts路径下,会有一个My First Post.md的文件,编辑这个文件,然后保存,格式可以参照目录已有的其他文章。
  • 发布post:使用简化命令hexo g -d,可完成生成网页静态文件并部署到github上,github的一切配置均以配置,简单三步就可以发布一篇文章。
  • 得到 INFO Deploy done: git 即为发布成功
  • 查看成果mathmodels.github.io

其他说明

  • hexo用法
1
2
3
4
5
6
7
hexo new "postName" #新建文章
hexo new page "pageName" #新建页面
hexo generate #生成静态页面至public目录
hexo server #开启预览访问端口(默认端口4000,'ctrl + c'关闭server)
hexo deploy #部署到GitHub
hexo help # 查看帮助
hexo version #查看Hexo的版本

​ 缩写

1
2
3
4
hexo n == hexo new
hexo g == hexo generate
hexo s == hexo server
hexo d == hexo deploy

​ 组合命令

1
2
hexo g -s #生成并本地预览
hexo g -d #生成并上传

​ 详情参考:hexo官方文档Hexo-博文编辑手册 | 思维之

  • markdown编辑器推荐用Typora

  • 公式生成推荐使用Mathpix Snipping Tool

  • 我的系统是Windows,直接这样移植可能会出现问题,我看都是代码文件,并没有编译Windows下的bat、cmd,应该并无大碍,如果不行的话,就在Ubuntu上重新安装一下npm包也不麻烦。