前提
-
会写markdown
-
配置node环境
-
node环境自带npm市场
npm install hexo-cli -g hexo init blog cd blog npm install hexo server -
完成之后,制定文件夹的目录如下
├── _config.yml ├── package.json ├── scaffolds ├── source | ├── _drafts | └── _posts └── themes
重要文件夹
- _config.yml
- 作用:
- 1.配置发布信息
- 2.配置一些静态文件夹目录
- 作用:
- package.json
- 作用:
- 1.查看一些依赖包
- 2.配置一些调试命令行语句(如:npm run build就可以代替hexo generate,如果有yarn就更方便了,直接yarn build)
- 作用:
- source/_posts
- 作用:
- 1.此处是作者真正写作的地方
- 作用:
用法
扩展依赖准备
- 目的:让作者在创作的过程中更好的使用体验
- 具体依赖:
- hexo-deployer-git
- 作用:可以直接hexo deploy之后部署到github上
- hexo-renderer-marked
- 作用:可以更加爽快的导入图片资源到markdown
- hexo-deployer-git
- 操作
npm install hexo-deployer-git hexo-renderer-marked --save
在_config.yml图片资源配置
- 图片配置如下
post_asset_folder: true marked: prependRoot: true postAsset: true
新建一篇文章
hexo new '文章的标题'
- 因为安装了hexo-renderer-marked,所以new的时候会在source/_posts下新建一个markdown文件和一个同名的文件夹,文件夹用来存储相应的markdown中用到的图片资源
开发环境预览调试
hexo serve
- 执行以上的命令之后,可以登录http://localhost:4000看到热编译出来的效果,在终端ctrl+c可以停止热编译
构建
hexo generate
- 执行以上的命令之后,目录中生成一个public文件夹,里面就是要被部署到github上的文件
清楚缓存
hexo clean
- 执行以上命令可以清楚public文件夹
部署前准备
- 在github中创建一个“自己的登录名.github.io”的仓库(建后可以拥有一个github提供的域名地址,地址就是仓库名)
- 部署配置如下,在_config.yml中
deploy: type: git repo: <仓库地址>(最好用ssh网址) branch: dev(这里填写分支名,用自己的分支就行)
部署
hexo deploy
- 以后每次只需要新建,写的时候编译自测下,写完之后部署基本就可以
- 注意部署的时候最好清楚一下缓存,这样可以减少一些缓存带来的错误
主要命令
- hexo new <文章>
- hexo deploy