利用Hexo与GitHub搭建个人博客

写在前面的废话

很久以前就看到过许多漂亮的博客,尤其是在遇到技术问题百度一下的时候,总会点到一些技术大牛的个人博客里,看他们的解决方法和一些私人日志(偷笑)。每次看到漂亮的博客都觉的好羡慕,想着将来自己也搞这么个东西玩玩,于是就有了这个学来的“教程”。

了解 Hexo 和 GitHub 的朋友们,估计这篇小短文对你们也没什么帮助了,可以不用浪费时间啦~而对于普通小白,想要免费搭建一个可以让任何人都可以访问到的自己专属博客,可以继续往下看~

PS: 本教程以Mac OS作为参考,不同系统(Windows, Linux)具体安装工具方式可能不同,建议参考相关官网进行安装配置。

工具介绍

Hexo

HexoGitHub地址)是一个基于 Node.js 的静态博客程序,可以方便的生成静态网页托管在 GithubHeroku上。作者是来自台湾的@tommy351。官方介绍:

1
2
A fast, simple & powerful blog framework, powered by Node.js.
基于 Node.js 的快速、简洁但功能强大的博客框架。

Node.js

使用 Hexo 需要依赖于 Node.js,在此做简单介绍,引用百度百科内容:

1
2
3
Node.js 是一个基于Chrome JavaScript 运行时建立的一个平台,用来方便地搭建快速的易于扩展的网络应用.
Node.js 借助事件驱动,非阻塞 I/O 模型变得轻量和高效, 非常适合运行在分布式设备的数据密集型的实时应用.
Node.js 对 Google V8 引擎(应用于 Google Chrome 浏览器)进行了封装.

Github

我们用 Hexo 搭建好的博客要将网站托管在 Github 上,在此也简单介绍下。引自百度百科:

1
2
3
gitHub是一个面向开源及私有软件项目的托管平台,因为只支持git 作为唯一的版本库格式进行托管,故名gitHub。
gitHub于2008年4月10日正式上线,除了git代码仓库托管及基本的 Web管理界面以外,还提供了订阅、讨论组、文本渲染、在线文件编辑器、协作图谱(报表)、代码片段分享(Gist)等功能。
目前,其注册用户已经超过350万,托管版本数量也是非常之多,其中不乏知名开源项目 Ruby on Rails、jQuery、python 等。

准备工作

安装 Node.js

Node.js 可以从官网根据不同系统下载安装。这里 Mac OS 推荐使用 Homebrew进行安装,省去了配置环境等麻烦,也易于卸载。直接在终端输入命令:

1
ruby -e "$(curl -fsSL https://raw.github.com/Homebrew/homebrew/go/install)"

安装 node.js,在终端输入:

1
sudo brew install node

此时可能需要输入电脑密码,输入完成后等待安装完成。再输入:

1
node -v

如果可以看到版本号,说明安装成功。

安装 Hexo

安装 Hexo 极其简单,官网也只有一条命令:

1
npm install hexo-cli -g

等待安装完成,输入

1
hexo --versio

看到版本号说明安装成功。

安装 git

同样的,git 也可以从官网下载安装,或者用 homebrew

1
brew install git

直接安装。(不过 Mac OS 好像是自带git的吧,或者只要安装了 xcode,git 就会自动安装)
测试安装是否成功,在终端输入:

1
git --version

看到版本号说明安装成功。

搭建博客

准备工作完成,终于可以开始搭建我们自己的博客了。其实跟着Hexo官网的教程很快就可以自己搞定,但是如果懒得去可以继续往下看。

注意:以下所有的操作都在终端进行

  • 选择路径

用 “cd” 命令进入想要建立博客的路径(文件夹)

1
cd 文件夹名称

  • 初始化博客

比如我们建立的博客名字叫 blog,则终端输入命令:

1
hexo init blog

切换到刚刚的 blog 目录下,安装所有的依赖包:

