个人博客搭建指南

一、安装git

这里只需要在git的官网https://git-scm.com ，即可直接在窗口右下角点击下载，安装也只需要无脑下一步（大家应该都已经安装过git了吧）

二、安装node.js

直接搜索node.js进入官网


下载左边的稳定版（Recommend For Most Users），安装时也是无脑下一步（不想下在C盘也可以换一个存储位置）

安装完成后可以在命令行中输入node -v，如果正确显示了版本号，那就说明安装成功。

三、安装Hexo

这是一个快速简洁且高效的博客框架

安装hexo之前，我们先在本地的一个位置新建一个安装博客的文件夹。在这个文件夹下面右键选择Git Bash Here。

接着进入Hexo官网，逐行在git中输入官网下面的五行命令。

第一行命令运行结果：

第二行命令运行结果：

此时文件夹中应该会出现blog文件夹

第三行命令运行会改变当前工作路径至blog文件夹下(没有输出)

第四行命令运行结果：

第五行命令可以将server简写成s，即hexo s

这个时候你的博客应该就可以在命令行中的地址中运行了，可以复制这个地址然后在浏览器中打开

这个时候这个博客只能在本地访问，还无法被其他人访问

四、编辑个人博客

首先学习如何创建文章

第一步，先进入刚刚创建的博客文件夹中（即blog文件夹中），然后右键选择Git Bash Here，在命令行中输入hexo new “文章标题”，就可以创建一篇文章

可以在/source/_posts文件夹中找到这篇文章

这篇文章是以md格式存储的，可以通过编辑md文件来编辑这篇文章。

然后你就可以在刚刚的git窗口中输入hexo g命令生成网页，再使用之前的hexo s命令运行网站。可以看到刚刚生成并编辑过的那一个网页

四、更改博客样式

进入hexo官网底部，点击“探索主题”

在这里我们可以看到很多种不同的主题风格



如果想要预览页面，可以点击图片来查看大图，也可以点击view preview site来进入预设的页面查看。

这里以Reimu主题为例(不同的主题可能会有不同的配置方法，需要查看各自主题的相关信息，不想看此部分内容可以跳过)



点击上方的Reimu就可以进入到GitHub的配置界面



找到它下面的安装提示界面



我们选择直接克隆仓库到/themes文件夹下并重命名，在themes文件夹下git bash并使用git clone指令



然后对这个文件夹重命名



修改 _config.yml 中的theme



将这里面的#Extensions部分覆盖掉就行



这样之后，理论上就可以套用这个模板了，可以使用hexo s运行网站看看（虽然很多配置都还没有配）


然后之后的使用部分就可以参考theme说明中给出的步骤一步一步来做



例如你可以按照它的基本结构来布置你的网页，比如在source文件夹中放入example中的_data，about和friend文件夹（注意：是放在原本的blog文件夹下的source文件夹，而不是reimu中的source文件夹）

一番辛苦的布置 （复制） 之后，网页整体的外观应该长成这样：

可以在网页中右键-检查，选择左上角的切换设备仿真，就可以看到手机浏览器中的显示界面。

五、修改主题配置

通常每个主题都有修改主题配置的说明，我们可以根据说明进行修改。

通常来说，修改主题主要需要修改主题文件夹下的_config.yml文件和blog主文件夹下的_config.yml文件。在我们修改之前，建议先备份一份以防万一。
还是以我们的reimu的theme为例，首先我们先来到reimu（主题）文件夹下



打开这个文件，里面应该会显示许多配置相关信息，很多都已经使用注释解释过了（看不懂也没关系，在主题配置说明中应该已经详细介绍过了）



我们可以根据主题配置说明来一一修改里面的内容和样式，这里不做演示。

之后我们来到博客的blog根目录，也备份一份这个config文件。打开这个文件，这里面主要要修改的就是Site中的内容

• title：标题文字
• subtitle：副标题
• description：网站描述
• author：作者昵称
• language：博客主语言，如果使用中文可以改为zh

在修改完成后，可以使用hexo g重新加载，并使用hexo s运行网站，看看实际效果。

注意：每次对网站进行修改完之后必须使用hexo g来保存修改并重新加载。
稍加修改后网页内容如下：

六、创建GitHub仓库

进入GitHub官网（可能需要加速器）



如果之前已经有账号了，就可以不用注册这一步，否则就需要先注册。点击sign up进行注册，按照其中的要求完成注册信息。



创建完成之后，我们需要设置一下ssh key（如果之前已经设置过就不需要了）。这个key可以理解为一个用来识别身份密码，你可以使用指令生成一个公钥和私钥，只有当你把你这台设备的公钥上传到GitHub上，GitHub才能和你的本地仓库建立联系。

