使用hexo和GitHub搭建自己的个人博客(初步搭建)

前言

一直想建一个属于自己的个人博客,用来记录自己学过的一些知识和踩过的坑,发现使用hexo和GitHub可以很便捷的创建一个比较美观的博客,下面是自己在这个过程中遇到的一些问题,供大家参考。

配置

node

注意: 要使用node8.0以上的版本

git

github

自行注册一个

GitHub新建项目

注意:项目必须遵循格式:账户名.github.io,并且需要勾选Initialize this repository with a README

开启GitHub-page功能

点击右侧的Settings,你将会打开这个库的setting页面

点击Automatic page generator,Github将会自动替你创建出一个gh-pages的页面。 如果你的配置没有问题,那么大约15分钟之后,yourname.github.io这个网址就可以正常访问了~ 如果yourname.github.io已经可以正常访问了,那么Github一侧的配置已经全部结束了。

过程

安装Hexo

在自己认为合适的地方创建一个文件夹,这里我以E:/hexo 为例子讲解,首先在E盘目录下创建Hexo文件夹,并在命令行的窗口进入到该目录

安装hexo

npm install hexo-cli -g

可能你会看到一个WARN,但是不用担心,这不会影响你的正常使用。 然后输入

npm install hexo --save

然后你会看到命令行窗口刷了一大堆白字,下面我们来看一看Hexo是不是已经安装好了。 在命令行中输入:

hexo -v

如果你看到了如图文字,则说明已经安装成功了。

hexo的相关配置

初始化Hexo

接着上面的操作,输入:

hexo init

然后

npm install

之后npm将会自动安装你需要的组件,只需要等待npm操作即可。

首次体验Hexo
继续操作,同样是在命令行中,输入:

hexo g

然后输入:

hexo s

在浏览器中打开http://localhost:4000/,你将会看到:

将hexo和GitHub page联系

配置git个人信息

如果你之前已经配置好git个人信息,请跳过这一个 步骤,直接来到

1、设置Git的user name和email:(如果是第一次的话)

git config --global user.name "xujun"
git config --global user.email "gdutxiaoxu@163.com"

2、生成密钥

ssh-keygen -t rsa -C "gdutxiaoxu@163.com"

配置Deployment

首先,应该介绍一下hexo的配置文件_config.yml,基本上配置都是在这里设定

_config.yml配置

在_config.yml文件中,找到Deployment,然后按照如下修改:

deploy:
  type: git
  repo: repo: git@github.com:yourname/yourname.github.io.git ##这里填写的格式要正确
  branch: master

注意:repo: git@github.com:yourname/yourname.github.io.git这里yourname记得要换成你自己的GitHub账户名

比如:我的账户名为GpingFeng

deploy:
  type: git
  repo: https://github.com/GpingFeng/GpingFeng.github.io.git ##这里填写的格式要正确
  branch: master

写博客、发文章

到目前为止,整个博客已经搭建好了,接下来就是愉快的写文章了
新建一篇博客,执行下面的命令:

hexo new post "article title"

这时候在我的 电脑的目录下 F:\hexo\source\ _posts 将会看到 article title.md 文件

用MarDown编辑器打开就可以编辑文章了。文章编辑好之后,运行生成、部署命令:

hexo g   // 生成
hexo d   // 部署

当然你也可以执行下面的命令,相当于上面两条命令的效果

hexo d -g #在部署前先生成

部署成功后访问 你的地址即可。

注意:很多时候很多问题需要在生成之前使用hexo clean清除一下

自己的踩坑:

  • 注意需要提前安装一个扩展:
npm install hexo-deployer-git --save

如果没有执行者行命令,将会提醒

deloyer not found:git
  • hexo本地测试运行重启后页面空白,提示 : WARN No layout: index.html?

运行git clone 指令获得主题后(假设是NEXT主题),在theme主题下保存文件夹的名称为:hexo-theme-next-0.4.0那么如果在config里设置的是next,就会出现这样的WARN,http://localhost:4000/显示的是空白。只要把theme下的文件夹名称改为next就显示正常了。

  • hexo 下的分类和表签无法显示,怎么解决?

步骤1

新建一个文件夹,命名为 tags 。命令如下:

hexo new page "tags"

步骤2
编辑刚新建的页面,将页面的类型设置为 tags ,主题将自动为这个页面显示标签云。页面内容如下:

title: tags
date: 2018-01-07 00:04:06
type: "tags"
comments: false

步骤3

在菜单中添加链接。编辑 主题配置文件 ,添加 tags 到 menu 中,如下:

menu:
  home: /
  archives: /archives
  tags: /tags
  categories: /categories

后记

这里只是搭建起来而已,要实现自己的私人定制可以配置不同的主题,添加不同的功能等等,hexo官网有比较详细的介绍

hexo官方文档

推荐主题
next主题

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

推荐阅读更多精彩内容