手把手教你用Hexo+Github 搭建属于本身的博客

时间 2019-12-06

标签手把手 hexo+github hexo github 搭建属于本身博客栏目 Git 繁體版

原文原文链接

Android 技术人，但愿让你看到程序猿不一样的一面，除了分享 Coding，，还有职场心得，面试经验，学习心得，人生感悟等等。但愿经过该公众号，咱们不仅会敲代码，咱们还会。。。。。。javascript

闲聊

在大三的时候，一直就想搭建属于本身的一个博客，但因为各类缘由，最终都不了了之，刚好最近比较有空，因而就本身参照网上的教程，搭建了属于本身的博客。html

至于为何要搭建本身的博客了？java

哈哈，大概是为了装逼吧，同时本身搭建博客的话，样式的选择也比较自由，能够本身选择，不须要受限于各大平台。node

转载请注明原博客地址：手把手教你用Hexo+Github 搭建属于本身的博客git

大概能够分为如下几个步骤github

搭建环境准备（包括node.js和git环境，gitHub帐户的配置）
安装Hexo
配置Hexo
怎样将Hexo与github page 联系起来
怎样发布文章
主题推荐
主题Net的简单配置
添加sitemap和feed插件
添加404 公益页面

搭建环境准备

大概能够分为如下三步面试

Node.js 的安装和准备
git的安装和准备
gitHub帐户的配置

配置Node.js环境

下载Node.js安装文件：

根据本身的Windows版本选择相应的安装文件，要是不知道，就安装32-bit的吧- -。如图所示：chrome

保持默认设置便可，一路Next，安装很快就结束了。而后咱们检查一下是否是要求的组件都安装好了，同时按下Win和R，打开运行窗口：npm

Windows的运行界面浏览器

在新打开的窗口中输入cmd，敲击回车，打开命令行界面。（下文将直接用打开命令行来表示以上操做，记住哦~）在打开的命令行界面中，输入

node -v
npm -v
复制代码

若是结果以下图所示，则说明安装正确，能够进行下一步了，若是不正确，则须要回头检查本身的安装过程。

配置Git环境

下载Git安装文件：

GIt官网下载地址：

Git-2.6.3-64-bit.exe

而后就进入了Git的安装界面，如图：

Git安装界面

和Node.js同样，大部分设置都只须要保持默认，可是出于咱们操做方便考虑，建议PATH选项按照下图选择：

Git PATH设置

这是对上图的解释，不须要了解请直接跳过 Git的默认设置下，出于安全考虑，只有在Git Bash中才能进行Git的相关操做。按照上图进行的选择，将会使得Git安装程序在系统PATH中加入Git的相关路径，使得你能够在CMD界面下调用Git，不用打开Git Bash了。同样的，咱们来检查一下Git是否是安装正确了，打开命令行，输入：

git --version
复制代码

若是结果以下图所示，则说明安装正确，能够进行下一步了，若是不正确，则须要回头检查本身的安装过程。

关于 git的下载即安装，能够参考个人这一篇博客： Git下载及配置环境变量

github帐户的注册和配置

若是已经拥有帐号，请跳过此步~

第一步: Github注册

打开https://github.com/，在下图的框中，分别输入本身的用户名，邮箱，密码。

而后前往本身刚才填写的邮箱，点开Github发送给你的注册确认信，确认注册，结束注册流程。

必定要确认注册，不然没法使用gh-pages！

第二步: 建立代码库

登录以后，点击页面右上角的加号，选择New repository：

新建代码库

进入代码库建立页面：

在Repository name下填写yourname.github.io，Description (optional)下填写一些简单的描述（不写也没有关系），如图所示：

注意：好比个人github名称是gdutxiaoxu ,这里你就填 gdutxiaoxu.github.io,若是你的名字是xujun，那你就填 xujun.github.io

第三步: . 代码库设置

正确建立以后，你将会看到以下界面：

接下来开启gh-pages功能，点击界面右侧的Settings，你将会打开这个库的setting页面，向下拖动，直到看见GitHub Pages，如图：

Github pages

点击Automatic page generator，Github将会自动替你建立出一个gh-pages的页面。若是你的配置没有问题，那么大约15分钟以后，yourname.github.io这个网址就能够正常访问了~ 若是yourname.github.io已经能够正常访问了，那么Github一侧的配置已经所有结束了。

到此搭建hexo博客的相关环境配置已经完成，下面开始讲解Hexo的相关配置

安装Hexo

在本身认为合适的地方建立一个文件夹，这里我以E：/hexo 为例子讲解，首先在E盘目录下建立Hexo文件夹，并在命令行的窗口进入到该目录