如果你的git还没有全局设置的话，可以先进行一下全局设置

输入以下两行代码：

git config --global user.name “你的用户名”

git config --glbal user.email “你的邮箱”

只需要将你的用户名和你的邮箱改成你自己的就行了。

接下来，在任意目录下打开git，输入命令cd ~/.ssh，将工作路径切换到隐藏目录.ssh中。

然后输入命令ssh-keygen -t rsa -C “your email”来生成密钥。注意要把your email替换成你自己的邮箱。

这个时候，可以使用ls命令查看当前文件夹下的内容，应该差不多如下：

如果出现了id_rsa和id_rsa.pub，说明你就配置成功了。

然后你可以输入cat id_rsa.pub命令来查看id_rsa.pub文件中的信息，并将其复制。

接下来你需要登录GitHub，点击右上角你的头像，选择settings，来到settings页面


点击左下角的SSH and GPG keys，然后点击右上角的New SSH key进入添加密钥界面。

你可以在title中添加一个密钥的名字，然后在key中粘贴你刚刚复制的密钥，这样就可以在GitHub上添加这个公钥了。你应该可以在上一级页面看到你的ssh公钥

然后在git中输入命令ssh -T git@github.com，效果如下：

如果返回的是successfully说明配置成功了，你已经通过GitHub上的公钥和你的密钥建立了联系。

然后点击GitHub页面的右上角图像，点击your profile进入到你的个人主页。

点击右上角的加号，在里面点击New repository来新建一个仓库

在repository name中输入仓库名称。这里仓库名称必须是你的用户名+“.github.io”，不然会出问题。description中输入你想要的描述（可以不写），然后点击Create Repository新建仓库

七、上传本地博客至GitHub仓库

来到个人博客blog根目录，打开里面的_config.yml文件，滑到最底部，修改里面的deploy项。

在type中输入’git’，然后回车，新增加一个repository项，输入英文冒号和一个空格（注意：这个空格必须加，不然会报错）

然后来到你的GitHub新建的仓库页面，点击绿色code，在clone中切换到SSH，点击右边的两个长方形图标复制里面的内容

然后粘贴到刚刚repository冒号和空格后边，保存。这样子它就知道需要在GitHub的哪个仓库中存放你的博客了。如果你想要换一个仓库，只需要将这里的地址修改掉，然后重新执行以下步骤即可。

然后你需要再次按下回车，添加新的branch属性，同样需要添加冒号和空格，然后后面输入main（表示GitHub上的主分支）

之后在blog根目录中git bash，运行以下代码：

npm install hexo-deployer-git --save

将会出现以下输出

接下来就可以使用hexo g生成网页内容并使用hexo s预览博客，当然也可以直接输入hexo d部署博客

这个时候我们可以回到刚刚创建的仓库，在main分支上就可以看到刚刚上传的代码。（如果你的代码上传到了其他分支上说明你错了，这样会出bug）

接下来你就可以点击页面右上方的settings，左边点击pages，就可以看到你部署的仓库的网页网址了。

进入这个网址，就可以来到你的个人主页。其他人也可以访问你的主页。

八、更新博客/错误处理

当我们在本地修改完博客之后，我们可以使用原来相同的hexo g和hexo d命令部署网页，GitHub端应该就会自动进行更新并重新部署。

如果GitHub没有自动更新，我们可以输入hexo clean清除缓存文件，然后重新使用hexo g和hexo d命令部署网页。

通常来说，如果想要为某篇文章添加分类和标签，你可以直接打开你选择的那篇文章，然后在开头的那几个键值对中中添加tags项和category项。通常，一个主题会自动对你给这篇文章添加的分类和标签进行相关的处理。

有的时候，如果你上传了一个过大的文件（不能超过100MB），那么git会提示你上传失败。但是这个时候就算你把文件删除了，git提交的时候仍然会上传那个文件。这个时候就需要使用git的回退的办法。

首先找到你的博客的.deploy_git文件夹，然后进入，使用git bash

然后继续使用git log命令打印出所有的上传记录

每个记录上方的黄色字的commit后面的那一串字符就是你这次git的提交的ID，Date就是上传的时间。你需要根据每次上传的时间来确定你还没有上传大文件的那次commit，然后使用回滚。找到那次提交之后只要按一下q，就可以返回命令输入模式。然后只需要输入命令：
git reset --soft [没上传大文件的那次提交的ID]即可退回到上次记录。然后这个时候返回blog根目录，使用hexo clean清除缓存，再次使用hexo g和hexo d命令部署，就会发现没有再次提交视频。

自此你的个人博客就已经可以成功运行了。博客还是需要多更新，否则费那么大力气就没有意义了哦。