觉得单身博客的治本太费力,就像是大家又总是向往越发简明随意的作文方法

图片 1


前言

习惯本人写Blog的仇敌一定不会不熟悉Wordpress,或者也曾在今日头条博客和QQ空间留过脚印,但静心认真思考一下,如同大家又总是向往尤其简明随意的写作方法。GitHub给大家提供了二个无限的上空,大家须求侧重使用,而Hexo的产出从某种意义上来说代替了Jekyll,让大家可以更注意于创作本身。本文主要介绍本身的施行心得并不断完善内容,衍生知识和公理推荐我们认真读书官网的手册,此外推荐参考故事情节链接在文中也会标明出来。

阮一峰 –
喜欢写Blog的人,会经历五个阶段

先是阶段,刚接触Blog,觉得很特殊,试着选拔多少个免费空间来写。
其次等级,发现免费空间限制太多,就协调购买域名和空间,搭建独立博客。
其三阶段,觉得单身博客的军事管制太劳顿,最幸好保留控制权的前提下,让外人来管,自身只承担写小说。


前言

习惯自身写Blog的对象一定不会目生Wordpress,或然也曾在新浪博客和QQ空间留过脚印,但静心认真考虑一下,就好像大家又接连向往尤其简便易行随意的写作方法。GitHub给我们提供了二个极其的上空,大家要求侧重使用,而Hexo的面世从某种意义上来说代替了Jekyll,让大家可以更注意于创作本人。

欣赏写Blog的人,会经历八个等级。
首先阶段,刚接触Blog,觉得很奇异,试着选拔一个免费空间来写。
其次品级,发现免费空间范围太多,就和好购买域名和空中,搭建独立博客。
其三等级,觉得单身博客的治本太费事,最幸好保存控制权的前提下,让旁人来管,自个儿只担负写文章。

半数以上Blog作者,都停留在率先和第壹阶段,因为第2阶段不太容易抵达:你很难找到俯首遵循、愿意为你管理服务器的人。

唯独六年前,情状出现变化,一些程序员开端在GitHub网站上搭建blog。他们既有着相对管理权,又享受GitHub带来的造福—-不管曾几何时哪儿,只要向长机提交commit,就能发表新作品。更妙的是,这一体依然免费的,GitHub提供极致流量,世界各州都有拔尖的访问速度。

今天,我就来演示怎么在GitHub上搭建Blog,你可以从中通晓GitHub的Pages功效,以及Hexo软件的基本用法。更关键的是,你会体会到一种建立网站的全新思路。


创新历史

二〇一六年0五月二日 – 更新Windows下Hexo
3.0安装和升级换代,谢谢@机智的阿卡林酱
2015年03月10日 – 增加Hexo 3.0降级 2.8
二〇一五年10月17日 – 完善内容
2016年一月0十三日 – 更新Hexo配置修改部分
二〇一六年03月10日 – 更新任何基础架构,待完善配置修改部分
二零一四年0二月1十一日 – 更新部分Hexo建站进度,待完善
二〇一六年0十一月1二十四日 – 撰写初稿

读书原文 –
http://wsgzao.github.io/post/hexo-guide/

增加阅读


概要

准备工作

注意 本文主要针对Windows平台和Hexo 3.x

GitHub Pages 是什么?

若是你对编程有所驾驭,就决然听说过GitHub。它称为程序员的Facebook,有着极高的人气,许多器重的品类都托管在上边。
粗略说,它是二个拥有版本管理效果的代码仓库,各种门类都有一个主页,列出档次的源文件。

而是对于三个新手来说,看到一大堆源码,只会令人头晕脑涨,不知哪里入手。他期望看到的是,1个简明易懂的网页,表明每一步应该咋办。由此,GitHub就设计了Pages功能,允许用户自定义项目首页,用来顶替暗中认同的源码列表。

由此,GitHub Pages可以被认为是用户编写的、托管在GitHub
上的静态网页。

GitHub
提供模板,允许站内生成网页,但也允许用户本身编写网页,然后上传。有意思的是,那种上传并不是单独的上传,而是会透过Hexo或Jekyll等主次的再处理。

了解Hexo

A fast, simple & powerful blog framework

