说明

本仓库用于hexo搭建个人博客主页 https://wsyoverflow.github.io/

hexo安装

1. 自行安装 Node.js

2. 安装 hexo 命令行工具

   npm install -g hexo-cli 

3. 手动下载安装 pandoc：https://pandoc.org/installing.html

4. 安装 hexo-render-pandoc

   npm install hexo-renderer-pandoc --save

hexo配置

hexo个人博客配置主要参考了 使用 Hexo 搭建个人博客 。

hexo 根目录下_config.yml文件的相关配置：

• hexo发布会清除本仓库文件，为了保留readme。设置skip_render跳过 README.md 文件

  skip_render:
  - README.md

markdown编辑器采用typora，直接在 source/_posts 目录写markdown博客，图片根目录为 source/images。

typora图片路径

为了支持不同层级目录，统一图片存储路径 [/path/to/hexo]/source/images，打开 typora偏好设置 > 图像：

• 图片语法偏好：选中 优先使用相对路径 和 插入时自动转义图片URL

在每个文档中配置 Front-matter，主要配置：

• typora-copy-images-to：插入图片时，图片的保存位置。与 typora偏好设置>图像>插入图片时 里设置的路径同样的作用，只是这里只对当前文档生效。

• typora-root-url 属性，根据当前文档相对于图片根目录的相对路径进行设置。

  以 source/_posts/Paper-Notes/ 下的一篇文档为例，设置

typora-copy-images-to: ..\..\..\images\Paper Notes\${filename}.assets
typora-root-url: ..\..\..\

部署

在hexo根目录 /path/to/hexo 打开终端

本地调试

正式发布前可以先本地调试看看效果

#根据 Markdown 文档生成博客静态文件，可以简写成 hexo g
hexo generate

#在本地启动一个 http 服务器，默认情况下，访问网址为： http://localhost:4000/
hexo server

部署

执行过 hexo g 后即可部署到github主页

hexo deploy -m "commit message"