这是我参与
「第四届青训营」笔记创作活动的第6天
快速搭建HEXO博客
HEXO是一个简单,快速的博客框架,能直接显示MarkDown格式的内容,还能使用各式各样的主题展现自己的风格。
环境准备
安装Node.js(建议版本12.0及以上)和Git工具
注意: 不同操作系统的安装过程是不同的,详情可阅读 官方文档
在控制台使用node -v命令查看node.js版本
可能出现的问题
输入命令时控制台出现不是内部或外部命令,也不是可运行的程序或批处理文件
配置npm
将npm的安装模块路径设置成自己想要的(默认在C盘),能有效减少对系统盘的负荷,也利于管理所安装的包。
-
在nodeJS的安装目录新建global与cache文件夹用于存放npm下载的文件(也可在自己需要的目录下)
- 在控制台运行
npm config set prefix "重设的global路径"npm config set cache "重设的cache路径"
- 通过
npm config -ls命令查看npm的配置信息
- 在控制台运行
-
重设镜像源
npm config set registry=http://registry.npm.taobao.orgnpm config get registry检查源配置
-
PS:或者使用cnpm代替npm,效果是一样的
//cnpm安装方式
npm install -g cnpm --registry=https://registry.npm.taobao.org
安装Hexo
安装并配置完npm后就能使用npm安装hexo
npm install -g hexo-cli
查看hexo版本:hexo -v
如何使用Hexo
新建博客资源
(一切hexo命令都要在目标文件夹根目录中执行)
- 准备一个空文件夹用于存放blog资源
- 在目标文件夹路径中打开控制台,使用
hexo init初始化Hexo框架 - hexo相关常用命令:
hexo clean清空缓存和生成的静态文件,当出现异常或改动不生效时可运行此命令hexo g生成静态文件hexo s启动blog,默认端口4000hexo n新建一个md文件用于展示文章,(推荐使用markdown编辑器写好文章后导入/source/_posts中,但要注意文章属性设置,否则会添加失败)
关于配置
在根目录中的_config.yml文件可以修改关于blog的属性,关于配置
| 网站常用属性 | 描述 |
|---|---|
| title | 博客的主标题 |
| author | 你的名字 |
| language | 网站使用的语言 |
| description | 博客描述 |
| theme | 更换主题(需要将主题文件放在themes目录中) |
文章属性需要放在最上方用---隔开
//例如:
---
title: Hello World
date: 2022/22/22 22:22:22
---
| 文章常用属性 | 描述 |
|---|---|
| title: | 文章标题 |
| tag: | 标签 |
| date: | 建立日期 |
| categories: | 分类 |
每次修改完配置后建议最好clean一下再重新生成
Github部署
将博客放进Github仓库中就能远程访问了,也可部署在个人服务器上
- 建立一个Github仓管,命名需为:Git用户名.github.io
- 使用npm安装
npm install --save hexo-deployer-git - 在_config.yml中配置Git站点
deploy: - type: git repo: https://github.com/xxx/xxx.github.io.git branch: master - 配置完成后使用
hexo d将静态文件上传到Git仓库- PS: 如出现上传失败情况可能是没有配置git的用户信息
- 在git push中输入:
git config --global user.name "xxxx"git config --global user.email "xxx@xxx"
- 在git push中输入:
- PS: 如出现上传失败情况可能是没有配置git的用户信息
- 第一次使用会提示输入密码,然后等部署完成
- 网址输入xxx.github.io就能访问自己的博客了(出于某种原因git的访问速度会比较慢)