Hexo+Github 搭建个人博客(小白版图文教程)

原 Blog 链接:Hexo+Github搭建个人博客(小白版图文教程)

写在前面

最近兴趣使然,想要搭建一个个人博客。每次看到别人拥有自己的个人主页都特别羡慕,一直想着自己有一个博客该有多好啊。就这样折腾了两天时间,看遍了网上各种各样杂乱的教程,走了很多弯路,终于成功搭建出来了。等到结束的那一刻,心里很是开心。回想这一整个步骤,其实并不难,很简单就能掌握。
由于自己是技术小白,很多大神写的教程看了依旧操作错误。多么希望有人能手把手的教你每一步做什么。
有过经历,才知道好的教程的重要性。因而我将自己建站的步骤详细记录下来,以供参考。希望后面想要建站的人不要走弯路了哦~

搭建环境

配置 Node.js 环境

下载 Node.js 安装文件,根据自己电脑的位数,选择下载32位或者64位的:http://nodejs.cn/download/
然后安装下载的文件,保持默认设置就好了,一路点 Next ,很快就安装完成了。


接着检查一下 Node 是否安装好,打开运行窗口,输入 cmd ,打开命令行:

在命令行分别输入以下命令:

node -v
npm -v

如果出现下图界面,则说明 node 安装正确。可以进入下一步了。

配置 Git 环境

去官网下载 Git 安装文件:

接着进行安装,如下图,在 Windows Explorer integration 这一项及下边的两项都打上勾:


然后一直 Next 就可以了,安装完成后同样检查一下 Git 是否正确安装。

Github账户的注册和代码库的创建

Github帐号注册,打开链接:https://github.com/,申请一个 Github 帐号;


注册好之后还需要确认邮箱,打开注册的邮箱,确认注册,然后进入下一步;
点击页面右上角自己的头像,点击下拉菜单的New repository,创建一个新的代码库:

代码库的名字最好与你的用户名相同,格式为 yourname.github.io ,比如我的用户名是 renkaitest,那我的代码库名即为 renkaitest.github.io

创建成功后出现下图所示界面,点击右边的复制按钮,复制这个地址:

配置 Github pages

随便找一个目录,右击鼠标,选择Git Bash Here,打开一个类似命令行的界面,输入以下代码:

$ git clone https://github.com/username/username.github.io
  • clone 后面的链接即就是上一步复制的那个链接,比如我的就是下面的代码:
$ git clone https://github.com/renkaitest/renkaitest.github.io


然后输入 cd 你的代码库名 ,例如 cd renkaitest.github.io ,也可以直接进入该目录下的一个名为 renkaitest.github.io 的文件夹。

$ cd renkaitest.github.io
  • 然后输入:
$ echo "Hello World" > index.html

接着输入:

$ git add --all
$ git commit -m "Initial commit"
  • 这里会出现一个错误,是因为我们没有设置Git的 user nameemail ,此时输入以下代码:
$ git config --global user.email "541638321@qq.com"
$ git config --global user.name "renkaitest"
  • 注意:上面的 nameemail 都要换成自己的邮箱和用户名
  • 此时继续执行以下代码:
$ git commit -m "Initial commit"


下面 push 到你的代码库,输入代码:

$ git push -u origin master
  • 可能会弹出以下界面让你登录,使用 Github 帐号登录即可。



此时你的 Github Pages 已经配置好了,打开 yourname.github,io 这个网址就能看到你的博客了,yourname 替换成你自己的用户名。

Hexo安装

找一个目录,我是在 d:\Hexo 目录下,鼠标右击打开 Git Bash Here,输入:

$ npm install hexo-cli -g


可能会看到一个 WARN,但是没关系的,进入下一步。
输入:

$ npm install hexo --save
  • 等一段时间,他安装完之后检查一下是否安装成功,输入:
$ hexo -v
  • 看到相关的版本信息则说明安装成功。

Hexo配置

初始化 Hexo,首先需要找一个目录,这个目录即就是你的博客的所有文件存放的目录,最好路径不要太深,我选择的是 D:\Hexo\blog 。在这个路径下打开 Git Bash Here ,输入代码:

$ hexo init

然后输入:

$ npm stall

这里 npm 会自动帮你安装你需要的组件。
继续输入:

$ hexo g

生成博客。

输入:

$ hexo s

启动服务,会提示以下信息:

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

在浏览器打开 http://localhost:4000/ ,将会看到自己的 hexo 博客:

关联 Hexo 与 Github Page

配置Git个人信息

如果你之前已经配置好git个人信息,请跳过这一个步骤,直接来到步骤2
设置Git的user name和email:(如果是第一次的话)

$ git config --global user.name "renkaitset"
$ git config --global user.email "541638321@qq.com"

生成密钥

$ ssh-keygen -t rsa -C "541638321@qq.com"


输入代码后一直按回车就好了,不用自己定义目录,生成的 ssh 会存放在 C:\Users\用户名\.ssh 目录下,如果找不到 .ssh 目录,请在文件夹选项中显示隐藏的项目

配置 SSH 密匙

进入 Github 网页,点击右上角自己的头像,选择 Settings

配置 SSH and GPG keys ,点击 New SSH key


用 txt 打开刚才生成的 Key,复制到下图所示区域,点击 Add SSH key

配置 Deployment

打开博客目录下的站点配置文件 _config.yml ,比如我的博客目录是 D:\Hexo\blog,找到该目录下的 _config.yml。打开他,在最末尾找到 Deployment ,然后按照如下修改:

deploy:
  type: git
  repo: git@github.com:yourname/yourname.github.io.git
  branch: master

上面的 yourname 都要替换成自己的用户名,以我的为例:

deploy:
  type: git
  repo: git@github.com:renkaitest/renkaitest.github.io.git
  branch: master

这样就配置好了,接下来就可以写博客了。

发布博文

新建一篇博文,在博客存放的目录里面 Git Bash Here ,执行命令:

$ hexo new post "我的第一篇博文"


然后就会在电脑的目录下 D:\Hexo\blog\source\_posts 看到一个 我的第一篇博文.md 文件,使用 MarkDown 编辑这篇文章就可以了。
文章编辑好后,运行生成、部署命令。
但是此时还缺少一个扩展,因而不能部署,先要执行以下命令:

$ npm install hexo-deployer-git --save

如果没有执行这个命令,将会提醒:

deloyer not found:git

现在开始执行:

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

也可以将这两个命令一起执行:

$ hexo d -g    //在部署前先生成

若出现如下图所示的信息 INFO Deploy done: git ,则表示部署成功,已经上传到你的代码库。

此时访问你的地址 https://yourname.github.io ,将会看到刚才写的文章了。


注:我的主题是自己换过的,可能与你的显示结果有所不同,做到这一步,你已经成功搭建了自己的博客。已经大功告成了!恭喜你~

总结

以后发布博文,就是以下的步骤:

  • 写博文:
$ hexo new post "博文名字"
  • 生成博文:
$ hexo g
  • 部署博文:
$ hexo d
  • 由于网络原因,进入你的网页可能不会立即显示最新的信息。过几分钟就好了~

原 Blog 链接:Hexo+Github搭建个人博客(小白版图文教程)

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

推荐阅读更多精彩内容