本文默认已经安装好git和node.js环境
版本说明:git version 2.16.2.windows.1 、 node.js v8.9.4
Hexo是什么
Hexo 是一个快速、简洁且高效的博客框架,这里不多介绍,丢个链接,感兴趣的自己去看吧:https://hexo.io/zh-cn/,里面的东西比较多,不光有hexo使用文档,还有众多的hexo插件和主题。
我的Hexo博客主页效果图
欢迎来访~https://userzhao.coding.me/
安装Hexo
建立默认主题博客
blog为博客存储文件夹名称,可随意命名,本文以blog为例。最好命名与GitHub Pages仓库名称一致,省的后面修改,不过都是小case
因为要下载文件,而且是从github下载,如果可以“科学上网”,可以开一下。
此时打开localhost:4000即可看到默认主题的Hexo博客
选择主题
在https://hexo.io/themes/里面有200+的主题可供选择,我推荐几款个人比较喜欢的
应用主题
选择好主题后,进入对应的github项目主页,一般都会有README文件帮助完成后续搭建,若无可以参考下面步骤进行,进入之前搭建好的博客主题文件目录下(本文为:blog/themes/),检出主题文件
然后修改博客配置文件_config.yml,添加下面这行
注意:①xxx为主题名称
②不是主题的配置文件哦,在博客文件夹根目录下
配置文件详解
搭建整个博客过程中有两个配置文件,非常重要,一个是博客配置文件,一个是主题配置文件分别存放在各自的根目录下,文件名均为_config.yml
博客配置文件
主题配置文件,这个是https://github.com/maochunguang/black-blue主题的配置文件,已经比较详细了,直接贴上来了
日常产出博客
写作
新建文章
我用的博客模板为:
新建页面
本地启动
启动之后http://localhost:4000 即可看到效果
本地调试
进入调试模式,可以看到详细的启动日志,包含hexo版本、工作目录、插件、博客目录、静态文件等信息,同时访问调试博客时还可以看到各资源响应状态和时间等信息。这种模式下调试博客样式及特效非常方便。
提交文件到github
即可提交到本地仓库,不熟悉git命令的可以查看我的另一篇博文https://www.yizhuxiaozhan.site/2018/09/27/git-commands/
GitHub Pages配置
这里仓库名称有两种命名方式:
①github账户的 用户名+github.io,这种仓库访问地址为:https://用户名.github.io/
②随意命名只要与你其他仓库名称不冲突即可,例如hexo-blog,则访问地址为:https://github.com/+用户名+/hexo-blog/
大多数都会选择第一种格式创建仓库
①GitHub Page仓库资源文件必须存放master分之
②下面可以配置自己的域名,配置之后会在仓库根目录生成CNAME文件,同时要将域名解析到仓库访问地址
连接本地仓库和远程仓库
将本地博客文件夹名称改为与仓库名称一致 ,然后将二者关联
部署到Hexo远程仓库
hexo命令支持简写,条件是只有一个匹配项,egs:当安装了hexo-douban 之后执行hexo d就需要区分hexo deploy和hexo douban这两个命令了,可以分别使用hexo de和hexo do来调用
部署完成之后即可在上面设置的访问地址中看到效果了。
Hexo插件推荐
与主题一样,https://hexo.io/plugins/也收录了200余种插件,这里推荐几款个人喜欢的
豆瓣插件
这款插件貌似对于我正在用的主题插件(black-blue)支持的不是很好,要修改很多东西,我直接弃用了,但是这款插件的还是不错的,所以推荐下。
安装
配置
使用
菜单
如果上面的显示没有问题就可以在主题的配置文件 _config.yml 里添加如下配置来为这些页面添加菜单链接.
更多信息可以关注我的个人博客:https://www.yizhuxiaozhan.site或https://userzhao.coding.me
也欢迎关注我的公众号:yizhuxiaozhan,二维码:
评论留言