Hexo 是二个便捷、简洁且高效的博客框架。Hexo 使用
马克down(或任何渲染引擎)解析小说,在几秒内,即可使用靓丽的主旨生成静态网页。
hexo.io

什么是Hexo?

Hexo
是2个高速、简洁且很快的按照Node.js的博客框架。Hexo 使用
马克down(或其余渲染引擎)解析小说,在几秒内,即可使用靓丽的主题生成静态网页。作者是出自黑龙江的@tommy351

A fast, simple & powerful blog framework, powered by Node.js.

好像于jekyll、Octopress、Wordpress,大家可以用Hexo创建和谐的博客,托管到github、Heroku或Coding上,绑定本人的域名,用markdown写作品。本博客即接纳hexo创立并托管在github上。

安装GIT

GitHub Windows

一言以蔽之可依靠,安装达成后基于指示操作即可,So Easy

何以要用hexo

不可捉摸的急忙 ─ 只要一眨眼静态文件即生成达成
支持 Markdown
仅需一并指令即可安插到 GitHub Pages 和 Heroku
已移植 Octopress 插件
高增添性、自订性
兼容于 Windows, Mac & Linux

  • 易用。不仅布署简单,经常应用中仅需求hexo new hexo generate
    hexo server
    hexo deploy八个指令。不像Jekyll需求过多繁琐的git命令。
  • 轻。文件少、小,易掌握,方便自定义。
  • 用户多。纵然赶不上Jekyll和Octopress,但境遇什么难题都能寻找到答案,只怕找到同样应用hexo的用户展开参考和咨询。

安装Node.JS

Node.JS

注意 安装落成后添加Path环境变量,使npm命令生效

;C:\Program Files\nodejs\node_modules\npm

什么人能利用hexo

那是3个免费开源的博客程序,任何人都可以利用和修改。然则分裂于wordpress,hexo由于要求采取Github,Git,Markdown,Node.js这么的工具,好多插件、widget都急需本人设置、设置。所以适合这一个有肯定总计机基础,喜欢折腾的人。然而,不要害怕,只要跟着本教程走,就能很便宜地让本人的博客”飞起来”。

安装Hexo

配置好GitHub家目录后,双击桌面上的Git Shell,输入npm指令即可安装

npm install -g hexo-cli
npm install hexo --save

http://hexo.io/zh-cn/docs/


怎么样搭建hexo博客

宗旨来了,请认真往下看呢。


Hexo起初化配置

预备工作

注意正文首要针对Windows平台和Hexo 3.x

创建Hexo文件夹

设置到位后,依照本身喜好建立目录(如E:\kuaipan\GitHub\hexo),进入Git Shell切换来该路径下E:\kuaipan\GitHub\hexo履行以下指令

hexo init

安装GIT

下载 Git
并施行即可成功安装。
So Easy

安装Hexo插件

npm install hexo-generator-index --save
npm install hexo-generator-archive --save
npm install hexo-generator-category --save
npm install hexo-generator-tag --save
npm install hexo-server --save
npm install hexo-deployer-git --save
npm install hexo-deployer-heroku --save
npm install hexo-deployer-rsync --save
npm install hexo-deployer-openshift --save
npm install hexo-renderer-marked@0.2 --save
npm install hexo-renderer-stylus@0.2 --save
npm install hexo-generator-feed@1 --save
npm install hexo-generator-sitemap@1 --save

安装Node.JS

在 Windows
环境下安装Node.js十分简单,仅须下载Node.JS并执行即可成功安装。
So Easy

当地查看效果

继续执行以下命令,成功后可登录localhost:4000翻看效果

hexo server

安装Hexo

在随心所欲地点右键,选取Git Bash Here

npm install hexo-cli -g
#如果命令无法运行,可以尝试更换taobao的npm源
npm install -g cnpm --registry=https://registry.npm.taobao.org

Hexo简写命令

hexo n #new
hexo g #generate
hexo s #server

Hexo伊始化配置

配置静态网页到GitHub

创建hexo文件夹

设置到位后,依据本人喜好建立目录(如D:\hexo),在该文件夹下右键–Git
Bash Here。执行以下命令

hexo init

