Hexo搭建个人博客网站记录

花了2天搭建了个网站,先上链接,欢迎来访:九天之遥 现在市面上的博客很多,如CSDN,博客园,简书等平台,可以直接在上面发表,用户交互做的好,写的文章百度也能搜索的到。缺点是比较不自由,会受到平台的各种限制和恶心的广告。

而自己购买域名和服务器,搭建博客的成本实在是太高了,不光是说这些购买成本,单单是花力气去自己搭这么一个网站,还要定期的维护它,对于我们大多数人来说,实在是没有这样的精力和时间。

那么就有第三种选择,直接在github page平台上托管我们的博客。这样就可以安心的来写作,又不需要定期维护,而且hexo作为一个快速简洁的博客框架,用它来搭建博客真的非常容易。

一、基本环境安装

Hexo是一款基于Node.js的静态博客框架,依赖少易于安装使用,可以方便的生成静态网页托管在GitHub和Coding上,是搭建博客的首选框架。大家可以进入hexo官网进行详细查看,因为Hexo的创建者是台湾人,对中文的支持很友好,可以选择中文进行查看。

教程分三个部分,

第一部分:hexo的初级搭建还有部署到github page上,以及个人域名的绑定。
第二部分:hexo的基本配置,更换主题,实现多终端工作,以及在coding page部署实现国内外分流
第三部分:hexo添加各种功能,包括搜索的SEO,阅读量统计,访问量统计和评论系统等。

hexo的初级搭建还有部署到github page上,以及个人域名的绑定。

Hexo 搭建与部署到github page

  • 安装windows的Git

  • 安装Node.js

  • 安装Hexo

  • GitHub创建个人仓库

  • 生成SSH添加到GitHub

  • 将hexo部署到GitHub

  • 设置个人域名

  • 发布文章

    1.1 安装git

    windows:到git官网上下载,Download git,下载后会有一个Git Bash的命令行工具,以后就用这个工具来使用git。

    linux:对linux来说实在是太简单了,因为最早的git就是在linux上编写的,只需要一行代码

    1
    sudo apt-get install git

    安装好后,用git --version 来查看一下版本

    1.2 安装Node.js

    Hexo是基于nodeJS编写的,所以需要安装一下nodeJs和里面的npm工具。

    windowsnodejs选择LTS版本就行了。在git安装完后,就可以直接使用git bash来敲命令行了

    linux: 执行命令

    1
    2
    sudo apt-get install nodejs
    sudo apt-get install npm

    安装之后执行,检查一下有没有安装成功

    1
    2
    node -v
    npm -v

    1.3 安装Hexo

    前面git和nodejs安装好后,就可以安装hexo了,你可以在本地合适的位置创建一个文件夹blog,然后cd到这个文件夹下(或者在这个文件夹下直接右键git bash打开)。

    输入命令

    1
    npm install -g hexo-cli

    输入命令,查看版本

    1
    hexo -v

    至此安装完毕。初始化hexo

    1
    hexo init myblog

    进入创建的目录,安装npm

    1
    2
    cd myblog //进入这个myblog文件夹
    npm install

    安装完成后,指定目录下会存在一下文件:

    • node_modules: 依赖包

    • public:存放生成的页面

    • scaffolds:生成文章的一些模板

    • source:用来存放你的文章

    • themes:主题

    • ** _config.yml: 博客的配置文件**

    输入命令,看看hexo的效果

    1
    2
    hexo g
    hexo server

    打开hexo的服务,在浏览器输入http://localhost:4000就可以看到你生成的博客了。

    按住ctrl+c 可以关闭服务

    1.4 GitHub创建个人仓库

    首先,你先要有一个GitHub账户,去注册一个吧。

    注册完登录后,在GitHub.com中看到一个New repository,新建仓库

    创建一个和你用户名相同的仓库,后面加.github.io,只有这样,将来要部署到GitHub page的时候,才会被识别,也就是xxxx.github.io,其中xxx就是你注册GitHub的用户名。我这里是已经建过了。

    点击create repository。

    1.5 生成SSH添加到GitHub

    回到你的git bash中,执行命令

    1
    2
    git config --global user.name "yourname"
    git config --global user.email "youremail"

    这里的yourname输入你的GitHub用户名,youremail输入你GitHub的邮箱。这样GitHub才能知道你是不是对应它的账户。

    可以用以下两条,检查一下你有没有输对

    1
    ssh-keygen -t rsa -C "youremail"

    这个时候它会告诉你已经生成了.ssh的文件夹。在你的电脑中找到这个文件夹。

    ssh,简单来讲,就是一个秘钥,其中,id_rsa是你这台电脑的私人秘钥,不能给别人看的,id_rsa.pub是公共秘钥,可以随便给别人看。把这个公钥放在GitHub上,这样当你链接GitHub自己的账户时,它就会根据公钥匹配你的私钥,当能够相互匹配时,才能够顺利的通过git上传你的文件到GitHub上。

    而后在GitHub的setting中,找到SSH keys的设置选项,点击New SSH key
    把你的id_rsa.pub里面的信息复制进去。

    在gitbash中,查看是否成功,执行命令

    1
    ssh -T git@github.com

    1.6 将hexo部署到GitHub

    这一步,我们就可以将hexo和GitHub关联起来,也就是将hexo生成的文章部署到GitHub上,打开站点配置文件 _config.yml,翻到最后,修改为
    YourgithubName就是你的GitHub账户

    1
    2
    3
    4
    deploy:
    type: git
    repo: https://github.com/YourgithubName/YourgithubName.github.io.git
    branch: master

    这个时候需要先安装deploy-git ,也就是部署的命令,这样你才能用命令部署到GitHub。

    1
    2
    3
    hexo clean
    hexo generate
    hexo deploy

    hexo clean清除了你之前生成的东西,也可以不加。
    hexo generate 顾名思义,生成静态文章,可以用 hexo g缩写
    hexo deploy 部署文章,可以用hexo d缩写

    注意deploy时可能要你输入username和password。得到下图就说明部署成功了,过一会儿就可以在http://yourname.github.io 这个网站看到你的博客了!!

