在Github上搭建一个免费的Hexo博客系统

图片来自网络

什么是Hexo

Hexo是一个基于Nodejs快速简洁高效的博客框架,Hexo使用Markdown语法来编辑文章,只需要几秒钟的时间就可以成生静态的网页。整个系统就是一个博客系统。

安装Hexo

Hexo是基于Nodejs的博客系统,在安装Hexo之前需要安装Nodejs,把博客搭建在免费的GitHub上,所以需要安装Git。如果你已经安装上述软件,可以跳过以下的1,2步骤

安装Nodejs

Node.js的官网下载地址是:https://nodejs.org/,下载好之后,双击安装,一路Next即可,只需要记住Node.js的安装路径,一般路径是''C:\Program Files\nodejs'' 。注意的是需要添加hexo和npm到环境变量,路径分别是 C:\Program Files\nodejs;C:\Program Files\nodejs\node_modules\npm;

hexo 和npm的环境变量

安装Git for windows

Git for windows 的下载地址是:https://git-for-windows.github.io/,下载好后也同样是一路Next安装即可。

安装Hexo

右键桌面任意位置,打开Git Bash,执行命令:

npm install -g hexo

如果是出现错误,一般是因为被墙的原因,可以换国内的镜像源试试。

npm config set registry="http://registry.cnpmjs.org"
npm install -g hexo

创建Hexo文件夹

创建一个新的文件夹(如E:\hexo),打开Git Bash

cd /e/hexo
hexo init

这一步是在hexo目录下建立网站所需要的所有文件,除了如下的public/文件夹(public文件是生成的静态网站)



至此本地的Hexo博客系统算是已经搭建完成了

Hexo基本命令

下面是在编辑博客和生成博客所需要的几个常见的命令以及它们的缩写形式。即使用新版本的Hexo两边是等价的命令。

hexo generate = hexo g
hexo server = hexo s
hexo delopy = hexo d
hexo new = hexo n

hexo g

hexo g 是生成静态博客的命令,一般是对博客系统修改之后通过该命令来重新生成public 文件夹,比如添加、修改、删除一篇博文,对博客的卑职文件修改,修改主题和添加插件等操作都是需要通过该指令Hexo g来重新生成的。

hexo s

hexo s是在本地上开启博客系统,一般修改博客之后需要在本地上预览调试,执行hexo g && hexo s 可以在本地浏览器上查看(浏览器上输入 http://localhost:4000)。

hexo d

hexo d是上传你的博客到服务器,接下来我会介绍如何上传到git,然后就可以在github.io上查看你的博客了。

hexo n

hexo n “< blog name >”是创建一篇新的博客,执行该命令之后在 E:\hexo\source_posts 目录下产生< blog name >.md文件,这是你的一篇新博客。可以在markdown工具下编写,这里我就不详细介绍了,详细可以看这篇说明:Markdown 语法说明(简体中文版)

部署到Github

在github上创建一个仓库

刚才的步骤已经可以在本地上编辑文章,然后在本地可以查看效果了。接下来就是讲博客系统部署到Github上。如果不清楚github是干什么用的,可以查看维基百科:github -wiki


在github上注册一个账号,如果有就省去这一步,创建一个仓库,Repository name和自己的用户名相同。比如我的用户名为wenjunoy,那么Repository wenjunoy.github.io

配置SSH

上传文件需要配置ssh key,不然无法上传。

设置name和emai
git config --global user.name "<your name>"
git config --global user.email "<your email>"

需要注意的是这里的name是随意的,邮箱是你的联系邮箱,与github上的邮箱无关。

生成ssh 密钥
ssh-keygen -t rsa -C "<your github's email>"

一路按回车键即可,如果设置了密码请记住。
这一步在~/.ssh/下生成了两个文件id_rsa 和 id_rsa.pub

在Github上添加SSH密钥

打开上述的id_rsa.pub 文件,复制其内容,在https://github.com/settings/keys下 add new ssh key,


title随便填写,作为你的电脑的一个记号。确定即可。

测试

ssh git@github.com

显示如下即成功

The authenticity of host 'github.com (192.30.252.128)' can't be established.
RSA key fingerprint is 16:27:ac:a5:76:28:2d:36:63:1b:56:4d:eb:df:a6:48.
Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added 'github.com,192.30.252.128' (RSA) to the list of known hosts.
Hi wenjunoy! You've successfully authenticated, but GitHub does not provide shell access.
Connection to github.com closed.

部署到Github

配置_config.yml

编辑E:\hexo 下的_config.yml,修改 Deployment部分

# Deployment
## Docs: https://hexo.io/docs/deployment.html
# ssh://git@github.com/wenjunoy/wenjunoy.github.io
deploy: 
    type: git
    repo: ssh://git@github.com/wenjunoy/wenjunoy.github.io ##这个是你的仓库地址
    branch: master

注意和每个分好右面需要添加空格

部署

hexo d部署,执行该命令发现报错

ERROR Deployer not found: git

执行如下命令在hexo d

npm install hexo-deployer-git --save
hexo d

根据提示输入用户名和密码,等待一会便成功了


然后浏览器上访问:http://wenjunoy.github.io,可以看到hexo博客搭建成功。接下来就是专注于写博客吧。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,524评论 5 460
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,869评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,813评论 0 320
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,210评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,085评论 4 355
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,117评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,533评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,219评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,487评论 1 290
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,582评论 2 309
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,362评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,218评论 3 312
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,589评论 3 299
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,899评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,176评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,503评论 2 341
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,707评论 2 335

推荐阅读更多精彩内容