hexo+github/gitee——个人博客搭建

本人博客：https://shoresouth.gitee.io/
Hexo是一款基于Node.js的静态博客框架，依赖少易于安装使用，可以方便的生成静态网页托管在GitHub和Coding上，是搭建博客的首选框架。

安装相关工具

安装Node.js

安装环境

node.js下载官网: nodejs官网

验证安装

node -v 显示安装的nodejs版本
npm -v 显示安装的npm版本

修改全局模块下载路径

1. 我希望将全模块所在路径和缓存路径放在我node.js安装的文件夹中，则在我安装的文件夹[D:\Nodejs]下创建两个文件夹[node_global]及[node_cache]
2. 创建完两个空文件夹之后，打开命令行界面，输入下面命令:

npm config set prefix "D:\Nodejs\node_global"
npm config set cache "D:\Nodejs\node_cache"

3. 修改系统环境变量

• 将【用户变量】下的【Path】修改为【D:\Nodejs\node_global】，之后点击确定。
• 在【系统变量】下新建【NODE_PATH】【D:\Nodejs\node_global\node_modules】
• 在【系统变量】下的【Path】新建添加【%NODE_HOME%】和node全局文件夹【D:\Nodejs\node_global】，之后点击确定。

经过上面的步骤，nodejs下载的模块就会自动下载到我们自定义的目录，接下来我们测试一下。输入下面的命令：

npm install express -g     # -g是全局安装的意思，不加 -g 就是默认下载到当前目录

注： 可能由于权限的原因出现报错，右击Nodejs文件夹->属性->安全，点击编辑，将所有权限都✔即可。

更换npm源为淘宝镜像

说明：npm 默认的 registry ,也就是下载 npm 包时是从国外的服务器下载，国内很慢，一般都会指向淘宝 https://registry.npm.taobao.org。

npm config get registry //查看npm源
npm config set registry https://registry.npm.taobao.org/ //更换镜像为淘宝镜像

全局安装基于淘宝源的cnpm

说明：由于npm的服务器在海外，所以访问速度比较慢，访问不稳定 ，cnpm的服务器是由淘宝团队提供服务器在国内cnpm是npm镜像，一般会同步更新，相差在10分钟，所以cnpm在安装一些软件时候会比较有优势。但是一般cnpm只用于安装时候，在项目创建与卸载等相关操作时候我们还是使用npm。

全局安装基于淘宝源的cnpm
npm install -g cnpm --registry=https://registry.npm.taobao.org
查看cnpm是否安装成功
cnpm -v

安装git

Git是一个开源的分布式版本控制系统，可以有效、高速地处理从很小到非常大的项目版本管理。也是Linus Torvalds为了帮助管理Linux内核开发而开发的一个开放源码的版本控制软件。

安装环境

git官网：Git

验证安装

git --version   

常用命令

git config -l  //查看所有配置
git config --system --list //查看系统配置
git config --global --list //查看用户（全局）配置
git config –global core.editor vim （编辑器名） //修改默认编辑器

git config --global user.name  "自己的用户名" //配置用户名
git config --global user.emal  "自己的邮箱" //配置邮箱

安装hexo

安装环境

必须按照步骤来，因为hexo需要使用node.js的npm命令。

npm install hexo-cli // 下载hexo
hexo -v // 查看是否安装成功
hexo init // 初始化hexo文件夹
npm install // 下载模块依赖

搭建个人博客

github设置远程库

• 登录后点击“+”号，选择New repository
• 在Repository name下面填写你要创建的地址，这个地址是就是你的域名。e.g., shoresouth.github.io以后就在地址栏直接输入它就可以访问网站。
  注： 名称必须与用户名一致！
• 创建之后，点击setting设置远程库：
  找到GitHub Pages点击Automatic page generator，等待github pages创建完成，然后输入你创建的地址测试github pager是否创建成功。此时页面是空的没有任何东西(404)。

下面要做的就是使用hexo模板将源码放到github。

初始化hexo

• 创建一个空文件夹用于存放hexo
• 右键该文件夹使用 git bash here
• 输入命令：

npm install hexo --save //初始化hexo基础配置文件
hexo init //初始化hexo。这个命令和git 仓库命令相似 
npm install //配置node
hexo g //加载hexo基础html、css、js等文件

配置hexo

当我们安装完毕的时候，就需要对Hexo进行一些配置，具体是通过_config.yml文件来完成的。
hexo结构

    .deploy_git 
    node_modules //包所需要的依赖
    public // 静态网页存储的目录
    scaffolds // 样本
    source // 我们自己的md文件
    themes // 主题文件
    .gitignore
    _config.yml // 配置
    db.json
    package.json
    package-lock.json

本地测试

hexo server: 相当于开启了一个本地的服务器，会提示你拷贝url到浏览器。

hexo s 

在浏览器输入 http://localhost:4000/ 展现页面，证明本地hexo默认模板配置成功。

推送到远程仓库（github）

根目录_config.yml中配置自己的远程仓库地址

# Deployment
## Docs: https://hexo.io/docs/one-command-deployment
deploy:
  type: git
  #repo: https://github.com/ShoreSouth/ShoreSouth.github.io.git //https传输容易失败
  repo: git@github.com:ShoreSouth/ShoreSouth.github.io.git
  branch: master

安装git部署插件

cnpm install --save hexo-deployer-git

发布hexo到github page

hexo clean && hexo g && hexo d //一次性执行清空、刷新、部署三个命令