内容简介

此篇文章介绍的是基础的hexo+github搭建个人博客的方法，包括搭建之前的准备工作和搭建的步骤过程，当最后达到了预期效果，并且想深入研究其他功能时，可以参考hexo+github创建个人博客--深入篇,里面介绍了关于博客的主题，图床，评论，统计等功能的配置和实现。

工具介绍

1.hexo介绍

Hexo是一个快速、简洁且高效的博客框架。Hexo使用Markdown解析文章，在几秒内，即可利用靓丽的主题生成静态网页

2.Markdown介绍

Markdown是一种可以使用普通文本编辑器编写的标记语言，通过简单的标记语法，它可以使普通文本内容具有一定的格式。

准备工作

1.github账号创建和git安装

• 没有github账号的朋友先进行github账号注册，按照流程注册即可

• 创建仓库,命名格式为 yourname.git.io,例如我的github名称为haloMelody，仓库名为haloMelody.git.io

• 为仓库创建两个分支，master（默认的主分支）用于博客的发布，另外创建一个分支hexo（命名看你自己）用于保存博客项目，为了防止换电脑导致以前的博文丢失的情况，确保记录的同步，并且将自己创建的分支hexo设置为默认分支--settings中可进行设置

• 创建git-pages，一般仓库创建后会自动勾选，此选项可以保证通过已项目名为域名来访问你的博文（有自己域名的可进行域名绑定，参考http://www.cnblogs.com/penglei-it/p/hexo_domain_name.html）

• 接下来为保证可以在终端运行git命令，需要安装git，下载完成后配置环境变量，将cmd目录配置到path中。

  git version  //检测是否安装成功
  

2.nodejs安装

• 进入node.js官网安装，按照导航进行

  npm -v  //检测nodejs是否安装成功
  

• 若出现 命令未找到 的错误提示，则需要手动的配置环境变量，将nodejs目录配到path目录下。此处选择nodejs版本时尽量选择最新的版本，方便后续选择的主题时候的兼容性。

3.hexo安装

• nodejs安装成功后可以使用以下命令安装hexo.

  npm install hexo -g //安装全局的hexo
  npm install hexo //在某目录下有效
  hexo -v //检测是否成功安装
  

• 若出现 命令未找到 的错误提示，则需要手动的配置环境变量，找到hexo的安装目录，全局安装可以参照C:\Users\LittleDragon\AppData\Roaming\npm（改为自己电脑的路径），将此路径配置到path中，并且运行hexo -v检测是否成功。

博客搭建

1.项目创建

• 选择一个位置将仓库同步到本地，进入到文件中，打开文件查看选项中的显示影藏文件，可看到至少有一个.git文件（此处将.git文件复制到别处，随后清空仓库项目文件夹，为了后续操作执行--hexo init 的时候需要文件夹为空），同步命令为：

  git clone  xxx  //复制github仓库路径
  

• 随后在此目录下（保证此时是空文件夹），打开CMD（shift+鼠标右键），顺序运行：

  hexo init //初始化项目
  npm install hexo //安装插件
  npm install hexo-deployer-git //发布到git上时必要的插件
  

• 项目初始化后，可以看到如下的目录结构，分别表示为：

        .deploy #需要部署的文件
        node_modules #Hexo插件
        public #生成的静态网页文件
        scaffolds #模板
        source #博客正文和其他源文件，404、favicon、CNAME 都应该放在这里
        _drafts #草稿
        _posts #文章
        themes #主题
        _config.yml #全局配置文件
        package.json
  

• 接下来可以运行命令，创建一篇博文，文章使用的是MarkDown语言，具体语法此处不做介绍

  hexo new "title" //创建指定标题的文章
  

• 文章内容编辑好以后，执行命令：

  hexo clean //清除原有记录
  hexo g //generate生成html文件
  hexo s //server本地运行
  

• 本地运行以后会实时的对本地文件进行监控，修改后直接刷新浏览器即可看到效果，到此，简单的个人博客已经搭建完成了，接下来可以件博客发布到github上，让网友可以通过你的域名访问个人博客,发布需要的几个步骤：

  1. 成功安装了发布需要的插件
     npm install hexo-deployer-git //发布到git上时必要的插件

  2. 为你的github配置SSH Key，只需要配置一次，详情请参照github配置SSH Key

  3. 在博客项目根目录下的_config.yml中进行如下配置：
     deploy: type: git repo: git@github.com:yourname/yourname.github.io.git branch: master
     > 4. 执行发布命令，首次可能需要输入github的用户名和密码
     hexo d
     > 5. 发布之后可以登录你的域名查看效果