使用 Hexo 和 GitHub Pages 搭建简单的个人博客

闲来无事,趁着摸鱼时间,使用HexoGitHub搭建出最简单的个人博客。
毕竟磨蹭了很久了,苦于自己的技术水平不够,加上日常懒癌发作,终终终于找到了最简单又免费的方式来搭建个人博客,顺带撸出自己的第一个博文。
下面就让我们愉(tong)快(ku)的开始吧!

准备工作

环境

先安装好以下应用程序:

安装过程不再赘述,可自行度娘,安装完毕后,使用npm即可完成Hexo的安装。

$ npm install -g hexo-cli

GitHub

注册并登陆好 GitHub 账户

Hexo

创建你的项目

在控制台执行以下命令

$ hexo init <folder>

如果你的电脑安装了yarn,执行该脚本后,会自动为你安装依赖(即执行yarn install),否则你还需执行以下命令

$ cd <folder>
$ npm install

至此,你的本地博客已经建立成功,只需要运行

$ hexo server

并在浏览器上输入地址 localhost:4000 便可预览初始化的博客内容。

GitHub

创建自己的仓库

进入你的 GitHub 主页,创建一个新的repository
并输入对应的Repository name,请注意:必须保持格式<username>.github.io,其中<username>替换成你的 GitHub 账户名,例如:lostimever.github.io

create.jpg

点击Create repository即可。

将本地博客上传至GitHub

修改本地文件

打开之前新建的hexo文件夹,在根目录下有个_config.yml文件,用文本编辑器打开,在最下面找到deploy,修改为:

deploy:
  type: git
  repository: http://github.com/<username>/<username>.github.io.git
  branch: master

<username>替换成你的 GitHub 账户名,并保存即可。

开始部署

在命令行中输入:

$ hexo g
$ hexo d

当命令行中显示:
INFO Deploy done: git
说明部署成功。打开浏览器在地址栏中输入lostimever.github.io(将lostimever改成自己的),就能看见自己的博客了,别人也可以访问。

可能出现的问题

报错:ERROR Deployer not found: git

在命令行中输入
npm install hexo-deployer-git --save

yarn add hexo-deployer-git
重新执行

$ hexo g
$ hexo d

*注意: 笔者安装的hexo的版本为

 hexo: 3.8.0
 hexo-cli: 2.0.0

不同的版本之间的配置可能有些许不同,注意查看自己的版本。

写博客文章

创建新的文章

在命令行中输入:hexo new “name”(将name替换成你的文章的标题),
然后在source/_posts/里就能看到名为name.md的文件了,现在就可以愉快的写博(tu)客(cao)啦。
也可以直接在source/_posts/里直接新建一个名为name.md的文件,注意开头需加入以下内容:

---
  title: name
  date: 2019-05-31 21:57:27
  tags:
---

文章中如何插入图片

Hexo插入图片的方式很多,这里只介绍一种:将图片放在当前文章的目录中。文章的目录可以通过配置_config.yml来生成。

post_asset_folder: true

_config.yml文件中的配置项post_asset_folder设为true后,执行命令$ hexo new "name",在source/_posts中会生成文章name.md和同名文件夹name。将图片资源放在name中,文章就可以引用图片资源了。

{% asset_img image.jpg document name %}

发表文章

写好文章并保存后,重复 开始部署 中的操作即可。

结束

建博一时爽,更新如难产。

参考

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

推荐阅读更多精彩内容