github+hexo搭建自己的博客网站(一)基础入门

时间:2021-11-15 22:24:54

github提供的page,hexo提供的静态博客文档,这样可以搭建一个自己的一个博客网站。

使用github pages服务搭建博客的好处有:

  1. 全是静态文件,访问速度快;
  2. 免费方便,不用花一分钱就可以搭建一个*的个人博客,不需要服务器不需要后台;
  3. 可以随意绑定自己的域名,不仔细看的话根本看不出来你的网站是基于github的;
  4. 数据绝对安全,基于github的版本管理,想恢复到哪个历史版本都行;
  5. 博客内容可以轻松打包、转移、发布到其它平台;

一、github相关设置

1、在github上创建一个项目

注意:项目名称必须为自己   github的用户名.github.io

github+hexo搭建自己的博客网站(一)基础入门

2、代码库的设置

开启gh-pages功能,点击界面右侧的Settings,你将会打开这个库的setting页面,向下拖动,直到看见GitHub Pages。

之前是需要:点击Automatic page generator,Github将会自动替你创建出一个gh-pages的页面。 如果你的配置没有问题,那么大约15分钟之后,yourname.github.io这个网址就可以正常访问了~ 如果yourname.github.io已经可以正常访问了,那么Github一侧的配置已经全部结束了。

现在不需要设置page generator。就可以访问https://saucxs.github.io/

github+hexo搭建自己的博客网站(一)基础入门

二、安装hexo

1、全局安装hexo-cli指令

npm install hexo-cli -g

查看hexo版本

hexo -v

2、初始化hexo

hexo init

hexo会自动下载一些文件到这个目录,包括node_modules,目录结构如下图:

github+hexo搭建自己的博客网站(一)基础入门

3、开始体验hexo

hexo g

生成静态文件到public文件夹,没有public文件夹就会自动创建,如果有了就会覆盖public内容。

public文件夹的内容是要提交到github上的。

github+hexo搭建自己的博客网站(一)基础入门

4、开启本地服务

hexo s

hexo s是开启本地预览服务,打开浏览器访问 http://localhost:4000 即可看到内容,很多人会碰到浏览器一直在转圈但是就是加载不出来的问题,一般情况下是因为端口占用的缘故,因为4000这个端口太常见了,解决端口冲突问题。

github+hexo搭建自己的博客网站(一)基础入门

 三、如何将hexo与github page联系起来

分为3步:

1、配置SSH key

2、设置Git的user name和email

3、配置deployment

1、配置SSH key

如果你之前已经配置好git个人信息,请跳过这一个 步骤,直接来到

为什么要配置这个呢?因为你提交代码肯定要拥有你的github权限才可以,但是直接使用用户名和密码太不安全了,所以我们使用ssh key来解决本地和服务器的连接问题。

$ cd ~/. ssh #检查本机已存在的ssh密钥

如果提示:No such file or directory 说明你是第一次使用git。

ssh-keygen -t rsa -C "邮箱"

然后连续3次回车,最终会生成一个文件在用户目录下,

github+hexo搭建自己的博客网站(一)基础入门

打开用户目录,找到.ssh\id_rsa.pub文件,记事本打开并复制里面的内容,打开你的github主页,进入个人设置 -> SSH and GPG keys -> New SSH key:

刚复制的内容粘贴到key那里,title随便填,保存。

github+hexo搭建自己的博客网站(一)基础入门

测试一下是否成功

$ ssh -T git@github.com # 注意邮箱地址不用改

github+hexo搭建自己的博客网站(一)基础入门

看到这个信息说明SSH已配置成功!

2、设置Git的user name和email

$ git config --global user.name "liuxianan"// 你的github用户名,非昵称
$ git config --global user.email "xxx@163.com"// 填写你的github注册邮箱

设置这个是为了便与之后上传到github的page上。

3、设置deployment

配置_config.yml中有关deploy的部分:

正确写法:

deploy:
type: git
repository: git@github.com:saucxs/saucxs.github.io.git
branch: master

错误写法:

deploy:
type: github
repository: https://github.com/saucxs/saucxs.github.io.git
branch: master

后面一种写法是hexo2.x的写法,现在已经不行了,无论是哪种写法,此时直接执行hexo d的话一般会报如下错误:

Deployer not found: github 或者 Deployer not found: git

github+hexo搭建自己的博客网站(一)基础入门

需要安装一个插件

npm install hexo-deployer-git --save

再次输入hexo d,就ok了。

github+hexo搭建自己的博客网站(一)基础入门

自己的github的page,显示如下

github+hexo搭建自己的博客网站(一)基础入门

同时,你的github上的项目,代码已经更新。

github+hexo搭建自己的博客网站(一)基础入门

四、保留CNAME、README.md等文件

提交之后网页上一看,发现以前其它代码都没了,此时不要慌,一些非md文件可以把他们放到source文件夹下,这里的所有文件都会原样复制(除了md文件)到public目录。

由于hexo默认会把所有md文件都转换成html,包括README.md,所有需要每次生成之后、上传之前,手动将README.md复制到public目录,并删除README.html

五、修改hexo的主题

在 Hexo 中有两份主要的配置文件,其名称都是 _config.yml。 其中,一份位于站点根目录下,主要包含 Hexo 本身的配置;另一份位于主题目录下,这份配置由主题作者提供,主要用于配置主题相关的选项。

为了描述方便,在以下说明中,将前者称为 站点配置文件, 后者称为 主题配置文件

PS:需要特别注意的地方是,冒号后面必须有一个空格,否则可能会出问题。

举个栗子:

1. 安装 NexT

载主题

如果你熟悉 Git, 建议你使用 克隆最新版本 的方式,之后的更新可以通过 git pull 来快速更新, 而不用再次下载压缩包替换。

在终端窗口下,定位到 Hexo 站点目录下。使用 Git checkout 代码:

git clone https://github.com/iissnan/hexo-theme-next themes/next

2. 启用主题

与所有 Hexo 主题启用的模式一样。 当 克隆/下载 完成后,打开 站点配置文件, 找到 theme 字段,并将其值更改为 next。

启用 NexT 主题

theme: next

到此,NexT 主题安装完成。下一步我们将验证主题是否正确启用。在切换主题之后、验证之前, 我们最好使用 hexo clean 来清除 Hexo 的缓存

hexo clean

github+hexo搭建自己的博客网站(一)基础入门

hexo s -g      //生成静态文件,启动本地服务

六、 写博客

定位到我们的hexo根目录,执行命令:

hexo new ‘HelloEveryone’

github+hexo搭建自己的博客网站(一)基础入门

我们只需要打开这个文件就可以开始写博客了,默认生成如下内容

当然你也可以直接自己新建md文件,用这个命令的好处是帮我们自动生成了时间。

默认情况下,生成的博文目录会显示全部的文章内容,如何设置文章摘要的长度呢?

答案是在合适的位置加上<!--more-->即可,例如:

七、访问我的hexo+github博客

可以访问我的git博客来查看效果: https://saucxs.github.io/