在命令行中输入：

npm install hexo-cli -g
复制代码

而后你将会看到:

可能你会看到一个WARN，可是不用担忧，这不会影响你的正常使用。而后输入

npm install hexo --save
复制代码

而后你会看到命令行窗口刷了一大堆白字，下面咱们来看一看Hexo是否是已经安装好了。在命令行中输入：

hexo -v
复制代码

若是你看到了如图文字，则说明已经安装成功了。

hexo的相关配置

初始化Hexo

接着上面的操做，输入：

hexo init
复制代码

而后输入：

npm install
复制代码

以后npm将会自动安装你须要的组件，只须要等待npm操做便可。

首次体验Hexo

继续操做，一样是在命令行中，输入：

hexo g
复制代码

而后输入：

hexo s
复制代码

而后会提示：

INFO Hexo is running at http://0.0.0.0:4000/. Press Ctrl+C to stop.

在浏览器中打开http://localhost:4000/，你将会看到：

到目前为止，Hexo在本地的配置已经全都结束了。

下面会讲解怎样将Hexo与github page 联系起来

怎样将Hexo与github page 联系起来

大概分为如下几步

配置git我的信息
配置Deployment

配置Git我的信息

若是你以前已经配置好git我的信息，请跳过这一个步骤，直接来到

一、设置Git的user name和email：(若是是第一次的话)

git config --global user.name "xujun"
git config --global user.email "gdutxiaoxu@163.com"
复制代码

二、生成密钥

ssh-keygen -t rsa -C "gdutxiaoxu@163.com"
复制代码

配置Deployment

一样在_config.yml文件中，找到Deployment，而后按照以下修改：

deploy:
  type: git
  repo: git@github.com:yourname/yourname.github.io.git
  branch: master
复制代码

好比个人仓库的地址是git@github.com:gdutxiaoxu/gdutxiaoxu.github.io.git，因此配置以下

deploy:
  type: git
  repo: git@github.com:gdutxiaoxu/gdutxiaoxu.github.io.git
  branch: master
复制代码

写博客、发布文章

新建一篇博客，执行下面的命令：

hexo new post "article title"
复制代码

这时候在个人电脑的目录下 F:\hexo\source\ _posts 将会看到 article title.md 文件

用MarDown编辑器打开就能够编辑文章了。文章编辑好以后，运行生成、部署命令：

hexo g   // 生成
hexo d   // 部署
复制代码

固然你也能够执行下面的命令，至关于上面两条命令的效果

hexo d -g #在部署前先生成
复制代码

部署成功后访问你的地址，yourName.github.io（这里输入个人地址： gdutxiao.github.io ),将能够看到生成的文章。

踩坑提醒

1）注意须要提早安装一个扩展：

npm install hexo-deployer-git --save
复制代码

若是没有执行者行命令，将会提醒

deloyer not found:git

2）若是出现下面这样的错误，

Permission denied (publickey). fatal: Could not read from remote repository. Please make sure you have the correct access rights and the repository exists.

则是由于没有设置好public key所致。在本机生成public key,不懂的能够参考个人这一篇博客Git ssh 配置及使用

主题推荐

每一个不一样的主题会须要不一样的配置，主题配置文件在主题目录下的_config.yml。有两个比较好的主题推荐给你们。

Yilia

Yilia 是为 hexo 2.4+制做的主题。崇尚简约优雅，以及极致的性能。

Yilia地址

NexT

个人网站就是采用这个主题，简洁美观。目前Github上Star最高的Hexo主题，支持几种不一样的风格。做者提供了很是完善的配置说明。

Net主题的配置

在 Hexo 中有两份主要的配置文件，其名称都是 _config.yml。其中，一份位于站点根目录下，主要包含 Hexo 自己的配置；另外一份位于主题目录下，这份配置由主题做者提供，主要用于配置主题相关的选项。

为了描述方便，在如下说明中，将前者称为 站点配置文件，后者称为 主题配置文件。

好比个人电脑下的 F:\hexo 目录下的成为站点配置文件，F:\hexo\themes\next 目录下的成为主题配置文件。

1）安装 NexT

Hexo 安装主题的方式很是简单，只须要将主题文件拷贝至站点目录的 themes 目录下，而后修改下配置文件便可。具体到 NexT 来讲，安装步骤以下。

下载主题

若是你熟悉 Git，建议你使用克隆最新版本的方式，以后的更新能够经过 git pull 来快速更新，而不用再次下载压缩包替换。

