JERRY-Hexo-GitHub
《JERRY Hexo & GitHub 静态网站搭建说明》
非原创内容,转载请注明出处!
一、前言
1.1 什么是 Hexo?
一个基于 Node.js
设计的快速、简洁且高效的博客框架
- 超快速度
- 支持 Markdown
- 一键部署
- 插件和可扩展性
- 免费开源
1.2 什么是 GitHub?
一个面向开源及私有软件项目的托管平台,因为只支持 Git
作为唯一的版本库格式,故名 GitHub
- 全球最活跃开源社区
- 开源社交平台
- 企业项目管理平台
1.3 什么是静态网站?
通俗的讲静态网站指:只有 前端
没有 后端
的网站,静态网站的所有页面内容在没有被修改的前提下都是固定不变的
适用于博客、固定页面展示等网站。
1.4 Hexo 与 GitHub 搭配建站的优缺点
(1)优点
- 简单稳定
- 开源免费
- 社区活跃利于交流
(2)缺点:
- 国内访问速度慢
- 不支持动态网站搭建
二、安装 Git
2.1 什么是 Git?
Git
是一个开源的分布式版本控制系统,用于敏捷高效地处理任何或小或大的项目
使用 GitHub 必须有 Git。
2.2 Git 的下载安装与配置
(1)下载安装
选择对应系统版本下载,安装默认下一步即可。
(2)配置
打开终端键入以下命令:
$ git --version
# 查看 git 版本号
# 若成功识别即为 git 安装成功
$ git config --global user.name "xxx"
$ git config --global user.email xxx@xxx.com
# 配置个人的用户名称和电子邮件地址
$ git config --list
# ...
# user.name=xxx
# user.email=xxx@xxx.com
# 检查已有的配置信息
# 若配置信息中出现正确用户名及邮箱即为配置成功
三、安装 Node.js
3.1 什么是 Node.js?
一个基于 Chrome V8
引擎的 JavaScript
运行环境,使用了一个事件驱动 、非阻塞式 I/O 模型,让 JavaScript 运行在服务端的开发平台,它让 JavaScript 成为与 PHP
、Python
、Perl
、Ruby
等服务端语言平起平坐的 脚本语言
。
3.2 Node.js 的下载安装与配置
选择对应系统的长期支持版下载,安装默认下一步即可。
安装完成,打开终端键入以下命令:
$ node -v
# 查看 Node.js 版本
$ npm -v
# 查看 npm 包管理器版本
若以上两个命令都成功识别,那么 Node.js 便安装成功。
$ npm install -g cnpm --registry=https://registry.npm.taobao.org
# 利用 npm 下载国内淘宝镜像 cnpm
$ cnpm -v
# 查看 cnpm 版本
# 若以上命令成功识别,那么 cnpm 便安装成功
什么是 npm 和 cnpm ?
npm
(node package manager):Node.js 的包管理器,用于 node 插件管理(包括安装、卸载、管理依赖等)。cnpm
:因为 npm 安装插件是从国外服务器下载,受网络的影响比较大,可能会出现异常,所以乐于分享的淘宝团队解决了这事。来自官网:“这是一个完整 npmjs.org 镜像,你可以用此代替官方版本(只读),同步频率目前为 10分钟 一次以保证尽量与官方服务同步”。
四、安装 Hexo
4.1 Hexo 的下载安装与配置
下载安装:
打开终端键入以下命令:
$ cnpm install hexo-cli -g
# 等待一会,安装完毕
$ hexo -v
# 查看 hexo 版本
# 若以上命令成功识别,那么 hexo 便安装成功
五、搭建静态网站
5.1 新建一个网站
$ hexo init [folder]
# 如果没有设置 folder,Hexo 默认在当前的文件夹建立网站
5.2 生成静态文件
$ hexo generate
# 该命令可以简写为 $ hexo g
5.3 启动服务器
$ hexo server
# 该命令可以简写为 $ hexo s
# 默认情况下,访问端口为:http://localhost:4000/
# 在浏览器中访问 http://localhost:4000/ 即可打开本地搭建好的网站
5.4 新建一篇文章
$ hexo new <title>
# 如果标题包含空格的话,请使用引号括起来 $ hexo new "first blog"
# 生成的 Markdown 文章放在 source 内的 _posts 下
六、利用 GitHub 部署网站
6.1 注册用户
点击右上角注册即可。
6.2 创建同名仓库
- 点击右上的
+
,选择New repository
新建一个仓库 - 仓库名称设为
用户名.github.io
- 仓库类型为
Public
公共类型 - 复制仓库
HTTPS
URL
6.3 更改 Hexo 配置文件
修改根目录 _config.yml
内的 deploy
。
# Deployment
## Docs: https://hexo.io/docs/one-command-deployment
deploy:
type: 'git'
repo: https://github.com/用户名/用户名.github.io.git # HTTPS URL
branch: master
6.4 安装 hexo - git 部署工具
在 Hexo 博客根目录下,打开终端键入:
$ cnpm install hexo-deployer-git --save
# 安装 hexo-deployer-git 工具
6.5 远程部署到 GitHub Pages 服务器
$ hexo deploy
# 该命令可以简写为 $ hexo d
部署成功后即使用 https://用户名.github.io/
在浏览器中访问网站。
七、结束语
7.1 美化 Hexo 网站
Hexo 支持主题自定义,并且有一个活跃的 主题社区。
切换主题方法:下载主题到 themes
文件夹内并修改根目录 _config.yml
内的 theme
设定,即可切换主题。
修改配置主题请查阅相应主题的文档。
目前比较热门的几个主题:
7.2 使用 Hexo 插件
Hexo 是一个支持插件的可扩展框架,具体插件类型及安装方法请前往 Hexo 官网查看 或在搜索引擎求助。
7.3 帮助文档
Hexo 提供了全面的 Hexo 使用文档(中英文版)及 API 文档,在使用及开发优化 Hexo 的过程中,建议以官方文档为基准。