博客记录

写在前面

突然心血来潮想要拥有一个个人主页，但是不想买服务器和域名（虽然有一台VPS能干很多事），兜兜转转看了一圈，最后!!!我发现GitHub Page配合Hexo的方案。嘻嘻，除了要写markdown就没别的缺点了…算辣，好像markdown也不算难。那就开始吧～

前提：

1、Github账户(相信没有哪个程序猿/媛莫得GitHub吧？)

2、git客户端。下载地址见官网

3、node.js、npm
在node的官网下载一个LTS（长期维护版本），双击安装包～

打开命令行，输入如下命令:

node -v
npm -v

均有输出就可以啦～

GitHub 仓库

在Github建立一个仓库，名字是: 用户名.github.io

假如你的用户名是test，那么仓库名就是: test.github.io

配置SSH Key

目的是避免每次提交都输入用户名和密码。按照以下步骤在命令行中输入。

cd ~/. ssh #检查本机已存在的ssh密钥

若提示“No such file or directory”或“系统找不到指定路径或文件”，则说明是首次配置。

ssh-keygen -t rsa -C "你的邮件地址"

输入完成后连续键入三次回车，在用户文件夹下找到.ssh\id_rsa.pub，这是配置SSH时生成的文件，用文本编辑器打开，复制里面的内容。

然后进入你的GitHub个人主页，进入Setting->SSH and GPG keys->New SSH key:

创建一个新的 SSH Key， 名字可以随意填写（例如还是填写test），内容填入刚才复制的内容。

在命令行中输入下面的内容测试是否成功。

ssh -T git@github.com # 注意邮箱地址不用改

若此时提示Are you sure you want to continue connecting (yes/no)?输入yes。

输出内容如下：

Hi test! You’ve successfully authenticated, but GitHub does not provide shell access。

说明成功了。

此时还需配置GitHub账户

git config --global user.name "test"// 你的github用户名，非昵称
$ git config --global user.email "aa@bb.com"// 填写你的github注册邮箱

Hexo

安装

npm install -g hexo

初始化

在电脑硬盘中找一个地方创建文件夹（最好命名为hexo）,命令行进入该文件夹

hexo init
此时hexo会自动下载一些文件到该文件夹中。继续

hexo g # 生成
hexo s # 启动服务
使用生成命令后hexo会生成一些html文件，博客显示的网页就是在这里生成的

启动服务后可以通过http://localhost/4000 访问。有时候无法访问的原因可能是端口4000被占用了。

修改主题

默认的主题也太丑了，可以自行更换。详情见官网。

比如我们更换成 hexo-theme-jekyll

进入hexo文件夹并输入

git clone https://github.com/pinggod/hexo-theme-jekyll themes/yilia

修改_config.yml文件中的theme: landscape为theme: jekyll
并重新输入 hexo g

注意：若生成失败可以输入hexo clean清理文件

配置_config.yml
找到depoly:修改成如下(test改成自己的用户名)

deploy:
  type: git
  repository: git@github.com:test/test.github.io.git

  branch: master

此时仍然不能正常运行hexo d通常会报如下错误

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

因为还需要安装hexo-deployer-git这个插件

npm install hexo-deployer-git --save

README.md

每次生成之后，在上传之前将README.md复制到hexo/public中，并删除README.html文件

提交

hexo d
常用命令

hexo new "postName" #新建文章
hexo new page "pageName" #新建页面
hexo generate #生成静态页面至public目录
hexo server #开启预览访问端口（默认端口4000，'ctrl + c'关闭server）
hexo deploy #部署到GitHub
hexo help  # 查看帮助
hexo version  #查看Hexo的版本

常用命令的缩写

hexo n == hexo new
hexo g == hexo generate
hexo s == hexo server
hexo d == hexo deploy

常用组合命令：

hexo s -g #生成并本地预览
hexo d -g #生成并上传

更新于2022年

Hexo最大特点竟然是折腾主题，颜控的我真的花了太多时间在上面了呜呜呜～最后还是用了Fluid。