hexo是一个快速、简介且高效的博客框架,拥有一个简单的服务器(可以用来当简单的动态博客使用),也有生成器,生成的静态文件可以一键部署到Github Pages上,用起来比较方便,并且能使用的主题也很多,所以就用它啦~
下面一步一步地说怎么用hexo+github搭建一个个人博客。
说明:本文只针对Windows平台下的搭建过程,其他平台的请自行上网查阅
准备
在搭建博客之前,需要安装node.js和git,具体操作请参考这篇文章,并同时申请Github账号,使用的开发工具为VScode。
安装Hexo
1、首先新建一个文件夹如myBlog,用于存放整个博客源文件。右击鼠标点击文件夹,选中Git Bash Here在Git命令行中打开。
2、执行以下命令安装Hexo及生成第一篇博客文章:
$ npm install -g hexo-cli //安装hexo
$ hexo init //初始化hexo,这样myBlog就是整个博客的根目录,所有的页面都可以在里面进行增删改操作
$ hexo generate //生成静态页面
$ hexo server //启动本地服务器,进行博客文章预览
Hexo会默认生成第一篇博客《Hello World》,在浏览器下打开localhost://4000你将会看到:
myBlog源文件夹整体目录预览:
其中_config.yml和package.json为项目的配置文件,themes存放了我们博客的主题,source->_post为我们的博客目录,public为执行hexo generate后生成的静态页面。
关联Github
1、在你的Github中建立新的 repo,repo 名称必须是「你的用户名.http://github.io」(注意你的户名是你的GitHub的用户名),此处我创建的仓库名为:
http://miqilin21.github.io,然后与我们的博客建立关联。
2、将myBlog目录中的_config.yml文件在VScode中打开,编辑网站配置:
- 把第 6 行的 title 改成你想要的名字
- 把第 10 行的 author 改成你想取大名
- 把最后一行的 type 改成
type: git
- 在最后一行后面新增一行,左边与 type 平齐,加上一行
repo: 仓库地址
(请将仓库地址改为「你的用户名.github.io」对应的仓库地址,仓库地址最好以 git@github.com: 开头)
3、修改完成配置后在myBlog目录下执行命令:
$ npm install hexo-deployer-git --save //安装 git 部署插件
$ hexo deploy //将本地博客代码部署到Github上
4、进入「你的用户名.http://github.io」对应的 repo,打开 GitHub Pages 功能,如果已经打开了,你应该会看到一个预览链接;最后用浏览器访问「预览链接/index.html」就应该看到了你的博客啦!
添加新文章
- 打开Hexo目录下的
source
文件夹,所有的文章都会以md形式保存在_post
文件夹中,只要在_post
文件夹中新建md类型的文档,就相当于在本地添加了新文章 - 利用来VScode编辑新文章
hexo generate
hexo deploy
- 去看你的博客,应该能看到这篇新文章啦!
更换主题
- https://github.com/hexojs/hexo/wiki/Themes 上面有主题合集
- 随便找一个主题,进入主题的 GitHub 首页,比如我找的是 https://github.com/iissnan/hexo-theme-next
- 复制它的 SSH 地址或 HTTPS 地址,假设地址为 git@github.com:iissnan/hexo-theme-next.git
cd themes
git clone git@github.com:iissnan/hexo-theme-next.git
cd ..
- 将 _config.yml 的第 75 行改为
theme: hexo-theme-next
,保存 hexo generate
hexo deploy
- 等一分钟,然后刷新你的博客页面,你会看到一个新的外观,如果不喜欢这个主题,就回到第 1 步,重选一个主题。
tips
- 最好进入一个安全的目录创建源文件夹,别在根目录瞎搞;
- _config.yml中的缩进和空格一定严格按照文件的默认格式来,不然会报错;
- 想要删除博客的话,直接删除source->_posts->对应的博客文章,然后再次执行hexo generate、hexo deploy即可;
- 在_config.yml中修改language为zh-CN,即可将博客中英文转换为中文;
- 常用命令:
hexo new "postName" //新建文章
hexo new page "pageName" //新建页面
hexo clean //清除缓存文件db.json和已生成的静态文件 public,网站显示异常时可以执行这条命令试试。
hexo generate //生成静态文件
hexo deploy //部署到Giihub
hexo server //启动本地服务器
hexo help //查询帮助
6. md文件需要用到markdown语法。
本人Github链接如下,欢迎各位Star
https://github.com/miqilin21/miqilin21.github.io