' 基于hexo 搭建博客'
🏡实验环境
* windows10
* node v10.16.0
* git version 2.21.0.windows.1
前沿准备
- 准备 git
- 准备 node ,npm
hexo简介
Hexo是一个简单、快速、强大的基于 Github Pages 的博客发布工具,支持Markdown格式,有众多优秀插件和主题。
官网: http://hexo.io
github: https://github.com/hexojs/hexo
由于github pages存放的都是静态文件,博客存放的不只是文章内容,还有文章列表、分类、标签、翻页等动态内容,假如每次写完一篇文章都要手动更新博文目录和相关链接信息,相信谁都会疯掉,所以hexo所做的就是将这些md文件都放在本地,每次写完文章后调用写好的命令来批量完成相关页面的生成,然后再将有改动的页面提交到github。
npm换源
npm是node自带的包管理器,node安装插件是从国外服务器下载,速度慢可能出现问题。
- 使用ali定制的cnpm 命令行工具替代默认的 npm,输入下面的代码安装。
npm install -g cnpm --registry=https://registry.npm.taobao.org
- 检测cnpm版本,如果安装成功可以看到cnpm的基本信息
安装
cnpm install -g hexo
在电脑的某一个地方新建一个文件夹,名字可以随便取,比如我的是 D:\code\hexo,这个文件夹就是我存放代码的地方。
我用的是git bash来执行的命令,没有用cmd
这条命令式切换路径到 d:\code\hexo
cd /d/code/hexo
用cmd的命令应该是
cd /d D:\code\hexo
然后执行hexo 初始化语句 hexo init。
hexo 会自动下载一些文件到当前目录。
hexo g #生成
hexo s #启动
hexo s`是开启本地预览服务,打开浏览器访问 http://localhost:4000 即可看到内容,很多人会碰到浏览器一直在转圈但是就是加载不出来的问题,一般情况下是因为端口占用的缘故,因为4000这个端口太常见了,解决端口冲突问题请参考这篇文章:
hexo init
hexo g
hexo s
第一次初始化的时候hexo已经帮我们写了一篇名为 Hello World 的文章,默认的主题比较丑,打开时就是这个样子:
修改主题
上面那个是我已经修改过的界面,原版的界面相当的丑。
官方主题:主题
这人推荐主题:hexo-theme-yilia
一定要保证在存放的代码目录下
git clone https://github.com/litten/hexo-theme-yilia.git themes/yilia
修改_config.yml
中的theme: landscape
改为theme: yilia
,然后重新执行hexo g
来重新生成,:后面必须要有一个空格。
如果出现一些莫名其妙的问题,可以先执行hexo clean
来清理一下public的内容,然后再来重新生成和发布。
常用的hexo命令
常见命令
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 #生成并上传
注意事项
这里面都是一些全局配置,每个参数的意思都比较简单明了,所以就不作详细介绍了。
需要特别注意的地方是,冒号后面必须有一个空格,否则可能会出问题。
上传到GitHub
我的博客
😁😁欢迎大家访问我的博客
参考文献
https://www.cnblogs.com/liuxianan/p/build-blog-website-by-hexo-github.html