Hexo博客搭建指南

最近熟悉的各路大神都纷纷从 Ghost 迁移为 Hexo。 好奇之下,在简单对比过后也选择了Hexo,主要是基于以下的两点考虑

  1. Hexo 直接使用 Markdown 文件在命令行生成博客、命令行进行部署; 更简洁方便
  2. Hexo 原生支持中文; 当然 Ghost 的话也可以使用 Ghost中文网

本文只适用于 macOS; 其他平台仅供参考

Hexo 安装

安装 NodeJs

首先,由于 Hexo 依赖于 NodeJs,所以需要先安装 Node,如果已经安装直接跳过。

使用安装包安装

  1. 前往 https://nodejs.org/en/
  2. 下载 LTS 版本安装包(目前是 v6.11.3 LTS)
  3. 完成后、直接打开App点击安装就好

使用brew安装

打开终端执行以下命令

# 安装 brew
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

# 安装 nodejs
brew install nodejs

完成安装后,打开终端执行 npm --versionnode --version 没报错证明 NodeJs 已成功安装

安装 Hexo

NodeJs安装完成后,执行以下步骤安装 Hexo 并创建一个博客工程。

# 安装 hexo 
npm install hexo-cli -g

# 初始化博客工程
cd ~/Desktop
hexo init blog

# 安装npm模块、
cd blog
npm install

# 启动博客网站
hexo server

执行完最后一步,并输出以下内容。就代表一个完整Hexo博客搭建就大功告成了!打开 http://localhost:4000/ 体验下劳动成果吧!

JianBoPro:blog JianBo$ hexo server
INFO  Start processing
INFO  Hexo is running at http://localhost:4000/. Press Ctrl+C to stop.

原文参考: https://hexo.io/zh-cn/

新建文章

如文章开头提到的,Hexo 使用终端命令进行操作,新建一条博客的也是如下:

# 仍然先进入到博客目录
cd blog

# 新建一条名为 hello 的博客
hexo new hello

# 再次启动博客网站
hexo server

原文参考: https://hexo.io/zh-cn/docs/writing.html

更改主题

Hexo 官方本身提供大量的主题供大家使用,而且很大一部分都支持中文。前往官方主题市场

本文以当前博客使用的主题 confidante 为例:

# 先找到主题的源码地址
# 在签出主题代码到 博客的 themes 路径
git clone https://github.com/JakeLaoyu/hexo-theme-confidante themes/confidante

# 切换主题
#  修改根目录下 _config.yml 文件
theme: confidante

# 再次启动博客网站
hexo server

以上命令执行完成后,浏览器打开 http://localhost:4000 就可以看到新的主题效果了

ps: 如需修改主题里的其他内容,可以看看 themes/confidante/_config.yml 文件里面配置

到目前为止,Hexo的安装使用基本都完成了

部署

接下来是Hexo的部署,在本地博客搭建后,需要把生成的静态页面部署到公网服务器,才能供其他人访问到你的博客。而一般大家常用到有俩种的方式

  1. 部署至Github。优点是免费,缺点是域名为 xxx.github.io
  2. 用 Nginx 部署在私有服务器上。缺点是需要自己购买服务器、域名等

部署至Github

  1. 建一个名为 username.github.io 的仓, 如下图所示:
create-repos.png
  1. 开启 Github Pages 进入到代码仓主页、点击 Setting 进入到设置页面,下拉滚动到 Github Pages 设置的地方、点击 Choose a theme
enable-github-pages-1.png

跳转页面后,然后直接点击 Select theme 完成选择主题选择。然后会跳转另一个页面,直接拉到底部点击 Commit 完成代码仓的首次提交。
完成后再次进入 Setting 页面、看到 Your site is ready to be published at https://hjianbo.github.io/. 证明 Github Pages 功能已成功开启。

enable-github-pages-2.png
  1. 配置 Github SSH免密提交代码

  2. 配置部署
    先在本地工程中安装 Github 部署用的支持工具

# 工程目录下执行
npm install hexo-deployer-git --save

然后打开 _config.yml,将文件尾部的 deploy 部署部分改为:

deploy:
  type: git
  repository: git@github.com:{youname}/{youname}.github.io.git
  branch: master

编辑完成,保存。在工程目录下中执行 hexo d -g 进行发布部署。

等待文件上传至Github成功,部署就全部完成了!! 尝试在浏览器中打开前面 步骤2 中给你的地址看看博客的效果吧!!

部署至私有服务器

  1. 首先我们得有自己的一台 Linux 服务器。推荐: Vultr
  2. 配置服务器的免密SSH登录
  3. 在服务器端安装 Nginx。并建立博客路径
  4. 在服务器端安装 rsync
  5. 本地配置部署方式

安装 hexo-deployer-rsync

npm install hexo-deployer-rsync --save

修改本地 _config.yml 配置

deploy:
   type: rsync
   host: hjianbo.me
   user: root
   root: /var/www/blog
  1. 工程中执行 hexo d -g

常见问题

Q: 怎么显示图片?
A: http://www.jianshu.com/p/c2ba9533088a

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

推荐阅读更多精彩内容