github + hexo

作者 jarod发表于

本篇主要记录一些自己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 -s, hexo -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 超时问题

发表回复