注册安装GitHub

  1. 登录GitHub,注册自定义用户名如wsgzao
  2. 在主页右下角创设New repository,name必须和用户名相同如wsgzao.github.io
  3. 首回创造耐心等待10分钟左右审结,之后即可访问静态主页如http://wsgzao.github.io

设置注重包

npm install

该命令会将hexo所需文件自动下载到hexo文件夹下。

#新建完成后,指定文件夹的目录如下
.
├── _config.yml
├── package.json
├── scaffolds
├── scripts
├── source
|      ├── _drafts
|      └── _posts
└── themes

3头内容至GitHub

  1. 下载GitHub
    Windows
  2. 设置Local pathE:\快盘\GitHub\
  3. 运行Git Shell切换成如E:\快盘\GitHub\hexo路径下
  4. 执行hexo g指令生成public文件夹
  5. 把转变的内容全方位拷贝到Local path或其子目录
  6. 运行GitHub认可修改消息后执行右上角的Sync同步
  7. 末段访问主页观望效果

https://pages.github.com/


安装Hexo插件(可选)

npm install hexo-generator-feed --save
npm install hexo-generator-sitemap --save
npm install hexo-generator-baidu-sitemap --save
npm install hexo-generator-json-content --save
npm install hexo-deployer-git --save
npm install hexo-generator-index --save
npm install hexo-generator-archive --save
npm install hexo-generator-category --save
npm install hexo-generator-tag --save
npm install hexo-server --save
npm install hexo-deployer-heroku --save
npm install hexo-deployer-rsync --save
npm install hexo-deployer-openshift --save

域名和DNS

翻开本地运维效果

将来大家曾经搭建起当地的Hexo博客了,继续执行以下命令(在D:\Hexo),成功后即可登录localhost:4000翻开效果,运转突显了相关页面,表达当前网站已经在该地建立。

hexo generate
hexo server

好了,至此,本地博客已经搭建起来了,只是当地哦,别人看不到的。下边,我们要配备到Github。


域名推荐

GoDaddy makes registering Domain Names fast, simple, and affordable.

【推荐理由】八个字“可靠”,协理支付宝,附打折码链接

http://www.godaddy.com/
http://www.gdcodecoupon.com/

配置GitHub

DNS推荐

致力于为您提供最安定、最安全的域名解析服务
【推荐理由】依然是多个字“可相信”,多谢她们径直以来对此公益的硬挺

https://www.dnspod.cn/

注册Github账号

已有账号可以跳过,没有的,请登录GitHub开展注册,很简短,那里就不介绍了。

设置CNAME

  1. 在Github的网站目录下创办CNAME文件
  2. 填写自个儿的域名如hellodog.com,保存甘休
  3. 登录DNSPod,先添加域名,然后添加记录,设置如下
主机记录 记录类型 线路类型 记录值 MX优先级 TTL
@ CNAME 默认 wsgzao.github.io. 10
www CNAME 默认 wsgzao.github.io. 10

创建repository

在大团结Github主页右下角,创制New repository
比如作者的Github账号是vioren,那么本人应该创立的repository名字应该是vioren.github.io
首次创设耐心等待10秒钟左右查处,之后即可访问静态主页如http://vioren.github.io

Hexo配置修改

报告本人怎么要挑选Hexo

布局地署

编辑_config.yml(在D:\hexo下)。你在配置时,要把上面的vioren都换到你的账号名。

deploy: 
  type: git
  repository: https://github.com/vioren/vioren.github.io.git
  branch: master

注意:type:空格git。都要利用空格,否则会出错。

文化储备

1.勤学勤练马克down

当地+云端备份数据是一种习惯

2.用到性感的公文编辑器

工欲善其事必先利其器

  • Notepad2
  • Sublime Text

http://wsgzao.github.io/post/windows/\#文本编辑器

布署本机的ssh key

因而ssh keys就足以将地面的花色与Github关联起来

Hexo主题

分选宗旨指出根据KISS原则

自笔者批评本机ssh key

cd ~/.ssh

提示:没动用过Git就会显得:No such file or directory

科普难题

1.改动配置文件时只顾YAML语法,参数冒号:后肯定要留空格
2.普通话乱码请修改文件编码格式为UTF-8

扭转新的ssh keys

