一、前置知识

本文档参考博客文章：http://t.csdnimg.cn/XiZky
幕布文档的基本操作：（推荐用浏览器打开本文档链接，而不是用微信，手机端显示也会有问题），访问链接：https://www.mubu.com/doc/5OeZGO2XKgh
- 每个小圆点都是一个主题，如果这个主题有子主题（会有半透明外圆环），那鼠标放在这个主题的左边就能看到小三角形，点击小三角形就可以展开。收缩这部分的主题
- 如果点击小圆点就会进入这个主题，只展示这个主题的部分，可以在右上角点击它的父级主题返回到之前的主题
- 文档里的网址链接单击即可打开，可能有些是国外网站，访问比较慢，如果下载node.js或者Git遇到问题，可以到我的Gitee下载安装Installer: 国外的软件可能会下载较慢，为了方便下载，放了一些软件的安装包 (gitee.com)（就是要注册一个Gitte）
  - 这里以Git为例，先点进去对应安装包，再点击右方的原始数据即可
命令行的操作：后面的命令都是在命令行(cmd)或者类似命令行(Git Bash)的界面运行
- 打开命令行：win+R打开运行，输入cmd打开
- cls : 清空屏幕
- cd 目录: 更改当前所在目录
- cd 当前目录的子文件夹：进入到子文件夹（）
- rd.. : 返回上一级目录
- exit : 退出命令行
- rd\ : 返回根目录
- D: : 盘名加冒号切盘(无需回到根目录)
- dir : 显示该目录下的文件
- 上下方向键回溯历史命令
Markdown文件（后缀是md的文件）的编写：推荐使用Typora，不需要记忆语法格式了，ctrl+/也可以查看源代码，其它软件编辑也可以

注意点：四个空格会生成代码块，n个井号#代表n级标题，-中划线代表无序标题，后面要有空格

浏览器展示的页面文件–html文件：我们md文档将会生成html文件用于在浏览器展示。
- 这部分由于只给浏览页面的用户看，我们也称之为前端，这个个人博客的搭建只涉及一点前端的知识

二、下载生成个人博客所需要的软件/环境

1.Git：（第三部分会用到）

简介：分布式版本控制系统，用于上传代码/文件（这里会用到）和记录代码/文件的历史版本，合并文件改动，团队项目必备工具（详见Git教程 - 廖雪峰的官方网站）。
- 官网安装：Git - Downloads (git-scm.com)，找到download下载（应该在左上角），若要选择版本，选择上面的64位版本（与电脑系统对应的版本）
- 1（64位windows版安装图示）
- 2
  - 官网下载慢的话可以用我的下载链接：https://gitee.com/starlike_daydream/installer/raw/master/Git-2.43.0-64-bit.exe
  - 如果下载的文件没有后缀名，在文件名后面加上.exe扩展名就可以安装了
  - 检测是否安装成功：git –version，出现对应版本号即代表安装成功
  - 后面的命令可以在Git Bash执行（在任意文件目录右击空白处选择Open Git Bash Here，没有的话就选择更多选项（win11）），也可以win+R打开运行输入cmd，在命令行运行。
- 如果遇到执行不成功的情况，可以尝试用管理员身份运行Git Bash/cmd

2.node.js：Node.js 中文网 (nodejs.cn)安装，进去后点击下载安装，选择长期支持版即可

官网下载慢的话可以用我的下载链接：https://gitee.com/starlike_daydream/installer/raw/master/node-v18.18.0-x64.msi
官网安装图示（windows64位版）
- 1.
- 2.
  - 简介：Node.js 是基于 V8 JavaScript 引擎构建的 JavaScript 运行时，可以用它搭建本地服务器，这里我们需要用到它的npm命令
  - 检测是否安装成功：命令行运行node -v和npm -v（注意中间要有空格），出现对应版本号即代表安装成功
  - 添加国内镜像加快下载速度：运行命令npm config set registry https://registry.npm.taobao.org（如果还是下载缓慢或者失败可以切换其他镜像源）
- 查看自己当前的镜像：运行命令：npm get registry
- 切换加速镜像源（推荐）：运行命令：npm config set registry https://registry.npmmirror.com
- 切回官方镜像：运行命令：npm config set registry http://www.npmjs.org
- 其他国内镜像源：国内npm源镜像（npm加速下载）指定npm镜像_npm 国内镜像-CSDN博客
- 如果说切换镜像还是不行，可以尝试取消代理，或者降低npm的版本，在尝试上面的步骤
  - npm config set proxy null // proxy:外部请求的代理
  - npm config set https-proxy null // https-proxy:用于代理https请求的
  - npm install npm@6.4.1 -g 用于降低npm版本
  - 安装好node.js之后就可以用npm命令下载安装hexo了

3.Hexo的安装与配置：

