超详细的Hexo个人博客搭建

前沿

记录一下个人博客的搭建过程,总体搭建的过程相对比较顺利,注意一些命令以及报错的原因,搭建的环境是win10系统,如果系统不一样一些地方存在差异,但差异不是很大。
个人博客的主要作用:

  • 总结记录知识点
  • 展示自己
  • 自由度较高

搭建完成后的效果图


Github设置

注册或者登陆github

登陆github如果没有账号进行简单的注册即可,有的话直接登陆,下图是我的github账号,欢迎一起学习!


github建立个人仓库

点击左上角头像旁边+号,下拉点击New repository(新建仓库或项目):


GitHub仓库的名称需要按照规定来写,规则如下:

username.github.io

比如我的 GitHub 用户名是gofisher,那我就要填写 gofisher.github.io,接下来是对项目的简单的描述,然后选择Public模式,接着点击创建仓库按钮。



创建成功后,点击项目名进入项目的主页面,再点击Settings:



下拉滚动条到GitHub Pages区域,进行设置:



点击右下按钮继续设置:



最后选择选择一个网站的模版(可以任意选择,后面会进行更改),点击public按钮:



到此,已经完成github pages的设置,创建的项目增加了一些文件(下图是已经搭建好博客文件目录,现在其实没有这么多的文件):



这个时候,就可以通过username.github.io来访问此页面,显示的应该是你选择的网页模版,如果显示成功说明github pages设置成功,如果无法显示,请仔细检查错误。

Git的安装和github-SSH KEY的配置

git的安装

git官网选择合适的git版本,进行下载:



下载完成,与普通的软件安装方式一致,安装完成后,点击菜单多出Git GUI Here和Git Base Here两项(具体作用请自己查询,本文用不到,可以不用理会,只是说明一下。):


Git系统环境变量的配置

下图显示的win 10 系统的系统环境配置,不同系统的环境配置大同小异,注意一点就是git的配置是本地安装的目录:



测试Git是否配置成功,打开命令提示符,输入git命令,是否显示如下,如果有则配置成功:


设置Git的user name和email(初次):

在命令提示符中输入如下命令:

1
2
3
4
# 这里的“gofisher" 可以替换成自己的用户名
git config --global user.name "gofisher"
# 这里的邮箱493913124@qq.com替换成自己的邮箱,github的邮箱账号
git config --global user.email "493913124@qq.com"

生成密钥

1
2
# 这里的邮箱493913124@qq.com替换成自己的邮箱
ssh-keygen -t rsa -C "gdutxiaoxu@163.com"

密码是不显示符号,正确输入回车即可,输入两次,最后得到了两个文件:id_rsa和id_rsa.pub(密钥)

默认的存储路径是:C:\Users\GoFisher.ssh

Gofisher是自己系统的用户名

登陆Github, 添加 ssh

点击New SSH key,把id_rsa.pub文件里的内容复制进去:



测试

1
$ ssh -T git@github.com

如果需要输入密码,输入github的密码即可,如果看到Hi后面是你的用户名,就说明成功了:


使用hexo

安装Node

在Windows下,从 https://nodejs.org/en 下载以.msi为扩展名的安装包,如果不需要进行node相关开发的话,选LTS版本就够用了。



注意:然后也对node进行系统环境配置,步骤和上面一样,主要目的便于命令行的使用 **。

安装hexo

1
2
npm install -g hexo-cli
npm install hexo-deployer-git --save # 安装部署站点的node功能包,hexo deploy命令需要

建立站点仓库

1
2
3
hexo init blog # 在合适的文件目录,初始化一个站点目录
cd blog
npm install

站点的目录文件

一般hexo初始化后的站点目录结构如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
/blog
|-- _config.yml # 站点配置文件
|-- scaffolds # 页面模板存放的目录
| |-- post.html # 博文模板
| |-- page.html # 分页模板
| \-- draft.html # 草稿模板
|-- source # 博文源文件目录
| |-- _posts # 存放博文的目录
| \-- _drafts # 存放草稿的目录
|-- themes # 存放主题文件夹的目录
|-- package.json
|-- node_modules # 功能依赖包
\-- .gitignore # push的时候忽略node_modules文件夹等

修改_config.yml文件,整个站点的配置主要是在这个文件中修改:

1
2
3
4
5
6
7
8
9
10
11
title: 博客名
description: 博客简述
author: 作者名
url: http(s)://your.site.com
root: /your/project/path or /

deploy:
type: git
repo: git@github.com:userName/blog.git
branch: gh-pages
message: [自定义的提交信息]

站点的本地查看

1
2
hexo g # 生成编译后的静态站点文件
hexo s # 打开服务,可以在本地查看点击生成的本地连接即可

站点的部署(所有修改后文件部署到github的命令套餐)

1
2
3
hexo clean #清除public文件夹()
hexo g # 生成编译后的静态站点文件
hexo d # 部署到远程仓库

常用hexo命令

1
2
3
4
5
6
7
8
hexo init <站点仓库的目录> # 初始化一个站点目录
hexo clean # 用于主题切换等涉及站点整体布局效果改变的行为时,清楚hexo原有缓存
hexo new '博文标题' # 新增一篇博文
hexo generate # 可简写为 hexo g ,编译生成静态页面文件
hexo server # 可简写为 hexo s ,开启本地服务器预览与测试编译生成的静态页面效果
hexo delpoy # 可简写为 hexo d ,部署站点到远程仓库
hexo generate -d # 可简写为 hexo g -d ,编译生成静态页面文件并部署到远程仓库
hexo deploy -g # 可简写为 hexo d -g ,同上

修改主题

从hexo themes找到何意的主题,clone下来,放到站点本地仓库的themes目录下,修改_config.yml文件的theme字段为对应的主题名:

theme: <下载的主题名>

博客的美化

注意事项

  • 尽管GitHub个人网站项目是免费的,但是却有一些限制。总体来说,完全够用,甚至太多了。
  • 单个仓库大小不超过1GB,上传单个文件大小不能超过100MB,如果通过浏览器上传不能超过25MB
  • 个人网站项目也不例外,最大空间1GB
  • 个人网站项目每个月访问请求数不能超过10万次,总流量不能超过100GB
  • 个人网站项目一小时创建数量不能超过10个

参考链接


  • 本文作者:YuJianZhe
  • 本文标签:超详细的Hexo个人博客搭建
  • 本文链接: 2018/06/18/个人博客/
  • 发布时间: 2018年6月18日 - 00时06分
  • 版权声明: 本博客所有文章除特别声明外,均采用 CC BY-NC-SA 3.0 CN 许可协议。转载请注明出处!
Donate comment here