Hexo+Github pages搭了个博客

hexo是基于Node.js的一款静态博客框架,如果想要搭建博客,不想自己写页面的话可以考虑用hexo,其中有很多的简洁主题可供选择,同时hexo支持markdown语法,编辑文章更加方便,快捷。

注:此篇教程以windows系统为例

一、准备工作

1.1 安装软件

首先,需要安装以下几款软件
1、Gitbash 下载地址
2、Node.js 下载地址
3、Github账号 注册地址

1.2 建立博客地址

安装好之后,打开注册好的github,新建一个repositories,名称为username.github.io,username即你自己想要的名称,比如我的是plainnany.github.io,新建好之后打开这个repositories,找到settings(设置),将Github pages那一栏的source改为master branch,就可以生成可以访问的主页地址,你可以把这个地址当做自己的博客地址,当然,土豪朋友可以通过购买域名来作为自己博客的主页。

主页生成之后,需要将自己电脑与github主页"链接起来",可以用ssh key,也可以每次提交博客的时候手动登录(较麻烦)。本文我们用ssh key。

打开gitbash,输入

$ ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

此命令会生成两个文件,id_rsa(私钥)和id_rsa.pub(公钥),用记事本或者gitbash自带的vim打开id_rsa.pub,复制文件,打开github->settings->SSH and GPG keys,点击右上角,new ssh keys,title自拟,将复制的内容拷贝到key中,保存即可。

或者也可以在gitbash中运行如下命令

$ ssh-copy-id user@host

二、安装配置hexo

2.1 配置文件

打开gitbash,下载安装hexo。

$ npm install -g hexo-cli

安装完成可以通过查看hexo版本检查是否安装成功。

$ hexo

如果出现版本信息,就说明安装成功。

选择一个合适的文件夹新建站点文件,建议不要选择需要管理员权限才能创建文件(夹)的文件夹,如可以在d盘hexo文件夹内新建站点信息。

进入该文件夹。

$ cd d:/hexo

初始化hexo

$ hexo init
$ npm install

初始化之后,hexo文件内生成如下文件

打开hexo文件内_config.yml文件,hexo/_config.yml
修改网站相关信息

title: inerdstack
subtitle: the stack of it nerds
description: start from zero
author: inerdstack
language: zh-CN
timezone: Asia/Shanghai

运行命令

$ hexo g
$ hexo s

windows可能会跳出防火墙提示,允许即可,之后会提示:

INFO  Start processing
INFO  Hexo is running at http://localhost:4000/. Press Ctrl+C to stop.

浏览器输入http://localhost:4000/ 就可以预览自己的页面了

2.2 更换主题

如果不满意默认的主题,可以在hexo.io选择自己喜欢的主题,如果喜欢默认的主题直接跳过这个步骤即可。

下面以maupassant主题为例。

$ git clone https://github.com/tufu9441/maupassant-hexo themes/maupassant

注意,hexo下载主题的时候,在作者的github上查看是否要下载额外的文件,如这款主题作者在github中提到下载主题之外还要额外安装两个文件。

$ git clone https://github.com/tufu9441/maupassant-hexo.git themes/maupassant
$ npm install hexo-renderer-jade@0.3.0 --save
$ npm install hexo-renderer-sass --save

如果hexo-renderer-sass下载失败,可以安装sass的升级版scss,

$ npm install hexo-renderer-scss --save

另外使用代理,不要用淘宝镜像下载,而且sass的安装也不依赖其他的文件,不需要根据报错信息再额外的安装其他的文件(博主就是困到了这里一直下载不成功)。

打开hexo的配置文件_config.yml文件,将theme修改为maupassant,保存后运行如下命令。

$ hexo clean
$ hexo g
$ hexo s

打开localhost:4000,主题更换成功。

注意:如果选择的主题未成功更换,或者在下载相关文件的过程中发生报错,可以通过查看作者github的issue,可能会找到相应的解决办法。

主题相关的内容可以在下载的主题文件中的_config.yml文件进行修改,hexo/themes/maupassant/_config.yml。

三、线上部署

复制github仓库地址,要注意复制仓库的ssh地址,不要复制https地址,否则需要输入用户名和密码。

打开hexo的配置文件_config.yml
hexo/_config.yml
找到deploy,注意冒号后面需要有一个英文空格,如果没有repo与branch就自己写入。

type: git
repo: 刚复制仓库的ssh地址
branch: master

配置完成后,在站点目录安装扩展。

$ npm install hexo-deployer-git --save

安装完成后运行命令。

$ hexo g
$ hexo d

打开 https://你的github账户名.github.io 就可以查看自己的博客了。

四、新建博文

$ hexo new "title"

编辑好title文章之后,运行

$ hexo g
$ hexo d

一篇新鲜的博客就出炉啦!

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

推荐阅读更多精彩内容