简介：一个基于node.js的帮我们写好的博客框架，用了它，我们只需要修改部分内容，就能获得只属于自己的个人博客，并编写文章上传了
- (1)创建一个文件夹MyBlog，以后在这个文件夹操作，存放项目文件以及博客文章
- (2)运行命令：npm install -g hexo-cli：安装hexo
- (3)运行命令：hexo v：查看是否安装成功，出现对应版本号即代表安装成功
- (4)运行命令：hexo init：在当前目录（博客文件夹目录，而且必须为空目录）初始化一个使用hexo框架的项目（默认）
- (5)运行命令：hexo generate：生成项目
- (6)运行命令：hexo s/hexo server：启动本地服务器，按Ctrl键点击链接即可用默认浏览器访问，用按Ctrl+C停止运行
- 但只有本机能访问，想要在互联网上也能访问就需要下面的步骤

三、使用GitHub提供的免费服务器

GitHub简介：一个项目开放源代码的国外的代码托管平台，我们将用这里的GitHub仓库的Pages功能使用GitHub为我们提供的个人服务器

1.注册github账号（https://github.com/），并创建一个仓库（默认选项创建就行）–>仓库名格式要求：你的GitHub用户名.github.io

我的用户名是Cesteo，创建的仓库名就叫Cesteo.github.io
- 如果注册过程遇到问题，可以参考这篇博客的教程：http://t.csdnimg.cn/IKe0L

2.初始化Git的用户名和邮箱（加–global是为所有git项目设置，不加则是在当前目录的git项目设置）

注意：这里的yourname输入你的GitHub用户名，youremail输入你GitHub的邮箱。这样GitHub才能知道你是不是对应它的账户。
(1)初始化用户名–运行命令：git config –global user.name “yourname”（注意user.name/email和英文双引号”之间要有一个空格）
- (2)初始化邮箱–运行命令：git config –global user.email “youremail”
- (3)确认设置用户名和邮箱成功：执行以下命令
- 用户名：git config –global user.name
- 邮箱：git config –global user.email

3.ssh连接：只有连接成才能上传代码

(1)下载github部署插件：运行命令：npm install hexo-deployer-git –save
- 本地生成获取ssh密钥
- (2)生成密钥：运行命令：ssh-keygen -t rsa -C “youremail”（这里改为自己的邮箱），可能要一路回车
- (3)获取密钥：在Git Bash运行命令cat ~/.ssh/id_rsa.pub，然后复制这行命令运行的结果
  - github创建ssh密钥
- (4)打开github，在右上角的头像下面点击settings，再点击SSH and GPG keys，新建一个SSH，名字随便取一个都可以，把你的id_rsa.pub里面的信息复制进去，点击create/创建即可完成创建
  - (5)验证ssh连接是否成功：ssh -T git@github.com，出现用户名，即代表访问成功
ssh连接我遇到的问题
- ssh连接除了好几次错误：先是22端口拒绝连接，然后我去搜，最后发现电脑只有ssh客户端，没有ssh服务器，然后下了似乎又说真实性，yes/no什么的，这里又搜了一下，是要输yes，我的443端口没问题，不是防火墙的原因，好像少了一个kown_hosts文件
- 类似下图的错误，反正yes着yes着的、差不多就好了

4.更改配置文件

生产的博客项目根目录下的_config.yml中的url，url是Pages生成的网站网址，可以第六步再配置，deploy下的repository 要配置成自己的仓库地址（记得文件要保存，如果编辑器窗口顶部的文件名前面有个星号*，那就说明话没有保存）
我的配置：
- deploy的repository填deploy
- 特别注意这里还有个坑：修改代码时候注意空格，例如 repo：后面都是有空格的，删除空格之后，后面运行的时候就会报错，这是编码的规定，还有就是deploy一定从行首开始写，不要加空格，注意格式

5.使用hexo的常用命令来生成网页：

(1)清除之前生成的项目–hexo clean（可以清除之前项目的一些问题）
- (2)在本地生成项目–hexo g（缩写）/hexo generate
- (3)把项目部署到GitHub上–hexo d（缩写）/hexo deploy
- 这里会让你登录GitHub
- 如果在GitHub创建了token，就需要在生成token时勾选repo下面这些权限
- 如果访问Github慢，部署失败的问题，可以在hosts文件（位于C:\Windows\System32\drivers\etc）添加我的hosts（hosts · starlike_daydream/Installer - 码云 - 开源中国 (gitee.com)）的51-82行到你的hosts里
- Github加速器：下载链接（最好只用于访问，建立ssh连接可能会有问题，本人亲身尝试）
- 更改hosts文件：https://developer.aliyun.com/article/1077240
  - (4)上传一个帖子/笔记：hexo new post “文件名”（这个文件就是md文档，内容将在这里编写）（位于生成的博客目录->source->_post）
(5)生成网页的连接的位置：
- 你创建的仓库repository–>上方菜单栏Settings–>左方菜单栏Pages–>Source选择：Deploy from a branch–>Branch选择：master，folder选择root–>点击save过一会刷新应该就会生成