hexo:(一)基于 github 托管的 hexo 个人博客搭建

前言

有关hexo + github 搭建个人博客的博文参考文献很多,但是在很多细节上、或者因为版本异化的原因,想把自己的所见所遇记录下来,给自己的一个满意的交代,也为了后续使用 hexo 在更新、再研究一个积淀,当然了,可以给也想使用 hexo 搭建博客的同学们更多的参考。

环境

system : Windows
node.js : v8.11.0 写作时为最新版本
git : v2.9.0 写作时为v2.17.0
hexo : v3.7.1 写作时为最新版本

node.js 下载安装

  1. 下载地址:node.js(英文官网)node.js(中文官网)
    image
  2. 选择适合自己操作系统的node.js版本进行安装,Win、Mac基本都是一键式安装,需要安装linux版本安装的小伙伴,辛苦一下,按照官网文档安装。
  3. 作用:node.js用来创建hexo博客框架的

git 下载安装

  1. 下载地址:git官网
    image
  2. 选择合适自己操作系统的 git 版本下载安装
  3. 作用:把本地的hexo内容提交到github上去

hexo 安装配置

  1. 在任意位置点击鼠标右键,选择Git Bash 进入 git 命令操作台
  2. 使用 npm 命令安装hexo

    1
    npm install -g hexo-cli
  3. 创建一个博客根目录,目录名随意,比如:在桌面创建一个 blog 文件夹(此为站点根目录

  4. 使用 Git Bash 切换到站点根目录中操作以下命令
  5. Hexo 初始化,Hexo 即会自动在目标文件夹建立网站所需要的所有文件

    1
    hexo init
  6. 安装依赖包

    1
    npm install
  7. 安装完成后 hexo 根目录大概内容如下(截图时已经安装了第三方模块,所以可能略有不同,但是结构一定相同):
    image

  8. 在站点根目录下执行

    1
    2
    hexo g
    hexo s
  9. 浏览器上访问 http://localhost:4000 就可以看到默认是 landscape 的主题

github 配置

使用 github 托管 hexo

  1. 无 github 账号的自建,否则忽略
  2. 创建一个 repository
    image
  3. 创建填写的表单中,只需要填写Repository name即可,当然这个名字的格式必须为youname.github.io,例如:chentging.github.io

    此处必须使用你 github 用户名(猜测是hexo 和 github 有映射关系)

hexo 托管到 github

在 Hexo 中有两份主要的配置文件,其名称都是_config.yml。 其中,一份位于站点根目录下,主要包含 Hexo 本身的配置;另一份位于主题目录下,这份配置由主题作者提供,主要用于配置主题相关的选项。
为了描述方便,在以下说明中,将前者称为 站点配置文件, 后者称为 主题配置文件

  1. 修改站点配置文件

    1
    2
    3
    4
    deploy:
    type: git
    repo:
    github: git@github.com:chentging/chentging.github.io.git,master
  2. 配置ssh(已经配置过忽略此项)

    • 检查是否已经存在了SSH keys

      1
      ls -al ~/.ssh

      如果不存在没关系,如果存在,删除.ssh文件夹里面所有文件

      image

    • 生成 .ssh 文件(邮箱为注册Github时候的邮箱,出现提示让你输入的时候直接先回车,需要3次)

      1
      ssh-keygen -t rsa -C "chentging@aliyun.com"
![image](https://raw.githubusercontent.com/chentging/Static_Resources_Files/master/2018/5/14/github_ssh2.png)

- 执行命令:
1
ssh-agent -s
![image](https://raw.githubusercontent.com/chentging/Static_Resources_Files/master/2018/5/14/github_ssh3.png) - 执行命令:
1
ssh-add ~/.ssh/id_rsa
![image](https://raw.githubusercontent.com/chentging/Static_Resources_Files/master/2018/5/14/github_ssh4.png) > 发生错误执行以下命令,否则跳过下面两条命令
1
2
eval `ssh-agent -s`
ssh-add
![image](https://raw.githubusercontent.com/chentging/Static_Resources_Files/master/2018/5/14/github_ssh5.png) - 拷贝 ssh key 值
1
clip < ~/.ssh/id_rsa.pub
- 在Github页面,点击右上角的设置图标Settings --> SSH and GPG keys --> Ttile为此ssh key 的名称, Key为复制的key --> Add SSH key,最后会让你重新输入下gitHub的密码 - 测试连接
1
2
ssh -T git@github.com
> 若有警告,输入“yes”,跳过
![image](https://raw.githubusercontent.com/chentging/Static_Resources_Files/master/2018/5/14/github_ssh6.png)
  1. 将 hexo 部署到 github
    1
    2
    hexo g
    hexo d

如果执行hexo d命令报错, 安装hexo-deployer-git模块

1
npm install hexo-deployer-git --save

安装完成再次执行 hexo d

访问测试:https://chentging.github.io/

发布一篇文章

1
hexo new "梦想远航"

在站点根目录下的 /source/_posts 中打开《梦想远航.md》

1
2
3
4
5
6
7
8
title: 梦想远航
date: 2018-05-14 24:04:09 #发表日期,一般不改动
categories: blog #文章文类
tags: [文章] #文章标签,多于一项时用这种格式,只有一项时使用tags: blog
---
#这里是正文,用markdown写,你可以选择写一段显示在首页的简介后,加上
<!--more-->
在<!--more-->之前的内容会显示在首页,之后的内容会被隐藏,当游客点击Read more才能看到。

重新部署到 github 上流程

1
2
3
hexo g
hexo s //先本地预览
hexo d //再部署到github

-------------本文结束  感谢您的阅读-------------
你的支持是我创作的最大的动力
0%