【教程向】——基于hexo+github搭建私人博客

时间 2020-05-06

标签教程向基于 hexo+github hexo github 搭建私人博客栏目 Git 繁體版

原文原文链接

前言

1.github pages服务生成的全是静态文件，访问速度快； 2.免费方便，不用花一分钱就能够搭建一个自由的我的博客，不须要服务器不须要后台； 3.能够随意绑定本身的域名，不仔细看的话根本看不出来你的网站是基于github的； 4.数据绝对安全，基于github的版本管理，想恢复到哪一个历史版本都行； 5.博客内容能够轻松打包、转移、发布到其它平台；html

node

hexo、git配置和安装

什么是hexo？

Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown（或其余渲染引擎）解析文章，在几秒内，便可利用靓丽的主题生成静态网页。git

安装

安装hexo只须要几分钟，但前提是你的确保你的电脑中已经安装了下列应用程序：github

下载必须程序

node.js

Node.js是一个Javascript运行环境(runtime)web

Git是一个开源的分布式版本控制系统，用以有效、高速的处理从很小到很是大的项目版本管理。从上面连接下载git for windows最好挂一个代理，不然下载速度会十分缓慢，你能够参考**这个页面**,其中收录了存储于百度云的下载地址。shell

下载以后你能够在你想要建立博客的位置新建一个文件夹，进行node.js和git的安装，打开安装包，按顺序安装便可。安装完成后能够打开cmd命令行检查是否安装完成： npm

hexo安装

打开git命令行输入如下代码安装hexowindows

$ npm install -g hexo-cli

建站

安装好hexo后执行下列操做来生成所须要的文件

初始化

在你的电脑选取一个你想要存放这个网页的代码的文件夹，而后在里面新建一个hexo文件夹。安全

在git命令行中输入：服务器

$ cd /d/网页设计/hexo
$ hexo init

下载完成后，会在对应的hexo文件中自动生成对应文件。

生成文件和启用预览服务

在git命令行中输入如下命令：

$ hexo g # 生成
$ hexo s # 启动服务

会在public文件中生成相关的HTML文件。

用来启用本地预览服务，启用后就能够经过**http://localhost:4000/**来预览博客内容。 [站外图片上传中...(image-664f86-1553673077649)] 若是一切顺利，访问以上预览连接应当出现这样的一个默认博客主页。至这一步，一个基于hexo的blog就搭建完成了。

如何将博客部署到github

在生成博客初始页面后，咱们的博客还不算完成，由于咱们只能看到的知识hexo提供的一个本地预览网页，别人是看不到的，那么如何才能让别人也能够访问的到咱们的博客呢，那就须要咱们把博客部署到网上了，这里，我选择的是github。

注册github帐户和新建仓库

首先，咱们须要在github上有一个帐户。

github官网

点击连接进入github官网注册。注册好以后点击sign in登陆github。

点击new repository新建一个名为<code>你的用户名.github.io</code>的仓库。如个人用户名是gemuxiaoshe，那么我就须要新建一个<code>gemuxiaoshe.github.io</code>的仓库，这样你以后的网站地址就能够直接使用**https://gemuxiaoshe.github.io/**访问仓库了。

配置SSH key

为何要配置这个呢？由于你提交代码确定要拥有你的github权限才能够，可是直接使用用户名和密码太不安全了，因此咱们使用ssh key来解决本地和服务器的链接问题。

咱们在github命令行中输入如下命令来检测本机已存在的ssh密匙

$ cd ~/. ssh #检查本机已存在的ssh密钥

若是提示：No such file or directory 说明你是第一次使用git。

ssh-keygen -t rsa -C "邮件地址"

在github命令行中输入以上命令，而后连续三次回车。最后会在你的用户目录下生成一个id_rsa.pub文件, 找到并打开它（能够直接使用记事本打开），复制里面的所有内容，而后打开你的github主页，进入我的设置 -> SSH and GPG keys -> New SSH key：将刚复制的内容粘贴到key那里，title随便填，保存。