$ ssh-keygen -t rsa -C "邮件地址@youremail.com"
Generating public/private rsa key pair.
Enter file in which to save the key (/Users/your_user_directory/.ssh/id_rsa):<回车>

注意:-C为题写的C接下来会让您输入密码

Enter passphrase (empty for no passphrase):<输入加密串>
Enter same passphrase again:<再次输入加密串>

小心:输入密码时是不会彰显密码的,依次输入就好了一旦显示为下界面,就印证设置ssh
key成功了

什么样迁移至Hexo

http://hexo.io/zh-cn/docs/migration.html

添加ssh key到Github

  1. 找寻本机上的id_rsa.pub文件。或在C:\Users\用户名\.ssh路线下找到该公文,以记事本打开,复制其中的内容。
  2. 跻身自身的Github,右上角齿轮setting—右边列表SSH keys—Add SSH
    key。将内容复制到文本框(不用取title名字)。
    在意:那时Github会给您的邮箱发送一封邮件,打开邮件确认下就好了。

Hexo 2.X 升级 3.0

1.搞好相关配置文件和作品的备份
2.做此外改动前不要遗忘第3、件事备份

https://github.com/hexojs/hexo/wiki/Migrating-from-2.x-to-3.0

测试通讯

ssh -T git@github.com

如若是以下反馈

The authenticity of host 'github.com (207.97.227.239)' can't be established.
RSA key fingerprint is 16:27:ac:a5:76:28:2d:36:63:1b:56:4d:eb:df:a6:48.
Are you sure you want to continue connecting (yes/no)?

输入yes

Hi yourusername! You've successfully authenticated, but GitHub does not provide shell access.

那时候表达能够由此SSH链接到你的Github了,接下去完善一下您的个人音信。Git会依照用户的名字和信箱来记录提交。
GitHub也是用那些音信来做权限的拍卖,输入下边的代码举行个人消息的安装,把称呼和信箱替换到你协调的,名字务必是您的全名,而不是GitHub的昵称。

git config --global user.name "Tim" #用户名
git config --global user.email "tim@gmail.com" #填写自己的邮箱

Hexo 3.0 降级 2.X

http://sandylaw.tk/2015/03/07/hexo3to2/

运用Hexo克隆主旨

温馨使用的是Yilia大旨,比较欣赏,以这款大旨为例。

推荐阅读

克隆大旨

git clone https://github.com/litten/hexo-theme-yilia.git themes/yilia

配置

修改hexo根目录下的_config.yml

theme: yilia

更新

cd themes/yilia
git pull

当地查看

hexo g
hexo s

浏览器输入localhost:4000,查看核心是或不是中标。

布置上传

hexo clean
hexo g
hexo d

会让您输入用户名和密码,依次输入就好。

部分Hexo主题推荐

选料主题指出依据KISS原则

Hexo Themes
http://hexo.io/themes/
Themes · hexojs/hexo Wiki –
https://github.com/hexojs/hexo/wiki/Themes

Yilia
http://litten.github.io/2014/08/31/hexo-theme-yilia/
Jacman
http://wsgzao.github.io/post/hexo-jacman/
NexT –
http://theme-next.iissnan.com/


绑定域名和DNS设置

设置CNAME

  • 开辟Github–空间Repository的根目录下–点击“+”creat a new
    file–命名为CNAME,文本框中输入自身必要绑定的域名如vioren.space
  • 点击右下角的【Download
    ZIP】,下载项目,解压压缩包,将中间的CNAME文件复制到hexo根目录下。

hexo g
hexo d

DNS设置

登记登录DNSPod,先添加域名,然后添加记录,设置如下

主机记录 记录类型 线路类型 记录值 MX优先级 TTL
@ CNAME 默认 vioren.github.io. 10
www CNAME 默认 vioren.github.io. 10

域名推荐

GoDaddy makes registering Domain Names fast, simple, and affordable.
【推荐理由】五个字“可信”,支持支付宝,附促销码链接
http://www.godaddy.com
http://www.gdcodecoupon.com

万网
【推荐理由】被阿里收入麾下,实力和价格都毋庸置疑
https://wanwang.aliyun.com

DNS推荐

