Hexo+GitPage实现个人博客

Hexo+GitPage实现个人博客

环境

• 检验是否安装成功：

  命令：node -v
  显示：v10.16.0（版本可能跟我不一样）

  命令：npm -v

  显示：6.9.0

• 左面单击鼠标右键

  显示：git bash here

• [hexo]:

  安装：npm install hexo-cli -g #安装hexo模块

  命令：hexo -v

  显示：hexo-cli: 2.0.0 ........

开始

新建仓库：

登录github官网，创建一个开源项目

• 项目名称：username.github.io 形式 （项目名创建错误的朋友，点击自己头像，进入设置，删除项目再重来吧~~~）例：guyue.github.io

• 项目描述就随便了

• 公有项目

• 勾上初始化readme

• 完成GitPage创建检查：

  进入项目设置（不是个人设置0.0）

  找到GitHub Pages

  下面显示：

  √ Your site is published at https://username.github.io/

  就成功了

生成密钥

打开git bash（桌面右键，git bash here），输入ssh-keygen -t rsa , 接着回车三下，创建公私钥成功， 回车默认的是把公钥和私钥保存在默认的路径，当然你也可以选择自己的路径，把路径输入即可，但是不建议这样做，后面会出问题

ssh-keygen -t rsa -C "[email protected]"
ssh-add ~/.ssh/id_rsa

在C:\Users\10592.ssh目录下会生成id_rsa和id_rsa.pub文件（后面用到）

在github上添加SSH key

进入自己的github，点击头像，进入settings ，点击SSH and GPG keys，点击new GPG key

把上面的id_rsa.pub文件里的内容复制到key，title随便填，点击Add GPG keys

SSH key添加之后，就可以在本机git bash中进行测试，输入 ssh -T [email protected]进行测试,出现hi xxxx，说名ssh授权成功

如果提示Are you sure you want to continue connecting (yes/no)?，输入yes，然后会看到：

Hi liuxianan! You’ve successfully authenticated, but GitHub does not provide shell access.

如果出现无法登陆的情况，先把之前生成的文件懂删了以后再重新生成一下ssh，（建议使用默认目录，否则这个地方会出问题）

配置git的username与email（第一次使用git）

git config --global user.name "username"
git config --global user.email "[email protected]"

查看是否配置成功，输入下面代码，显示用户名和邮箱

git config --global user.name
git config --global user.email

创建本地项目：

常用命令

$ hexo generate (hexo g) 生成静态文件
$ hexo server (hexo s) 启动本地服务
$ hexo deploy (hexo d) 提交到远程仓库
$ hexo clean 清除本地 public 文件

$ hexo new page "xx"(hexo n page) 创建页面 
$ hexo new "xx" (hexo n "") 创建文章
$ hexo d -g 生成静态并提交到远程仓库
$ hexo s -g 生成静态文件并启动本地预览

初始化

先来说几个注意事项：

• 很多命令既可以用Windows的cmd来完成，也可以使用git bash来完成，但是部分命令会有一些问题，为避免不必要的问题，建议全部使用git bash来执行；
• hexo有2种_config.yml文件，一个是根目录下的全局的_config.yml，一个是各个theme下的；

新建一个hexo文件夹，在文件夹中，打开git bash here输入下列命令初始化本地项目blog

hexo init blog    #通过hexo创建一个blog项目

然后输入如下命令，生成静态文件，并开启本地预览服务，打开浏览器访问 http://localhost:4000 即可看到内容

hexo g 
hexo d

修改主题

先了解blog文件夹中各个文件的作用，打开blog文件夹，里面文件说明如下：

node_modules  npm 文件缓存目录
scaffolds     文夹件下存放的是文章、页面模版
scource       文夹件下存放的是我们的资源文件
themes        文件下存放的是我们的主题文件
.gitignore    git 忽略文件，设置提交文件时，哪些文件不提交
_config.yml   站点配置文件
package.json  站点版本，站点依赖文件

通过预览你肯定已经知道，默认主题真的，很丑！，所以我们可以在网上找一个自己喜欢的主题，hexo官网主题 https://hexo.io/themes/

将自己下载好的主题文件解压到 blog\themes 文件夹下

修改_config.yml中的theme: landscape改为theme: fox(fox为我下载的主题的文件名)，然后重新执行hexo g来重新生成，hexo s 继续预览

如果出现一些莫名其妙的问题，可以先执行hexo clean来清理一下public的内容，然后再来重新生成和发布。

项目上传到github

打开github中建的项目，点击clone or download，选择use ssh 点击复制

打开blog文件夹下配置文件 _config.yml

配置 _config.yml 中有关deploy的部分，复制的内容相信你们已经知道放到哪儿了

deploy:
  type: git
  repository: [email protected]:liuxianan/liuxianan.github.io.git
  branch: master

配置好后,输入如下命令

hexo clean
hexo g
hexo d

不出意外，你应该报错了：

Deployer not found: github 或者 Deployer not found: git

原因是还需要安装一个插件：

npm install hexo-deployer-git --save

其它命令不确定，部署这个命令一定要用git bash，否则会提示Permission denied (publickey).

打开你的git bash，输入hexo d就会将本次有改动的代码全部提交，没有改动的不会：

完成

提交完成，打开√ Your site is published at https://username.github.io/ 后面网址，不出意外，应该成功了

如果你想改变你的访问网址，则需买一个域名，穷b的我就不说了

查看我的个人博客: GitHub