克隆最新版本下载稳定版本在终端窗口下，定位到 Hexo 站点目录下。使用 Git checkout 代码：

cd your-hexo-site
git clone https://github.com/iissnan/hexo-theme-next themes/next
复制代码

2）启用主题

与全部 Hexo 主题启用的模式同样。当克隆/下载完成后，打开站点配置文件，找到 theme 字段，并将其值更改成 next。

启用 NexT 主题

theme: next
复制代码

到此，NexT 主题安装完成。下一步咱们将验证主题是否正确启用。在切换主题以后、验证以前，咱们最好使用 hexo clean 来清除 Hexo 的缓存。

3）验证主题

首先启动 Hexo 本地站点，并开启调试模式（即加上 --debug），整个命令是 hexo s --debug。在服务启动的过程，注意观察命令行输出是否有任何异常信息，若是你碰到问题，这些信息将帮助他人更好的定位错误。当命令行输出中提示出：

INFO Hexo is running at http://0.0.0.0:4000/. Press Ctrl+C to stop.

此时便可使用浏览器访问 http://localhost:4000 ，检查站点是否正确运行。

当你看到站点的外观与下图所示相似时即说明你已成功安装 NexT 主题。这是 NexT 默认的 Scheme —— Muse

如今，你已经成功安装并启用了 NexT 主题。下一步咱们将要更改一些主题的设定，包括个性化以及集成第三方服务。

4）主题设定

选择 Scheme

Scheme 是 NexT 提供的一种特性，借助于 Scheme，NexT 为你提供多种不一样的外观。同时，几乎全部的配置均可以在 Scheme 之间共用。目前 NexT 支持三种 Scheme，他们是：

Muse - 默认 Scheme，这是 NexT 最初的版本，黑白主调，大量留白
Mist - Muse 的紧凑版本，整洁有序的单栏外观
Pisces - 双栏 Scheme，小家碧玉似的清新
Scheme 的切换经过更改 主题配置文件，搜索 scheme 关键字。 你会看到有三行 scheme 的配置，将你需用启用的 scheme 前面
复制代码

注释 # 便可。

选择 Pisce Scheme

#scheme: Muse
#scheme: Mist
scheme: Pisces
复制代码

5）设置语言

编辑站点配置文件，将 language 设置成你所须要的语言。建议明确设置你所须要的语言，例如选用简体中文，配置以下：

language: zh-Hans
复制代码

目前 NexT 支持的语言如如下表格所示：

语言	代码	设定实例
English	en	language: en
简体中文	zh-Hans	language: zh-Hans
Français	fr-FR	language: fr-FR
Português	pt	language: pt
繁體中文	zh-hk 或者 zh-tw	language: zh-hk
Русский язык	ru	language: ru
Deutsch	de	language: de
日本語	ja	language: ja
Indonesian	id	language: id

6）设置菜单

菜单配置包括三个部分，第一是菜单项（名称和连接），第二是菜单项的显示文本，第三是菜单项对应的图标。 NexT 使用的是 Font Awesome 提供的图标， Font Awesome 提供了 600+ 的图标，能够知足绝大的多数的场景，同时无须担忧在 Retina 屏幕下图标模糊的问题。

编辑主题配置文件，修改如下内容：

设定菜单内容，对应的字段是 menu。菜单内容的设置格式是：item name: link。其中 item name 是一个名称，这个名称并不直接显示在页面上，她将用于匹配图标以及翻译。

菜单示例配置

menu:
  home: /
  archives: /archives
  #about: /about
  #categories: /categories
  tags: /tags
  #commonweal: /404.html
复制代码

若你的站点运行在子目录中，请将连接前缀的 / 去掉

NexT 默认的菜单项有（标注的项表示须要手动建立这个页面）：

键值	设定值	显示文本（简体中文）
home	home: /	主页
archives	archives: /archives	归档页
categories	categories: /categories	分类页
tags	tags: /tags	标签页
about	about: /about	关于页面
commonweal	commonweal: /404.html	公益 404

设置菜单项的显示文本。在第一步中设置的菜单的名称并不直接用于界面上的展现。Hexo 在生成的时候将使用这个名称查找对应的语言翻译，并提取显示文本。这些翻译文本放置在 NexT 主题目录下的 languages/{language}.yml （{language} 为你所使用的语言）。

以简体中文为例，若你须要添加一个菜单项，好比 something。那么就须要修改简体中文对应的翻译文件 languages/zh-Hans.yml，在 menu 字段下添加一项：

