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」就应该看到了你的博客啦!

添加新文章

1、打开Hexo目录下的source文件夹,所有的文章都会以md形式保存在_post文件夹中,只要在_post文件夹中新建md类型的文档,就相当于在本地添加了新文章

2、利用来VScode编辑新文章

3、hexo generate

4、hexo deploy

5、去看你的博客,应该能看到这篇新文章啦!

更换主题

1、https://github.com/hexojs/hexo/wiki/Themes 上面有主题合集

2、随便找一个主题,进入主题的 GitHub 首页,比如我找的是 https://github.com/iissnan/hexo-theme-next

3、复制它的 SSH 地址或 HTTPS 地址,假设地址为 git@github.com:iissnan/hexo-theme-next.git

4、cd themes

5、git clone git@github.com:iissnan/hexo-theme-next.git

6、cd ..

7、将 _config.yml 的第 75 行改为 theme: hexo-theme-next,保存

8、hexo generate

9、hexo deploy

10、等一分钟,然后刷新你的博客页面,你会看到一个新的外观,如果不喜欢这个主题,就回到第 1 步,重选一个主题。

tips

1、最好进入一个安全的目录创建源文件夹,在根目录瞎搞;

2、_config.yml中的缩进和空格一定严格按照文件的默认格式来,不然会报错;

3、想要删除博客的话,直接删除source->_posts->对应的博客文章,然后再次执行hexo generate、hexo deploy即可;

4、在_config.yml中修改language为zh-CN,即可将博客中英文转换为中文;

5、常用命令:

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



tools  

GitHub Hexo

本博客所有文章除特别声明外,均采用 CC BY-SA 3.0协议 。转载请注明出处!