github + hexo

本篇主要记录一些自己github博客搭建的过程。

1、配置 Node.js 和配置 Node.js 环境

2、安装Git和配置Git环境

注:本篇主要写搭建博客,工具类的不再赘述

3、github配置

  • 我们假设你已经有了一个 github 账号,你需要添加一个新的 new repository。点击创建一个新的 repository ,你需要将你的 Repository name 设置为 ** 账户名.github.io ** ,这一步至关重要。
  • 在建好的项目右侧有个settings按钮,点击它,向下拉到GitHub Pages,你会看到一个 http://账户名.github.io 的网址,这样,你已经有一个属于自己的博客啦。

    4、hexo 配置

  • 首先找一个合适的位置创建一个文件夹,通过 git 进入到该文件夹下
  • 输入 npm install hexo -g,开始安装Hexo
  • 输入 hexo -v,检查hexo是否安装成功
  • 输入 hexo init,初始化该文件夹。看到 ** “Start blogging with Hexo!” ** 即成功
  • 输入 npm install,安装所需组件
  • 输入 hexo g,对文件进行编译
  • 输入 hexo s,输入hexo s,开启服务器,访问该网址,正式体验Hexo。
    我的默认端口是4000,如果你的页面一直无法跳转,可能是端口号被占用,可以通过 hexo server -p 端口号 进行修改。

    5、将Hexo与Github page联系起来

  • 设置Git的user name和email(对于第一次设置的童鞋)
    git config --global user.name "xxx"
    git config --global user.email "xxx@gmail.com"
  • 输入cd ~/.ssh,检查是否有.ssh的文件夹,输入ls,列出该文件下的内容。如果有id_rsa,id_rsa_pub,known_hosts,则说明存在。
  • 输入 ssh-keygen -t rsa -C "你的github邮箱地址",连续三个回车,生成密钥,也会自动生成两个文件:id_rsa和id_rsa.pub(默认存储路径是:C:\Users\Administrator\.ssh
  • 输入eval "$(ssh-agent -s)",添加密钥到 ssh-agent
  • 输入ssh-add ~/.ssh/id_rsa,添加生成的 SSH key 到 ssh-agent
  • 登录Github,点击头像下的settings,点击 SSH and GPG keys,点击 右侧的 new SSH key,用VS Code打开id_rsa,ctrl + A 全部复制粘贴到新建的 SSH key 中。
  • 输入ssh -T git@github.com,测试添加ssh是否成功。如果看到Hi后面是你的用户名,就说明成功了。
  • 配置Deployment,在其文件夹中,找到_config.yml文件,修改repo值(在末尾),配置成如下效果。
deploy:
  type: git
  repo: git@github.com:limoon7/limoon7.github.io.git
  branch: master
  • 新建一篇博客,在git下执行命令:hexo new post “博客名”,这时候在文件夹_posts目录下将会看到已经创建的文件。
  • 在生成以及部署文章之前,需要安装一个扩展:npm install hexo-deployer-git --save
  • 使用编辑器编好文章,那么就可以使用命令:hexo d -g,生成以及部署了
  • 部署成功后访问你的地址:http://用户名.github.io,就可以看到你的文章啦
  • 在实际的使用中,可以修改过文件后可以先在本地预览预览,通过hexo -s 命令
  • 个人一般使用的顺序为: hexo clean ,hexo -g ,hexo -shexo -d

6、配置 yilia 主题

是不是觉得配置好的不是很美观,那就来一个优雅大方的主题吧!

参考资料:一个简洁优雅的hexo主题 A simple and elegant theme for hexo.

7、遇到的一些问题

-hexo d 出现ssh连接问题,如下所示

ssh: connect to host github.com port 22: Connection timed out

解决方法:git 连接 github 超时问题

发表回复