搭建Blog指北
本文最后更新于：2022年4月8日 中午
进行一个建的搭
>其他参考文件
注：瑾知的文档成文仓促，存在些许错误，对于已经发现的，将在下文勘误
>本篇主旨：
该文章旨在提供一份帮助文档，不是完美的教程，内容直接转述于上面提到的文档，并重新对内容进行组织，以期降低阅读难度和更正错误。因此不再每一步骤提供完整的图片，如有需要请查阅上述文档。
>前期准备
>拥有GitHub账号
前往 Github 官网注册自己的账号
Github因众所周知的原因，访问速度可能存在极大波动，请自行使用插件、加速方法、host等解决
>安装Git Node.js
去下载 Git
直接点击 Download 选择适合你的操作系统即可
安装时全选默认即可
>安装Node.js
去下载 Node.js
选择 LTS(Long Time Support) 版本
>安装Sublime Text【可选步骤】
一个强大的文本代码编辑器，可以当做文本使用，也可以当做代码工具使用，当你认为不需要大动干戈使用VScode或者别的什么IDE对代码进行轻量化修改的时候可以用上它。推荐先使用官方试用版
两个安装渠道：
学习版安装 YPOJIE
>开始搭建
>建立密钥链接
在你想要保存本地Blog的地方，新建一个文件，打开
在该文件空白处右键，点击 Git Bash Here 打开Git的控制面板
输入下面的代码，其中，yourname 更改为你的 GitHub 名字，email部分更改为你的 GitHub注册邮箱，回车确认
git config –global user.name “yourname”
git config –global user.email “email@email.com“
而后输入下面的代码来创建ssh，要求同上，回车确认
ssh-keygen -t rsa -C “email@youremail.com“
它会返回一个路径，在该路径下你应该能找到两个文件
id_rsa 私钥
id_rsa.pub 公钥
复制公钥中的内容，打开GitHub，点击你的头像，在 setting 中左侧侧边栏找到 SSH and GPG Keys
在Key中填入公钥，title随便填即可，而后点击 add key
在之前的 git bash 中输入以下代码进行检验
ssh -T git@github.com
提示 successfully 即为成功
! 勘误
完成上一步后，立即找得到下方的 Repositories 在右侧的repository default branch 处修改默认仓库位置为 master ，Git Bash在执行Git init指令后默认使用master仓库，但是GitHub改版后默认为main 如果不修改Git Bash或GitHub里的仓库将导致严重的问题从而浪费时间。
>新建仓库
在Github主页，新建一个仓库
在 Repository name 一栏填写你的GitHub的用户名，也就是 Owner 显示的名字
在下方 Initialize this repository with 处勾选 Add a README file
然后点击下方的 ICreate repository 即可进入新建仓库
>建立Github pages
Github pages 要求必须存在分支且必须包含文件，按照教程做的话应当存在 master 分支 和 readme 文件
在仓库中点击 setting
在左侧边栏找到 Pages 将Github pages中 Source下方的None修改为master，并Save即可
设置完毕后应当于如下界面相似，Github pages会给你提供一个网址，请保留备用
>创建博客本地文件
博客需要有本地文件，请选择合适的地方新建一个
右键新建文件夹内的空白处，打开 Git Bash
输入指令
git init
输入完后你应当在有颜色的一串字符上看到多了一个 master
链接远程仓库，输入如下代码，git@ github.com不用修改,your name为你的用户名，repository name为你的仓库名字，应当也为你的用户名 ，不要忘了尾部的 .git 【这一步是必要的！否则网页将推送失败】
git remote add origin git@github.com:yourName/repositor yname.git
如果没有报错，就可以进行下一步
>安装Hexo
<省略了仓库同步检验步骤，我们认为是没有必要的，需要的请在 瑾知 的Blog查看>
依然在博客本地文件处唤出 Git Bash ，以及删除文件夹里的 .git 文件，如果没有，请打开系统的“显示隐藏文件”设置
在Git Bash中输入以下代码开始安装，要一步一步来
npm install -g hexo-cli #安装Hexo
hexo init #初始化博客
hexo g #部署博客
安装过程中不会出现大段大段的以 error 开头的代码
而后输入以下代码，并在浏览器网址处填写第二条代码检查安装情况
hexo s
localhost:4000/
hexo s -p 5000
如果出现可以访问且尚且能看的网页，则安装成功
提示端口占用请在Git Bash输入第三行代码重新访问，但 4000 改为 5000
>部署Hexo
回到博客本地文件夹，使用Sublime Text打开 _config.yml文件，或者使用记事本、VScode打开
拉到文件最底部，粘贴进如下代码注意：原文件有一小段已经生成好的重复代码，务必删除，应该是
deploy: type:这段是已经有的，删除掉
yourname 填写你的用户名 repositoryname 应该跟你的用户名保持一致（如果你按照教程走的话）
deploy:
type: git
repository: https://github.com:yourName/repositoryname.git #此处填写你的仓库地址
branch: master
并在该文件上方找到 url: example 应该在 16 行，如果你用SubText查看的话 ，它会填一个 example 网址，请将它替换为你保存的 Github pages的网址
>同步Hexo
输入以下指令，安装Hexo部署插件，并部署Hexo，第一条指令在新文件夹都必须运行
npm install hexo-deployer-git –save
hexo clean #清除缓存文件 db.json 和已生成的静态文件 public
hexo g #生成网站静态文件到默认设置的 public 文件夹(hexo generate的缩写)
hexo d #生成网站静态文件，并部署到设定的仓库(hexo deploy的缩写)
指令执行完成后在你的Github仓库里刷新，看看更新时间，更新时间应该在几分钟之内
而后请访问你的Github Pages地址，出现的内容应当和 Localhost:4000 的地址保持一致
！如果发现执行Hexo d中弹出各种 css 错误，请再检查你的 url 地址填写是否正确，网络是否顺畅
>安装Hexo主题
在Github中全站搜索 Hexo theme可以发现各种适配的主题，具体的安装步骤在此不做赘述，每个主题的github页面都有安装介绍。在此介绍几个不错的主题。推荐使用Butterfly，功能非常多。
其中 Material 是本站正在使用的主题截止发文时，瑾知网站使用的是 Butterfly主题（原为fluid）
新安装的主题需要自行创建关于页 404页等，按照主题所在的Github项目要求中进行
本篇也不做赘述，请自行查阅
生成完所需的页面后，执行以下代码，将页面推至Github上
hexo clean
hexo g
hexo s #在本地查看主题是否被安装安装 【可省略，如果你认为没有问题的话】
hexo d #确认无误后推送到GitHub
>最后的检查
推完页面后查看项目的修改时间，也应该在几分钟内，由于GitHub的一些限制，如果发现一段时间仍然没有更新项目，请多等候一会儿，不要多次推送页面。Github的响应和更新需要一些时间
当发现项目已经更新后，进入已经保留好的Github pages页面，页面内容应当与你所在本地查看到的主题内容一直，而不再是没有安装主题时简陋的样子
>关于自定义域名：
如果你想让你的网站访问的网址变得更容易被记住，可以购买一个更简单的域名，可以购买腾讯或者阿里的域名，或者在你认为合适的地方购买，一般为 60元/年 ，但是每个域名都不一样，可能多也可能少。
具体的Github域名绑定方法请自行查阅教程，在此不做^赘述
简述遇到的问题：
■必须先配置好DNS再将域名绑定至Github，否则会导致严重的解析失败问题，DNS的配置方法此处不进行说明
■在Github项目的setting界面中可以在github pages的 Custom domain中手动设置
■设置完域名并等待Github check DNS后，在下方打开https访问，注意，DNS扩散需要时间，刚刚绑定的域名可能在一定时间内存在访问问题
■每次推送完网页后设置里的 domain 会被刷掉，需要在本地blog的source文件内添加一个文本，名为CANME，其中写入你的域名，保存后删除后缀 .txt，再进行推送，就能自动设置domain