【个人博客搭建踩坑记录】

踩坑记录

参考了知乎大佬的分享：https://www.zhihu.com/column/c_1201860091307458560

其中在第5篇《安装node.js和Hexo》中安装Hexo需要注意：

• 在GitHub上创立的仓库一定要和用户名相同，即

    liqiang995/liqiang995.github.io
  

总之我试图不一样但最后就是打不开。

• 在 _config.yml 中，repository 如果指定仓库的是https地址

    deploy:
      type: git   # type前有两个空格, git与冒号中有一个空格
      repository: https://github.com/liqiang995/liqiang995.github.io.git
      branch: main  
  

则在执行 hexo d 时会提示需要输入邮箱和密码，但我多次输入Github登录邮箱和登录密码都失败，有大佬https://blog.csdn.net/qq_43479540/article/details/104602926说，这里的密码是指的ssh密钥，但试了也不行。。原因有空再研究。

• 既然要验证ssh，那repository 直接使用 Github上ssh地址

    deploy:
      type: git
      repository: git@github.com:liqiang995/liqiang995.github.io.git
      branch: main
  

接下来 hexo d 部署好，就可以成功访问https://liqiang995.github.io/了。
参考：https://blog.csdn.net/hhgggggg/article/details/77853665

关于ssh

本机是否安装 ssh：

$ ssh 

生成 ssh 密钥

$ ssh-keygen -t rsa [邮箱账号]     # 不指定邮箱的会在密码中指定当前环境的用户名/设备名 （不方便迁移）

Github 和 GitLab 用一个邮箱登录，生成的ssh可以同时配置，如果有多个邮箱需要设置多个ssh可以参考：https://www.jianshu.com/p/b46e4036b216

查看已生成的 ssh 密钥

$ cd ~/.ssh     # Linux 和 Mac 会在 【~/.ssh 】下、windows 会在 【C:\Users\用户名\.ssh】下
$ cat id_rsa.pub

把ssh 密钥配置到Github 和 Gitlab上 ： settings > SSH and GPG keys

注意 2020.10.1之后github默认主分支不再叫master。而git在2.28版本配置，可以修改默认提交分支为 main

	git config --global init.defaultBranch main

网站中文乱码

因为站点配置文件没有使用utf-8编码造成的，
以utf-8格式打开_config.yml，在其中输入的中文，才能被正确编码。

如何写作新文章并发布

https://cloud.tencent.com/developer/article/1662733

在根目录下打开命令行，使用如下命令创建新文章：

hexo new <title>

执行该命令，Hexo会在/source/_posts目录下创建一篇以<title>命名新的文章，接下来在这篇文章里使用 MarkDown 语法编写文章即可。

打开 Hexo 创建的文章可以看到，注意开头有一段以"- - -"包括起来的内容，这是前置信息，用于给 Hexo 渲染该 md 文档，除了这三项，还有很多的配置项可以自己添加

配置项	含义
title	文章标题
date	文章创建日期
comments	文章评论
tags	文章标签
categories	文章分类
keywords	文章关键字

在"- - -"以后的区域，都可以支持大多数Markdown 语法，编写正文。

1. 文章写好之后，首先清除掉旧的网页数据：

hexo clean

这个命令会清除掉之前生成的网页，即站点根目录下的public文件夹

2. 生成新的网页

hexo g

注意：每次修改文章后，都要执行这两条命令，清除掉旧的数据，然后重新生成页面。。

3. 本地开启服务器，预览一下文章

hexo s

4. 使用hexo d来将文档部署到Github

hexo d