Hexo+github搭建个人博客

环境准备

软件:git,node.js,hexo,markdown
下载并安装git,node.js,markdown,过程略。

常见问题

1、markdown安装完成后,如果使用过程出现如下异常,

An error occurred with the Html rendering component...

原因:MarkdownPad 2 在win10下 出现HTML 渲染错误(This view has crashed) 的问题.

解决办法:安装一个SDK的工具包,名叫:awesomium_v1.6.6_sdk_win

下载地址:awesomium

网络问题下载不了,则百度其他地址。

2、node.js在安装完成后,要设置下环境变量。

3、如果在cmd中执行命令出现异常,而异常信息又不够明确,可以尝试使用git bash来执行命令,比如hexo d命令在cmd中,会由于ssh key的问题抛异常,而在git bash中就会有明显提示。

安装hexo

开始安装hexo,在cmd中,利用 npm 命令即可安装。

> npm install -g hexo

搭建本地blog

提示安装完成后,开始创建个人blog目录。
(从这里开始,建议使用git bash执行命令)
创建blog目录

> mkdir blog && cd blog

然后执行

> hexo init

安装依赖包

> npm install

至此,本地blog基本文件准备完成,此时执行

> hexo g

生成静态页面,然后启动服务

> hexo server -p 5000

此处单独指定了端口号,因为hexo默认使用4000端口,有可能会和foxmail等其他服务端口有冲突。

启动成功后,会提示打开一个地址http://localhost:5000,如果页面显示正常,那么本地blog搭建完成。

部署blog到github

github提供了github.io功能,能够帮助我们展示静态的website。

操作步骤如下

1、操作前提:在github上注册账号、以github账号名创建一个仓库。

2、点击进入刚刚创建的仓库,点击settings进入管理页面。
3、找到GitHub Pages区域,选个一个主题,完成后点击页面提供的连接,就可以看到自己的blog页面,https://xxx.github.io
4、回到仓库页面,复制仓库地址ssh或者http方式按自己习惯
5、打开本地blog目录,编辑_config.yml文件
6、找到deploy配置项,修改如下,注意冒号后面有一个空格

  1. deploy:

  2. type: git

  3. repository: 复制的仓库地址

  4. branch: master

7、接下来,回到你的cmd/git bash窗口,只需执行三个命令,命令不包含括号内信息: 

  1. > npm install hexo-deployer-git --save (这命令是为了解决hexo新版本的部署问题)

  2. > hexo g 回车 (这是重新生成blog)

  3. > hexo d 回车 (这是将本地blog部署到github的仓库)

8、再次访问“xxx.github.io”,此时,你应该能看到hexo的欢迎页面。

配置主题

1、打开主题地址
2、列表的右侧demo连接,是效果图,左侧连接为主题的git仓库
3、选择一个喜欢的主题后,进入它的git仓库,将其clone到本地blog目录的themes目录下,执行如下命令

  1. > git clone 主题仓库地址 themes/自定义目录名

下载完成后,得到的目录比如为: /themes/mythemes 

4、编辑_config.yml文件,找到themes配置项,修改为

theme: mythemes

5、重新编译blog并上传到git:

  1. hexo -g

  2. hexo -d

执行完下面命令后,刷新xxx.github.io,可能有延迟。

编写与发布blog

在blog目录的/source/_posts/,就是用于发表的博文目录。
使用markdown创建好博文后,复制到该目录下,在执行上一节的第5步,就可以将博文上传到github上。

至此,个人blog搭建完成。建议备份本地blog目录,防止源文件丢失。



参考:

http://www.cnblogs.com/dantefung/p/d8c48ba8030bcab7cfc364d423186fee.html

https://hexo.io/docs/server.html

http://ibruce.info/2013/11/26/markdown/

https://blog.csdn.net/geekqian/article/details/78342581

https://blog.csdn.net/weixin_40426638/article/details/80336881

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

推荐阅读更多精彩内容