从事于为你提供最安静、最安全的域名解析服务
【推荐理由】照旧是五个字“可信赖”,被腾讯收益麾下将来扔不忘初心,多谢他们平昔以来对此公益的愚公移山
https://www.dnspod.cn


开班写小说

hexo new "postName"

或路径D:\hexo\source\_posts下新建文件postName.md就可以了
文章内容和格式如下:

---
title: 标题
date: YYYY-MM-DD hh:mm:ss
tags: 标签                    #多标签时以[tag1,tag2]格式填写
categories: 类别              #多类别时以[category1,category2]格式填写
---
主页可显摘要
<!-- more -->                #阅读全文分隔符
展开余下全文

正文内容使用马克down语法进钟鼓文写

图床推荐

七牛云
【推荐理由】连串健全,操作便捷易懂
测试用户每月1G流量,实名后每月10G,小站够用。
亟待留意的是未备案网站不大概运用CDN,存在盗图和恶心刷流量的恐怕,而且七牛是先接纳后付费,自身精晓吧。
http://www.qiniu.com

Simple Free Image Hosting
【推荐理由】免费,强大,无界定,用了都说好
缺点:后期不能对上传的图片进行管制
https://sm.ms
说明:https://www.v2ex.com/t/182703


任何相关

周边难点

  1. 修改配置文件时注意YAML语法,参数冒号:后自然要留空格
  2. 粤语乱码请修改文件编码格式为UTF-8

Error代码:「warning: LF will be replaced by CRLF」
hexo deploy时,有时会冒出那几个提醒音信warning: LF will be replaced by CRLF,纵然看起来挺乱糟糟的,但不影响使用,可以忽略不计。若想不提醒,可以应用如下方法:

  1. 切换来博客的根目录,执行如下命令:git config --global core.autocrlf false
  1. 去除掉该目录下的.git文件夹(大概是潜伏的),命令:rm -rf .git
  2. 重新git init

再deploy试试啊,清新脱俗了。

Error代码:hexo deploy 没反应
不少网友遭受过那一个难点,如今来看,紧要难点出在config.ymldeploy布署上。注意缩进,同时注意冒号后边要有多少个空格。
Error代码:hexo update -g 升级错误,hexo命令失效
本人升级时遇上了那些难题,原因不详。那种情况下,可举行npm install hexo-cli -g重新安装五遍Hexo,效果跟升级一样。
Error代码:hexo指令无法履行
莫不是提拔方法不对,导致hexo
generate指令也无力回天履行,后来索性重装了git和node,重新安装hexo,generate和server指令都能执行了,不过现身了“Deployer
not found: github”。
Error代码:Deployer not found: git
更改_config.yml主配置文件为utf-8编码时造成的老大。
执行npm install hexo-deployer-git --save下一场再一次deploy即可。

各版本所做立异修正,请参见这里

怎么着迁移至Hexo

http://hexo.io/zh-cn/docs/migration.html

Hexo命令

hexo init <folder> #初始化一个网站目录 我是直接cd到目标目录执行hexo init的
hexo new "postName" #新建文章,或者source\_posts手动编辑
hexo new page "pageName" #新建页面 默认链接为:主页地址/pageName/
hexo clean #清除缓存文件db.json和已生成的静态文件public
hexo generate #生成public静态文件至public目录
hexo server #本地发布预览效果 http://localhost:4000 ('ctrl + c'关闭server)
hexo deploy #将.deploy目录部署到GitHub
hexo --debug #在终端中显示调试信息并记录到 `debug.log`
hexo help #查看帮助
hexo version #查看Hexo的版本

Hexo简写命令

hexo n "postName" #新建文章,或者source\_posts手动编辑
hexo g #生成public静态文件至public目录
hexo s #本地发布预览效果 http://localhost:4000 ('ctrl + c'关闭server)
hexo d #将.deploy目录部署到GitHub

Hexo复合命令

hexo d -g #生成并部署上传
hexo s -g #生成并本地发布预览
hexo clean && hexo d -g #清空缓存然后生成并部署上传
hexo clean && hexo s -g #清空缓存然后生成并本地发布预览

本文部分表达来源网络
尤其感激 @wsgzao
@阮一峰
@TimFei
@Litten
@陈素封
@zippera
@不如

相关文章