menu:
  home: 首页
  archives: 归档
  categories: 分类
  tags: 标签
  about: 关于
  search: 搜索
  commonweal: 公益404
  something: 有料
复制代码

设定菜单项的图标，对应的字段是 menu_icons。此设定格式是 item name: icon name，其中 item name 与上一步所配置的菜单名字对应，icon name 是 Font Awesome 图标的名字。而 enable 可用于控制是否显示图标，你能够设置成 false 来去掉图标。

菜单图标配置示例

menu_icons:
  enable: true
  # Icon Mapping.
  home: home
  about: user
  categories: th
  tags: tags
  archives: archive
  commonweal: heartbeat
复制代码

在菜单图标开启的状况下，若是菜单项与菜单未匹配（没有设置或者无效的 Font Awesome 图标名字）的状况下，NexT 将会使用做为图标。

请注意键值（如 home）的大小写要严格匹配

7）** 侧栏**

默认状况下，侧栏仅在文章页面（拥有目录列表）时才显示，并放置于右侧位置。能够经过修改主题配置文件中的 sidebar 字段来控制侧栏的行为。侧栏的设置包括两个部分，其一是侧栏的位置，其二是侧栏显示的时机。

设置侧栏的位置，修改 sidebar.position 的值，支持的选项有：

left - 靠左放置
right - 靠右放置
复制代码

目前仅 Pisces Scheme 支持 position 配置。影响版本5.0.0及更低版本。

sidebar:
  position: left
复制代码

设置侧栏显示的时机，修改 sidebar.display 的值，支持的选项有：

post - 默认行为，在文章页面（拥有目录列表）时显示
always - 在全部页面中都显示
hide - 在全部页面中都隐藏（能够手动展开）
remove - 彻底移除
sidebar:
  display: post
复制代码

已知侧栏在 use motion: false 的状况下不会展现。影响版本5.0.0及更低版本。

8）设置头像

编辑站点配置文件，新增字段 avatar，值设置成头像的连接地址。其中，头像的连接地址能够是：

地址	值
完整的互联网 URI	example.com/avtar.png
站点内的地址	将头像放置主题目录下的 source/uploads/ （新建uploads目录若不存在）配置为：avatar: /uploads/avatar.png 或者放置在 source/images/ 目录下 , 配置为：avatar: /images/avatar.png

头像设置示例

avatar: http://example.com/avtar.png
复制代码

9)设置做者昵称

编辑站点配置文件，设置 author 为你的昵称。

10)站点描述

编辑站点配置文件，设置

字段为你的站点描述。站点描述能够是你喜欢的一句签名:)

net主题的官方文档地址

添加插件

添加sitemap和feed插件

切换到你本地的hexo 目录CIA，在命令行窗口，属兔如下命令

npm install hexo-generator-feed -save
npm install hexo-generator-sitemap -save
复制代码

修改_config.yml，增长如下内容

# Extensions
Plugins:
- hexo-generator-feed
- hexo-generator-sitemap
#Feed Atom
feed:
  type: atom
  path: atom.xml
  limit: 20
#sitemap
sitemap:
  path: sitemap.xml
复制代码

再执行如下命令，部署服务端

hexo d -g
复制代码

配完以后，就能够访问 gdutxiaoxu.github.io/atom.xml 和 gdutxiaoxu.github.io/sitemap.xml ，发现这两个文件已经成功生成了。

添加404 页面

GitHub Pages有提供制做404页面的指引：Custom 404 Pages 直接在根目录下建立本身的404.html或者404.md就能够。可是自定义404页面仅对绑定顶级域名的项目才起做用，GitHub默认分配的二级域名是不起做用的，使用hexo server在本机调试也是不起做用的。

推荐使用腾讯公益404

个人404页面配置以下

<html>
<head>
  <meta http-equiv="content-type" content="text/html;charset=utf-8;"/>
  <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1" />
  <meta name="robots" content="all" />
  <meta name="robots" content="index,follow"/>
</head>
<body>

<script type="text/javascript" src="https://www.qq.com/404/search_children.js"
        charset="utf-8" homePageUrl="gdutxiaoxu.github.io"
        homePageName="回到个人主页">
</script>

</body>
</html>
复制代码

参考博客

Hexo主页

史上最详细的Hexo博客搭建图文教程

个人git系列参考教程

转载请注明原博客地址：手把手教你用Hexo+Github 搭建属于本身的博客

欢迎关注个人微信公众号，扫一扫下方二维码或搜索微信号 stormjun，便可关注。目前专一于 Android 开发，主要分享 Android开发相关知识和一些相关的优秀文章，包括我的总结，职场经验等。