开放原子开发者工作坊

注意 本文主要针对Windows平台和Hexo 3.x

准备工作

下载Git

[下载地址] Git官网

下载Node.js

[下载地址] node.js官网

32位或64位按自己电脑的系统来选择，如果不清楚，可以直接在官网下载32位的，可以兼容64位系统

安装软件

分别安装git和node.js安装包，一路下一步即可。

配置git

配置本机上git的全局用户名和密码

安装完Git以后，双击桌面的“Git Bash" 图标，输入以下命令：

$ git config --global user.name "Your Name"
$ git config --global user.email "email@example.com"

其中的用户名和邮箱以自己的来代替即可

创建本机的SSH Key

输入一下命令，你需要把邮件地址换成你自己的邮件地址，然后一路回车，使用默认值即可

$ ssh-keygen -t rsa -C "youremail@example.com"

如果一切顺利的话，可以在用户主目录里找到.ssh目录，里面有id_rsa和id_rsa.pub两个文件，这两个就是SSH Key的秘钥对，id_rsa是私钥，不能泄露出去，id_rsa.pub是公钥，可以放心地告诉任何人。

配置github

在github上注册一个自己的账号，注册过程就不详细说了。注册完以后登录github ,点击右上角自己头像右边的小箭头，选择“Settings-SSH and GPG keys”

然后，点击页面右边的“Add SSH Key”，填上任意Title，在Key文本框里粘贴刚刚获得到的id_rsa.pub文件的内容，id_rsa.pub用记事本打开就好。

接下来创建自己的仓库，点击“New repository”

填写仓库的名称，名称请按xx.github.io的格式填写，xx为自己的用户名，填写完成后点击创建即可。

仓库创建完成后的页面如下，到这里git的配置算基本完成了，接下来要配置一下Hexo。

配置Hexo

在自己电脑上新建一个空的文件夹，我这里是在e盘下新建了一个Blog文件件，然后右键选择“Git Bash Here"打开git，输入一下命令

$ npm install -g hexo-cli

如果发现没反应则应该是被墙了，则先安装淘宝镜像，命令如下

$ npm install -g cnpm --registry=https://registry.npm.taobao.org

然后输入安装命令

$ cnpm install -g hexo-cli

出现的WARN可以不用理会,继续输入以下命令

$ cnpm install hexo --save

安装完成后，输入“hexo -v"查看是否安装正确，接下来在Blog文件夹下输入一下命令初始化hexo

$ hexo init

输入一下命令安装生成器

$ cnpm install

安装完成以后输入一下命令打开hexo服务，就可以在浏览器下输入localhost:4000,就可以在本地看到你的个人博客了

$ hexo s

配置上传博客到github上

打开blog根目录下的_config.yml配置文件，修改一下配置，public_dir项修改成与之前建立的仓库名称一致，修改完后保存

在命令行中输入以下命令，生成hexo博客的静态文件

$ hexo g

这时候会发现blog目录下多了一个与仓库名称同名的文件夹，里面存放的就是刚刚生成的网页文件，接下来的任务就是把这些静态文件上传到github上去

命令行进入到该文件夹，然后输入以下命令初始化工作区

$ git init

输入以下命令将静态文件添加的版本库的缓存区

$ git add --all

输入以下命令将更改提交到版本库，双引号中的内容为自己的更改说明，可按自己情况填写

$ git commit -m "git tracks changes"

上传博客到github上

打开刚才在github上建立的仓库，复制ssh的地址

在Git命令行窗口中输入以下命令，添加远程库，后面的那串git@....git字符串替换为自己刚才复制的ssh地址

$ git remote add origin git@github.com:michaelliao/learngit.git

最后输入以下命令，将本地的版本库推送到github上的远程库

$ git push -u origin master

第一次推送按以上的输，以后的推送只要输入一下命令即可

$ git push origin master

查看github上的仓库里，是不是已经有了刚才推送的文件，这时候浏览器打开自己的git.io地址，就可以看到自己的博客已经搭建起来啦！

如何新建文章

在blog目录下打开git命令行窗口，输入一下命令,双引号中的内容替换成文章题目

$ hexo new "title"

然后在blog——source——_post目录下就可以看到自己新建的.md文件了，用编辑工具编写文章，然后重复以上步骤添加到版本库，推送到远程版本库即可。

本教程完