1
2
cd blog
npm install

到此,博客就算成功建立起来了,我们已经可以启动博客看看效果了。

  • 启动博客

运行以下命令进行清理

1
hexo clean

运行以下命令生成所需要的静态页面及文件(g 即 generate)

1
hexo g

运行以下命令启动服务器(s 即 server)

1
hexo s

然后打开浏览器,输入地址 localhost:4000 即可看到效果

  • 发表文章

比如我们想发表一篇名为“我的第一篇博客”的文章,在终端输入:

1
hexo new 我的第一篇博客

运行之后可以在 source/_posts 目录下生成“我的第一篇博客.md”文件,进入便可用 MarkDown 语言编写博客。

再利用上面三个命令重新生成下,看看效果

1
2
3
hexo clean
hexo g
hexo s

  • 配置博客

网站的设置大部分都在 _config.yml 文件中,详细配置可以查看官方文档,下面列出一些简单的常用配置:

title -> 网站标题
subtitle -> 网站副标题
description -> 网站描述
author -> 作者名字
language -> 网站使用的语言
theme -> 网站主题

注意:进行配置时,要在冒号后面加一个英文空格!

  • 关于主题和其他配置

同样的,许多好看的主题都在官网查看。推荐 nexT 主题,可以在 blog 路径下,输入:

1
git clone https://github.com/iissnan/hexo-theme-next themes/next

下载好之后,只需要在 _config.yml 配置文件中 theme 设置。再次利用上面的三个命令查看效果:
再利用上面三个命令重新生成下,看看效果

1
2
3
hexo clean
hexo g
hexo s

注:要让网站的配置文件的修改生效就必须利用 “hexo g”重新生成响应文件,而主题文件夹下的配置文件(“/theme/主题名称/_config.yml”)的修改只需要刷新网页即可看到效果

部署博客至GitHub

在 GitHub 中建立自己的 public 库

首先去 GitHub 注册自己的账号,然后登录,创建 New repository,如果你的账户名称是 ZhangSan,则需要创建一个名称为 “ZhangSan.github.io”的 public 库。此时我们需要给自己的电脑生成一个 ssh key 来连接 GitHub。在终端输入:

1
2
3
4
cd ~
git config --global user.name yourname
git config --global user.email yourmail@gmail.com
ssh-keygen -t rsa -C yourmail@gmail.com

连续按三次回车,设置密码为空。
输入以下命令,复制里面的所有内容,再按 “Esc -> :q” 回车,退出编辑界面。

1
vi .ssh/id_rsa.pub

在 GitHub 上点击右上角自己的头像 -> Settings —> SSH nd GPG keys —> New SSH key,把刚刚复制的内容粘贴到 key 中,随便起个名字填入 title 并点击 Add SSH Key

开始部署

首先安装 hexo-deployer-git。在终端利用“cd”命令进入刚刚建立好的 blog 路径下,输入:

1
npm install hexo-deployer-git --save

然后打开 blog 文件夹下的 _config.yml 文件配置 deploy:

1
2
3
4
deploy:
type: git ------> 直接填写 git
repository: https://github.com/yourname/yourname.github.io.git -----> Github 的仓库地址
brach: master

保存退出,在终端输入(d 即 deploy):

1
2
3
hexo clean
hexo g
hexo d

至此,成功之后便可以通过访问 “username.github.io” 来查看你的博客啦!

参考文章

本“教程”仅为博客搭建入门教程,也只是记录下自己第一次搭建博客的过程,大家可以根据自己的需求做进一步改进,如更换主题、删除文章等,详情参考官方文档

PS:没想到第一次写个博客用了这么久,让某蛋久等了…以后这里应该也会写写这个某蛋的故事,希望将来不管谁看到的时候,都是满脸笑意

文章作者:Xiao

原始链接:https://zxshwan.github.io/archives/f23eadd3.html

许可协议: 署名-非商业性使用 转载请保留原文链接及作者。

0%