使用hexo搭建github博客
搭建环境:Mac
使用hexo的优点:可以使用Markdown编辑页面,各种各样的Markdown编辑器使用起来非常方便
步骤一、创建github仓库
在github创建与用户名对应的仓库,如用户名为Lie8466,则需要创建的仓库为 Lie8466.github.io。
参考文档:pages.github.com/ 中的步骤1
注:如果已经创建过,请忽略此步。hexo部署完毕后会更改默认的index页面
步骤二、安装hexo
$ npm install -g hexo复制代码
手动创建hexo文件夹,假如创建的目录为/Users/yaweili/Documents/hexo
$ cd /Users/yaweili/Documents/hexo
$ hexo init
$ npm install
$ hexo server复制代码
Hexo Server已经启动了,在浏览器中打开 http://localhost:4000 ,
你可以按Ctrl+C 停止Server。
打开新的命令行窗口(command+T),创建新文章,"My New Post"
$ hexo new "My New Post"复制代码
执行下面的命令,将markdown文件生成静态网页。
$ hexo generate复制代码
编辑文章
在/Users/yaweili/Documents/hexo/source/_posts下可以看到My-New-Post.md文件,利用markdown编辑器编辑该文件
部署github
在/Users/yaweili/Documents/hexo下找到文件_config.yml,用编辑器打开,找到
# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:type:复制代码
修改为:
# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:type: gitrepository: https://github.com/Lie8466/Lie8466.github.io.gitbranch: master复制代码
安装hexo-deployer-git, 以及部署
$ npm install hexo-deployer-git --save
$ hexo deploy复制代码
参考文档 hexo.io/zh-cn/docs/…
部署参考 hexo.io/zh-cn/docs/…
部署成功
在浏览器中打开 Lie8466.github.io ,正常显示网页,表明部署成功。
调试
修改/Users/yaweili/Documents/hexo/source/_posts下的.md文件,刷新localhost:4000可以看到实时的更新
部署:
$ hexo clean
$ hexo generation // 或者hexo g
$ hexo deploy // 或者hexo d复制代码
其它
/Users/yaweili/Documents/hexo/_config.yml有很多可以自己配置的小功能点,理解每一个配置项的含义可以个性化定制自己的页面
配置标题
# Site
title: Yawei Li // 配置网站首页的大标题,默认为hexo
subtitle: knowing something of everything and everything of something // 配置网站首页的副标题,默认无
description:
author: Yawei Li
language: zh
timezone:复制代码
配置页面路径
# URL
## If your site is put in a subdirectory, set url as 'http://yoursite.com/child' and root as '/child/'
url: http://yoursite.com
root: /
permalink: :year/:title/ // 配置页面的路径,默认为年/月/日/标题,会显示太长,可以自行删掉一些信息
permalink_defaults:复制代码
配置分类及标签
# Category & Tag
default_category: conclusion
category_map: ['学习笔记', '总结', '分享', '其它']
tag_map: ['JS', 'Vue', '前端性能', '其它']复制代码
上述配置的分类和标签可以在新建的.md文件中使用,如下:
---
title: hexo搭建github博客date: 2017-10-30 11:06:24category: 总结tags: 其它---复制代码
配置完成的分类和标签会在博客首页有相应的筛选项,可以快速查找某一个类型或者某个标签下的文章。
更多功能等待发现。。。
参考文档:www.cnblogs.com/zhcncn/p/40…