体验hexo+github搭建免费个人博客

一时兴起，体验一下搭建免费个人博客，记录一下过程。最终博客地址https://guozengjie.github.io
参考文章
https://www.cnblogs.com/liuxianan/p/build-blog-website-by-hexo-github.html

简而言之：hexo是个静态页面生成、上传的工具
hexo官网https://hexo.io/zh-cn/

根据文档下载hexo

npm install hexo-cli -g
hexo init blog
cd blog
npm install
hexo server

执行上述命令后，用浏览器打开http://localhost:4000

image.png

主题有点不美观，换一个

https://hexo.io/themes/中搜索jekyll主题，该主题的github地址为https://github.com/pinggod/hexo-theme-jekyll 根据文档执行相应命令

npm install --save hexo-renderer-jade hexo-generator-feed
git clone https://github.com/pinggod/hexo-theme-jekyll.git themes/jekyll

修改_config.yml文件中的theme属性，以及jekyll主题的相应配置

theme: jekyll
jekyll:
  project: false
  selfIntro: true
  sign_image: image/bear.svg

然后重新生成静态网页并且启动服务器

hexo g && hexo s

image.png

上传到github

首先在github上创建一个仓库，参考文档https://pages.github.com/
仓库名字为 username.github.io,username为自定义名字，等上传成功后可通过username.github.io访问自己的博客

image.png

通过hexo上传到github，需要hexo-deployer-git插件，安装插件

npm install hexo-deployer-git

打开hexo配置文件_config.yml修改deploy

deploy:
  type: git
  repository: [email protected]:guozengjie/guozengjie.github.io.git
  branch: master

上传到github

hexo d

此时可以通过仓库名访问自己的博客https://guozengjie.github.io/

写博客

新建一篇博客

hexo new 我的第一篇博客

编辑Markdown文件，强烈建议使用Typora软件，简洁大方

image.png

创建的md文件头部声明中记得加空格，否则会报错YAMLException: can not read a block mapping entry

image.png

生成静态页面并上传

 hexo d -g

image.png

hexo常用命令

hexo clean #清除本地 public 文件
hexo new "postName" #新建文章
hexo new page "pageName" #新建页面
hexo generate #生成静态页面至public目录
hexo server #开启预览访问端口（默认端口4000，'ctrl + c'关闭server）
hexo deploy #部署到GitHub
hexo help  # 查看帮助
hexo version  #查看Hexo的版本

缩写

hexo n == hexo new
hexo g == hexo generate
hexo s == hexo server
hexo d == hexo deploy

组合命令

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

网站的简单配置

title: EmpathyBasic
subtitle: '有道无术，术尚可求，有术无道，止于术。'
description: ''
keywords:
author: EmpathyBasic
language: zh-CN
timezone: ''

最后发现一个新主题hexo-theme-matery

image.png