这是我搭建的第一个博客网站，使用的是 Github Pages + Hexo 的形式搭建，本文为博客搭建的具体教程，大家也可以按照这个教程搭建出一个属于自己的博客哦

注册Github账号

Github是什么

GitHub是一个面向开源及私有软件项目的托管平台，因为只支持Git作为唯一的版本库格式进行托管，故名GitHub。

注册账号
  • 进入Github官网：https://github.com/
  • 点击右上角的sign in，依次填写信息，之后就能注册成功，如果已经注册就直接登陆

安装node.js

安装node.js
  • 进入node.js官网：https://nodejs.org/en/download
  • 按照自己的系统选择对应的版本下载，我的是windous 64 位
    安装过程只要一直选下一步就行
    遇到问题可以自行百度，这里就不再赘述

安装Git

安装Git

检验软件是否安装成功

Win + R打开运行窗口，输入cmd，然后输入以下命令，有相应版本信息显示则安装成功，若不正确可以卸载软件重新安装 
1
2
3
git --version
node -v
npm -v

若安装成功，在桌面右键鼠标，可以看到菜单里多了Git GUI Here 和 Git Bash Here两个选项，我们一般用第二个

安装Hexo

选择一个磁盘，新建一个文件夹，自己重命名文件夹（如：我的文件夹为：E\ChenFeng_Blog）这个文件夹之后会被用来存放博客的所有文件，在该文件夹下右键鼠标，点击 Git Bash Here，一次输入以下几条命令即可安装Hexo，如果安装失败就重试几次

1
2
3
npm install hexo-cli -g
hexo init
npm install hexo-deployer-git --save

Hexo安装完成后，将会在文件夹中新建所需要的文件

Hexo本地查看

输入以下命令

1
2
hexo g
hexo s

执行完即可登录 http://localhost:4000/ 查看效果

将博客部署到 Github Pages 上

部署前置步骤
  • 创建项目代码库：点击New repository开始创建，步骤见图：

    项目名必须是：你的用户名.github.io这种格式，然后勾选初始化描述文件

  • 配置SSH密钥：在你的博客文件夹里右键，选择Git Bash Here，输入以下命令
    1
    2
    ssh-keygen -t rsa -C "your email@example.com"
    //引号里面填写你的邮箱地址，比如我的是255693535@qq.com
    输入之后会出现
    1
    2
    3
    Generating public/private rsa key pair.
    Enter file in which to save the key (/c/Users/you/.ssh/id_rsa):
    //到这里可以直接回车将密钥按默认文件进行存储
    然后会出现
    1
    2
    3
    Enter passphrase (empty for no passphrase):
    //这里是要你输入密码，其实不需要输什么密码，可以直接回车
    Enter same passphrase again:
    最后会显示
    1
    2
    3
    4
    5
    6
    Your identification has been saved in /c/Users/you/.ssh/id_rsa.
    Your public key has been saved in /c/Users/you/.ssh/id_rsa.pub.
    The key fingerprint is:
    这里是各种字母数字组成的字符串，结尾是你的邮箱
    The key's randomart image is:
    这里也是各种字母数字符号组成的字符串
    接着输入以下命令将公钥的内容复制到粘贴板上
    1
    clip < ~/.ssh/id_rsa.pub
  • 在 GitHub 账户中添加你的公钥
    一、登陆 GitHub，点击右上角头像，进入settings：
    二、点击SSH and GPG Keys
    三、选择New SSH key并粘贴密钥
    四、粘贴完密钥后点击Add SSH key
  • 测试
    直接在桌面右键 点击Git Bash Here，输入以下命令：
    1
    2
    ssh -T git@github.com
    //git@github.com不要做任何更改！
    之后会显示
    输入yes即设置完成
  • 配置Git个人信息
    1
    2
    git config --global user.name "此处填你的用户名"
    git config --global user.email "此处填你的邮箱"
    到此为止 SSH Key 配置成功，你的计算机已成功连接到Github
将博客本地文件更新至Github的仓库中
  • 登录 Github 打开自己的项目 比如我的就是chenfengyyds.github.io
  • 点击Code按钮，切换到SSH，然后点击按钮复制
  • 打开你创建的博客文件夹，右键用VS Code（或者其他编辑器）打开该文件夹下的 _config.yml 文件
  • 仿照下图修改 _config.yml 文件并保存

    repository:后接刚才复制到的内容，branch:后接main/master 麻烦自己注意自己是什么分支的，是哪个分支就填哪个分支 注意空格

  • 在 Hexo 文件夹下分别执行以下命令
    1
    2
    hexo g
    hexo d
    执行完之后会让你输入你的 Github 的账号和密码，如果此时报以下错误，说明你的 deployer 没有安装成功
    1
    ERROR Deployer not found: git
    需要执行以下命令再安装一次：
    1
    npm install hexo-deployer-git --save
    安装完后重新执行
    1
    2
    hexo g
    hexo d
    做完以上操作后，你的博客就会部署到 Github 上了
  • 访问博客 你的博客地址：https://你的用户名.github.io， 比如我的是：https://chenfengyyds.github.io ，现在所有人都可以通过此链接访问你的博客了

在博客上发表文章

  • 新建一个空文章，输入以下命令，会在项目[blog]/source/_post中生成 文章标题.md 文件，文章标题根据需要命名
    1
    hexo n "文章标题"
    也可以直接在[blog]/source/_post文件夹下右键鼠标新建文本文档，改后缀为 .md 即可，这种方法比较方便
  • 编写文章
    Markdown语言

    md 全称 Markdown， Markdown 是 2004 年由 John Gruberis 设计和开发的纯文本格式的语法，非常的简单实用，常用的标记符号屈指可数，几分钟即可学会

    .md 文件可以使用支持 Markdown 语法的编辑器编辑，然后将写好的文章（.md 文件）保存到[blog]/source/_post文件夹下，当我们用编辑器写好文章后，可以使用以下命令将其推送到服务器上
    1
    2
    hexo g
    hexo d
    现在访问你的博客就可以你发表的文章了