输入如下命令测试SSH key是否配置成功

$ ssh -T git@github.com # 注意邮箱地址不用改

若是提示Are you sure you want to continue connecting (yes/no)?，输入yes

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

看到这个信息说明SSH已配置成功！

最后咱们还须要配置：

$ git config --global user.name "liuxianan"// 你的github用户名，非昵称
$ git config --global user.email  "xxx@qq.com"// 填写你的github注册邮箱

部署代码到github上

在配置还SSH key以后，咱们上传代码就很容易了

这时候咱们还不能直接使用hexo d 上传代码，由于咱们还有_config.yml没有配置。打开_config.yml站点配置文件,目录为：<code>D:\网页设计\hexo_config.yml</code> 找到<code>deploy</code>关键词进行以下配置：

deploy:
  type: git
  repository: git@github.com:liuxianan/liuxianan.github.io.git #你的用户名和你新建的仓库名
  branch: master

配置成功以后，咱们能够尝试使用hexo d 来上传咱们的代码，但这个时候应当是没法上传成功的。它会出现如下内容：

Deployer not found: git

表示它没有发现git

这是由于咱们还须要安装一个插件：

npm install hexo-deployer-git --save

安装成功后咱们就能够开始上传咱们的代码了首先咱们用<code>hexo g</code>来生成一下文件

$ hexo g

再输入如下命令上传代码到github上：

$ hexo d

上传成功！以后你能够登陆你的github主页查看代码是否上传成功。而且能够直接使用你以前设置好的仓库地址https://gemuxiaoshe.github.io/登陆到你的博客主页了。

博客的进阶学习主题的更改和优化以及博客的建立和编写

至此，博客搭建才算正式完成，你的博客将能够被访问到。不过到目前咱们只是刚刚建立了一个默认的博客主页，和一篇默认的博客，且这个默认主页固然是不可能让咱们满意的，而且其功能也确定会有所不足。那么咱们首先，咱们还须要进行的最基本的工做就是学习如何修改和优化咱们的主题，而且学习博客的建立和编写。

关于博客的建立和编写能够参考个人另两篇博文

这是一篇测试博客主要介绍了博文的两种建立方式。
markdown语言中基本标签的使用主要介绍了博文编写所较常使用的markdown标记语言的基本使用方法

关于博客主题的修改和优化能够参考下面的网站，在这里就不进行详细过程的介绍了

NexT 使用文档

NexT 一款基于hexo的主题，NexT 使用文档详细的介绍了基于hexo的主题NexT的使用方法，和NexT主题的配置方法，以及各类第三方服务的配置方法，同时也包括一些基本的站点文件配置。其中配置方式是适用于多种主题的。

hexo的next主题个性化教程:打造炫酷网站一个简书上的Next主题的个性化配置教程，其中还包括一些Next使用文档所没有的进阶配置，比较详细的介绍了主题的各类个性化配置。。

关于分享功能实现的补充

因为我使用的百度分享和jiathis分享均出现了问题，而且并无找到解决的办法，因而使用了另一个第三方分享服务sharesdk。

具体实现方法请点击下面连接为Hexo NexT主题添加ShareSDK的分享
关于分享功能的的尝试结果

在最终尝试了各类分享服务后仍是发现个人分享功能仍是没能在基于github上实现，在网上也没有找到相关的问题描述和解决方式。很是遗憾只能暂时放弃分享功能的使用。在以后的过程当中再来补充。

参考

hexo使用文档 hexo的官方使用文档，十分详细的总结概括了hexo的各类使用方法。
小茗同窗的博客园一个比较详细的hexo+github搭建博客的教程
hexo的next主题个性化教程:打造炫酷网站一个next主题修改优化教程
NexT 使用文档 next主题的官方使用文档，十分详细的介绍了next主题的各类使用方法