mac下基于Hexo-Github的Blog搭建

安装:

一、安装Homebrew

Mac上已经安装了ruby环境,只需要输入

ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

二、安装node.js

sudo brew install node

三、安装Hexo

Hexo是基于node.js的博客系统,这里安装就可以了。

sudo npm install -g hexo 
npm install hexo-renderer-ejs --save
npm install hexo-renderer-stylus --save
npm install hexo-renderer-marked --save

安装完成后,找一个放blog的目录

cd ~/Blog

然后执行初始化

hexo init

然后可以直接预览hello word.md

hexo g
hexo s
=> [info] Hexo is running at localhost:4000/. Press Ctrl+C to stop.

g是generate, s是server,还有d是deploy(部署)推荐用首字母,方便快捷。

四、创建Blog Repository

在自己的Github,点击New repository创建Blog的仓库,记住勾选README。

这里有特别需要注意的地方:如果你想要能通过 username.github.io的方式访问你的博客主页,仓库名必须为 username.github.io,username为你的用户名。你也可以用其他方式命名你的blog仓库,比如就叫blog,但是这样在访问的时候,域名就是username.github.io/blog (blog为仓库名)。所以还是推荐使用第一种方式命名,github推荐的也是这种方式。

repository1
repository2

创建完毕。点击仓库右上角的Settings标签,进入设置页,检查GitHub Pages这一项。如果你的仓库命名是推荐方式,则会像下图一样,Source一栏是灰色的。否则会有两个分支选择:master branch、gh-pages branch,hexo默认会使用gh-pages branch,所以如果你这里是master branch,会出现blog主页没有内容的问题。

github pages

五、安装hexo的git插件

npm install hexo-deployer-git --save

六、建立映射关联

进入你的Blog目录,修改_config.yml文件,配置一些东西。

# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
      type: git
      branch: gh-pages  ## branch这一行默认不写,如果你需要特别指定,可以在这里加上
      repository: https://github.com/aoshiwenrou/aoshiwenrou.github.io.git

这里repository的地址可以是https的,也可以是git的,只不过git需要SSH证书,一般用https就可以了,如果出现443错误,替换成git。

然后在Blog目录下

hexo g -d

生成静态文件并且部署出去,不出意外,已经可以外网访问了。

这个命令这里说一下:

hexo g :部署到github,也就是你有什么修改,用这个命令提交到服务器

hexo s :打开hexo本地服务,此时可以在本地进行预览

hexo d :发布

一般可以组合使用hexo g -d,部署并发布,或者hexo s -d。不过一般还是推荐先g,然后s,进行本地预览,没有问题再进行d

写文章

在Blog目录下,创建

hexo new 文章题目

然后用Markdown编写,写好后save。

hexo g
hexo s

生成,然后在本地localhost:4000预览一下,如果没有问题,就可以发布了。

hexo d

所有的文章都是放在Blog/source/_posts/目录下的,可以随时编辑修改。

小技巧:hexo new 的时候,推荐使用英文名,例如我这篇文章就叫build blog site with hexo and github in maxOS(英文很水,轻点吐槽),这样你的文章链接就不会出现一堆中文转义。然后在你文章的顶部进行配置,设置title为中文(默认会有这两行,并且title为文件名,我这里默认就是build blog site with hexo and github in maxOS),这样在你的blog列表中,显示的就是你的中文title,就像你现在在文章中看到的,我的标题就是mac下基于Hexo-Github的Blog搭建

title: mac下基于Hexo-Github的Blog搭建
date: 2017-05-16 10:16:18

优化

一、访问速度

由于Google被墙,大部分主题中引用的jquery都会因为超时(可以Blog目录下搜索google),而造成页面访问很慢,这里需要将jquery改为百度的

<script src="//apps.bdimg.com/libs/jquery/2.0.3/jquery.min.js"></script>

二、RSS订阅

输入命令

$ npm install hexo-generator-feed --save

然后在_config.yml中,添加

rss: /atom.xml
feed:
     type: atom
     path: atom.xml
     limit: 20

三、搜索支持

现在在百度和Google是搜不到你的网站的,为了让搜索引擎搜索到,需要做一些工作。

搜索引擎入口

添加sitemap.xml:

首先输入:

npm install hexo-generator-sitemap --save
npm install hexo-generator-baidu-sitemap --save    
npm install hexo-baidu-url-submit --save

前两个插件用于生成sitemap,后一个插件用于主动推送链接到百度(防止百度爬虫抓取失败,导致百度搜不到您的博客,这里有一篇关于百度无法爬取Github Pages静态网站解决方案)。

然后在_config.yml文件中添加

sitemap:
         path: sitemap.xml
baidusitemap:
         path: baidusitemap.xml

## BaiduUrlSubmit: http://hui-wang.info/2016/10/23/Hexo插件之百度主动提交链接/    
baidu_url_submit:        ##主动推送新文章到百度
  count: 3 ## 比如3,代表提交最新的三个链接
  host: blog.darkangel7.com ## 在百度站长平台中注册的域名
  token: your_token ## 请注意这是您的秘钥, 请不要发布在公众仓库里!
  path: baidu_urls.txt ## 文本文档的地址, 新链接会保存在此文本文档里

##同时要检查这里有没有URL值,必须包含是百度站长平台注册的域名,比如 
# URL
url: http://blog.darkangel7.com
root: /
permalink: :year/:month/:day/:title/

##最后,加入新的deployer,如
deploy:
- type: git
  repository: git@github.com:DarkAngel7/Blog-Hexo.git
- type: baidu_url_submitter  ## 百度链接主动推送

先验证网站所有权,下载html,mv到Blog/themes/yourtheme/source目录下,执行

hexo g -d

验证成功后,添加百度自动推送脚本,最好在head.ejs中添加百度自动推送的代码,至于head.ejs文件位置,在你使用的theme文件夹下搜索吧。
谷歌的话,在抓取-站点地图里面添加就好。

这样主动推送与自动推送结合,能很好的提高您文章的曝光率。

四、评论功能

可以使用多说来提供评论功能。首先,在_config.yml文件中添加

# Duoshuo
duoshuo_shortname: yoursite.doushuo.com

然后,搜索themes文件夹下,你使用的theme文件目录下的commemt.ejs(不同的theme可能位置不同,请自行寻找)。修改如下:

 <div id="comment" class="comments-area">
     <% if(config.duoshuo_shortname) { %>
     <! -- 多说的代码 --> 
     <% } %> 
</div>    

 如果报关于data-thread-key的错误,则改成下面这样:
 <div class="ds-thread" data-thread-key="<%= page.path %>" data-title="<%= page.title %>" data-url="<%= page.permalink %>"></div    >

五、分享功能

可以在Blog目录下搜索post/share,一般在article.ejs文件中,或者post.ejs文件中,然后替换

<%- partial('post/author') %>

百度分享提供的代码。

六、个人信息完善

网站的信息一般都在Blog/_config.yml中修改。

关于Theme,去官方提供的主题列表中选个现成的,按照里面的方法pull下来,如light主题

$ git clone git://github.com/tommy351/hexo-theme-light.git themes/light

然后在_config.yml配置文件中设置:

theme: light

关于主题的优化,一般在themes/yourtheme/_config.yml中配置。

写在最后

本文参考<a href="http://blog.darkangel7.com/2016/08/19/Hexo+Github的Blog搭建/">Dark Angel的博客</a>,他的文章还提到了付费购买域名,及域名与github绑定的内容,有需要的可以参考

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

推荐阅读更多精彩内容