二、Hexo博客配置

hexo的基本配置,更换主题,实现多终端工作,以及在coding page部署实现国内外分流。

2.1 hexo 基本配置

参数 描述
title 网站标题
subtitle 网站副标题
description 网站描述
author 您的名字
language 网站使用的语言
timezone 网站时区。Hexo 默认使用您电脑的时区。时区列表。比如说:America/New_York, Japan, 和 UTC
参数 描述
url 网址
root 网站根目录
permalink 文章的 永久链接 格式
permalink_defaults 永久链接中各部分的默认值

在这里,你需要把url改成你的网站域名。

permalink,也就是你生成某个文章时的那个链接格式。

比如我新建一个文章叫temp.md,那么这个时候他自动生成的地址就是http://yoursite.com/2024/07/26/temp。

以下是官方给出的示例,关于链接的变量还有很多,需要的可以去官网上查找 永久链接

1
2
3
4
5
6
7
8
theme: landscape

# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
type: git
repo: <repository url>
branch: [branch]

theme就是选择什么主题,也就是在theme这个文件夹下,在官网上有很多个主题,默认给你安装的是lanscape这个主题。当你需要更换主题时,在官网上下载,把主题的文件放在theme文件夹下,再修改这个参数就可以了。接下来这个deploy就是网站的部署的,repo就是仓库(Repository)的简写。branch选择仓库的哪个分支。这个在之前进行github page部署的时候已经修改过了,不再赘述。而这个在后面进行双平台部署的时候会再次用到。

Front-matter 是文件最上方以 --- 分隔的区域,用于指定个别文件的变量,举例来说:

2.2 更换主题

2.3 git分支进行多终端工作

2.4 coding page上部署实现国内外分流

三、云服务器配置

四、Hexo常用命令

五、问题记录