Hexo搭建流程简单攻略【Windows平台】

使用Hexo搭建个人博客已经很常见了,但是在Windows平台下还是很多坑,繁繁琐琐,所以把我搭建的过程及遇到的坑分享给大家做个参考。

1. Hexo安装

Hexo安装的前提环境为Node.jsGit,如果您的电脑中已经安装上述必备程序,那么恭喜您!接下来只需要使用 npm 即可完成 Hexo 的安装。

$ npm install -g hexo-cli
(友情提示:最好提前把npm源换成taobao或使用cnpm,否则会经常出现一堆报错)

如未安装以上程序,建议使用google/baidu到官网进行下载安装。

2. 部署本地项目

进入你打算放置hexo项目文件的目录,比如D:\demo\ ,执行下列命令,Hexo 将会在指定文件夹中新建所需要的文件。

$ hexo init <folder>   //<folder>为你打算给Hexo项目命名的文件名
$ cd <folder>
$ npm install

新建完成后,指定文件夹的目录如下:

.
├── _config.yml    //网站配置文件
├── package.json   //应用程序的信息
├── scaffolds      //模版文件夹

├── source
|   ├── _drafts
|   └── _posts     //你推送的博文
└── themes         //你的主题文件夹

3.开始你的第一篇博文

打开git bashcd进入你的hexo项目文件夹,使用hexo new file命令即可新建一篇博文,如下示意

hexo new 开博大吉
示意

新建博文后即可通过路径找到文件进行编辑,或者使用start xxx.md命令进行编辑。

4.网站配置

至此,我们本地项目基本框架已经搭建好了,为了让我们的博客网站能够被访问,我们需要对网站配置文件进行编辑,挂载到我们的GitHub上。
start _config.yml或直接使用编辑器打开_config.yml文件

  • 修改# site中相关内容
# Site
title: V.M小站                                    //网站标题
subtitle: 来一起晒阳光吧                           //网站描述
description: 呆萌怕生 温暖无害                     //个人描述
author: Varonia                                  //作者(你的名字)
language: zh-Hans                                //语言
timezone:
  • 修改最下方# Deployment中相关内容
# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy: 
  type: git
  repo: git@github.com:Varonia/Varonia.github.io.git   //地址修改为你自己的GitHub地址
  username: Varonia   //如后文提到的hexo g -d命令中发生can't find username错误时手动添加本行内容,可有效解决

5.挂载GitHub

最激动人心的环节来了!做完这步以后你就可以通过你的GitHub让人访问你的博客了!那么,我们来咯!

  • GitHub新建库
    在 GitHub 上新建一个空 repo,repo 名称是「你的用户名.github.io」(请将你的用户名替换成真正的用户名)
  • 使用gitbash命令部署
npm install hexo-deployer-git --save   //安装 git 部署插件
hexo clean
hexo generate
hexo deploy  //这两步的命令可简化为hexo g -d  建议每次进行修改需重新推送时都执行这三个命令

进入「你的用户名.github.io」对应的 repo,打开 GitHub Pages 功能,如果已经打开了,就直接点击预览链接,当当当当!你的博客做好啦!

6.更换主题

Hexo拥有着丰富的主题资源,你可以根据自己的喜好进行选择更换。通过访问官网Hexo主题页面进行选择。
选择好你想要的主题后,进入它的GitHub页面,复制它的 SSH 地址或 HTTPS 地址,假设地址为 git@github.com:lewis-geek/hexo-theme-Aath.git,使用git bash进入你的项目文件根目录

$ git clone -b master https://github.com/lewis-geek/hexo-theme-Aath.git themes/aath
//aath为该主题默认主题名,可自行修改,但务必与网站配置文件中填写的名字保持一致

修改_config.yml中第 75 行 theme: hexo-theme-next,保存,并重新执行上面提到的hexo三行部署命令,即:

hexo clean
hexo generate
hexo deploy

再次刷新你的页面,是不是变得美美哒了?

7.备份仓库

历经千辛万苦,终于初步搭建好你的博客,是不是觉得就大功告成了?错!
说不定你什么时候手一贱改了什么东西:报错!删掉了什么东西:报错!改了下主题:报错报错报错!!!
所以千万要记得:备份备份备份!!!

我们选择将仓库备份到GitHub上,既能起到备份的作用,又方便以后修改后同步备份。

  1. 在 GitHub 创建 blog-generator 空仓库


    blog-generator 空仓库
  2. 按照截图中的命令执行

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