GithubPages + Hexo + Disqus博客教程

时间:2023-03-09 19:08:08
GithubPages + Hexo + Disqus博客教程

文章主要描述了利用github page,hexo静态博客框架以及disqus来搭建个人静态博客的详细步骤。

github page用来搭建博客的主页,hexo用来更改博客主题、发布文章等等,并通过配置文件和Disqus来添加评论功能。

具体步骤如下

环境要求

  • 安装Node,官网下载安装,用来生成静态页面

  • 安装Hexo,sudo npm install hexo -g,一个基于node的开源静态博客框架

  • 安装Git,Mac系统可以直接下载安装下载链接

  • github账号,没有可以自行注册,配置sshkey,可以搜索相关教程

  • Disqus账号,同上,注册很简单,但需要FQ,可以下载免费版蓝灯,github项目地址 *下载地址

下面开始进行详细的介绍

Github page

登录自己的github账号,在首页右上角点击new repository

GithubPages + Hexo + Disqus博客教程

rname.github.io,例如我自己的就是 errylee.github.io,然后在该repository的settings中将Github Pages的Source 设置为 master branch

GithubPages + Hexo + Disqus博客教程

o,接下来在本地创建好自己的博客文件夹例如User/erry/Myblog,然后调出Mac下的终端工具,cd到该目录下,执行hexo init,然后修改 根目录下的_config.yml文件中deploy属性为:

GithubPages + Hexo + Disqus博客教程

ub page的repository的https地址,最后执行:npm i hexo-deployer-git --save

接下来就可以通过hexo的内置命令来写博客了:

  • hexo new "我的第一篇博客",创建一篇文章

  • hexo clean 清除静态页面缓存

  • hexo generate 简写为 hexo g 生成静态页面

  • hexo deploy 简写为 hexo d 部署到github page,可以和上一步合在一起为 hexo g -d

  • hexo server 在本地进行博客预览

hexo框架的默认主题是landscape,你可以通过在 主题列表 里下载好自己喜欢的主题,将该主题文件放到根目录下的themes文件夹下,例如 hexo-theme-yilia,可以将文件夹名改为yilia,然后在根目录下的_config.yml中将theme改为theme: yilia.

第一次进行deploy时需要的时间比较长,大约10分钟左右,以后每次执行完hexo cleanhexo g -d命令,可以立即刷新页面查看

根目录下的_config.yml和配置的theme目录下的_config.yml中有很多和页面相关的样式和功能配置,可以查看相关主题github主页的相关教程进行配置,当然你也可以自己修改下载好的theme下的样式和页面模板,对自己的页面进行调整。

Disqus评论模块的添加

以我自己博客所选主题yilia为例,在 themes/yilia/路径下的_config.yml文件中,disqus设置为真disqus: true,并添加disqus相关项 disqus_shortname: ErryLee,ErryLee为你在Disqus上配置的site的shorname(接下来会配置shortname),Disqus的配置步骤如下:

Disqus网址,注册完账号登录后点击右上角Home跳转到主页,然后点击齿轮按钮选择Add Dusqus To Site,跳转后拉到页面最下方,点GET STARTED,再次跳转后选择I want to install Disqus on my site,然后在新页面中填写你的website name、type和language,如下图:

GithubPages + Hexo + Disqus博客教程

创建成功后,在新页面点击Install Disqus,Platform选择为Universal Code,拉到页面最下面点击按钮即可。

然后点击Configure Disqus,将Website Name改为你想要的名称,我的为ErryLee,URL设置为你的Github page地址,然后完成。

GithubPages + Hexo + Disqus博客教程

基本上所有步骤都进行完了,你可以依次执行clean,generate和deploy来部署。

其他配置

在主题目录下的_config.yml文件中可以添加头像以及博客的icon分别对应avatar和favicon属性,你可以在根目录的source文件夹下添加images文件夹来添加一些自己制作的图片。

另外在主题目录下的source文件夹中可以添加自己的404页面:404.html。配置文件中只能修改一小部分样式,你可以到相关的css文件中自己进行随意的修改,如果是webpack项目,记得执行打包命令。

关于hexo博客的一些SEO优化问题可以参考这篇文章 [Hexo Seo优化]

百度站长链接提交失败,是由于github屏蔽了百度spider的爬取,解决方案可以参考coding.net部署

上面有的步骤我开始没太明白,稍微倒腾了一会,等有时间我会写个通俗易懂版的,完全不会的也能玩的那种。

其他内容我自己还没有涉及到,后期遇到也会进行补充的,多谢大家