使用github与Hexo搭建个人博客

使用github与Hexo搭建个人博客


2017年7月9日 16:19:38

很多人都想自己拥有一个博客,把自己的学习总结心得写在上面,技术类类似的网站“简书”、“博客园”、“CSD博客”都可以使用,但是如果你不想前篇一律的博客格式,那就造起来,拥有一个属于自己的博客,自己的网址。

这篇文章是根据我自己搭建博客的经验来总结,关键是————让想搭建博客的小白……不,小透明也能轻轻松松的搭建成功。

github能创建静态的网站博客。写的文章做成HTML网页传到github,加载会很快,也提供免费的空间和域名。关于使用github与Hexo的用法各大论坛网站都有使用方法,本人觉得他们总结的太麻烦。不如一句一句的教你才是最好的 ,干脆会复制粘贴你就能成功了!


搭建博客的步骤

  • 环境搭建
  • 创建配置Hexo
  • 配置github库
  • 配置域名
  • 创建第一篇文章

The first:环境搭建


The second: 创建配置Hexo

Hexo作为本地博客的根目录
在本地的目录里创建Hexo后,类似于我直接创建

在Hexo的目录下右键打开GitBash(或者你按住Shift➕右键>在此处打开命令窗口)

输入或者复制下面的代码 ( 本文中前面有 $ 符号的是在GitBash中打开的。当然你也可以把命名在计算机命令窗口下运行)

$ npm install -g hexo

$ hexo init

然后空空的Hexo就会有下面的结构

$ hexo generate

$ hexo server

(hexo server 启动本地的服务……ctrl+c中断服务的开启)

然后打开浏览器,打开http://localhost:4000/如果能打开就说明这一步已经成功了(ps:打开本地地址的时候,hexo server一定要在开启的状态)

然后出现了hexo–hello world 相当于你自己本地计算机搭建的网站,这个网站只能你自己看到,所以你要把他和Github连接上传。来达到让被人也能看到的目的。

如果你感觉这个主题很low,可以去改变一下主题 选择你喜欢的炫酷主题

下载的部分我喜欢的主题

进入Hexo文件夹下的thems,在这个文件夹下右键GitBash,打开终端

git clone https://github.com/litten/hexo-theme-yilia.git

克隆完成在你的themes中会有一个新的主题包hexo-theme-yilia。

然后打开Hexo下面的_config.yml文件,修改里面的theme–>hexo-theme-yilia


重新打开服务

hexo s

进入本地地址 http://localhost:4000主题旧改变了,同样的方法也可以下载官网中你喜欢的炫酷的主题。

进入上面主题网站下载里面Github的文档

  1. 选择喜欢的主题
  2. 点击要下载主题的名称,进入Github库
  3. 找到绿色按钮,Clone or download,下载压缩包
  4. 解压到Hexo–>themes中
  5. 修改Hexo下面的_config.yml文件中themes下面的为你下载的主题的名字

The Third:配置Github库

在这步的前提你要完成了Github帐号的注册与新建一个库。

打开电脑的开始Git–>Git Bash

检查SSH keys

$ cd ~/.ssh

如果第一次在电脑上装此步骤,就显示No such file or directory 是正常的,如果你以前装过,或者装失败过,那就要清除原来的ssh key设置

$ ls
config    id_rsa    id_rsa.pub    known_hosts
$ mkdir key_backup
$ cp id_rsa* key_backup
$ rm id_rsa*

再次检查

$ cd ~/.ssh

生成新的SSH key

$ ssh-keygen -t rsa -C "你要就收信息的邮箱"
Generating public/private rsa key pair.

Enter file in which to save the key (/Users/your_user_directory/.ssh/id_rsa):<回车就好>

输入密码(这个密码要记住,最后在你上传文件的时候会使用)

Enter passphrase (empty for no passphrase):<输入加密串>
Enter same passphrase again:<再次输入加密串>


添加key到Github

  • 在计算机中搜索文件id_rsa.pub,打开文件复制里面的内容

  • 进入你自己Github的主页悬着按钮settings

  • 选择SSH Key选项,title随便写,把内容复制到key中, 点击add添加成功

    测试在命令行下面直接是复制ssh -T git@github.com (复制不要该任何东西)

$ ssh -T git@github.com

出现,输入:yes

Are you sure you want to continue connecting (yes/no)?

提示successfully

Hi <em>username</em>! You've successfully authenticated, but GitHub does not provide shell access.

设置账号信息

别傻傻傻傻的复制了

$ git config --global user.name "张三"(你的真实名字)
$ git config --global user.email 你的邮箱"(你的邮箱)

上传与发布

进入到Hexo的目录下,用Git Bash执行下面的命令

$ hexo clean
$ hexo g
$ hexo d

在此过程中会让你输入一次密码,这个密码就是生成SSH keys 键入的密码(不知道是啥的抬头向上看看)

成功的提示是

Edpoly done:git

如果没有出现这句话ERROR Deployer not found: git运行下面这就话

npm install hexo-deployer-git --save

在进行一次

The Forth:绑定域名

是这样的此时个人的博客的第一种形式可以使用,就是通过gtihub分配给你的域名访问,形如:xxx.github.io的。

购买域名

得到域名后,点击github自己创建的博客仓库create new file here
IO/+

名字命为CNAME,内容为你自己买的域名(格式要严谨www开头,这个地方容易出错)

提交后,仓库里面会有CNAME的文件,然后点击右上角的Download zip将整个仓库压缩包下载,只要里面的CNAME文件,复制到Hexo下的Source的目录下。这样就可以解析了

ps:如果不想花钱买域名,那就直接用人家github分的域名吧!这也是可以的

The fifth:创建第一篇文章

在Hexo->Source->——post文件夹下面创建你要写的博客

hexo new "文章标题"

他是md类型的文件,使用支持Markdown编译器的的软件打开文件。这样写出来的博客才会好看

同时推荐用Markdown pad,下载地址http://markdownpad.com/download.html

传送豪门–Markdown语法通俗易懂使用https://segmentfault.com/markdown

写完第一篇文章后。可以现在上传到本地预览在网站效果

hexo g
hexo s

达到自己的满意程度就可以发布自己的文章

hexo d

第一次上传可能需要密码,如果出现报错

ERROR Deployer not found: git

就执行一次

npm install hexo-deployer-git --save

再试一次

INFO  Deploy done: git

git上传成功,开启博客之旅–!

报错

hexo部署到github时,提示typeError [ERR_INVALID_ARG_TYPE]: The “mode“ argument must be integer. Receive…

查阅相关文章得知,是node版本过高导致的(我用的是v14.11.0),将node版本换为v10.16.0版本后,部署就成功了!

如果你的其他项目中有需要使用高版本的node,那么你可以使用nvm来进行node版本切换。

https://www.runoob.com/w3cnote/nvm-manager-node-versions.html

1
2
3
4
5
6
7
8
$ node -v
v10.16.0


$ nvm list

16.13.0
* 10.16.0 (Currently using 64-bit executable)