Hexo + github 构建博客

2018-02-12 本文已影响0人 YQY_苑

概况

为什么选择GitHub Pages
1、GitHub Pages有免费的代码托管空间，资料自己管理，保存可靠；
2、学着用 GitHub，享受 GitHub 的便利，上面有很多大牛，眼界会开阔很多；
3、顺便理解 GitHub 工作原理，最好的团队协作流程；
4、GitHub建立私有仓库才会收费，所以会有很多开源代码。

GitHub Pages是什么
应用GitHub Pages创建属于自己的个人博客，GitHub将提供免费的空间。GitHub提供的域名（用户名+github+io）,在Repository name对应处填写资源名，其需要使用自己的用户名，每个用户名下面只能建立一个，并且资源命名必须符合这样的规则username/username.github.io，之后勾选下面的”Initialize this repository with a README” 。

hexo出自何人
hexo出自台湾大学生 tommy351 之手，是一个基于Node.js的静态博客程序，其编译上百篇文字只需要几秒。hexo生成的静态网页可以直接放到GitHub Pages，BAE，SAE等平台上。

安装准备

环境搭建：

Node.js：下载地址

Git：下载地址

Sublime：下载地址

安装Node

到 Node.js 官网下载相应平台的最新版本，一路安装即可。我用的是 node-v0.10.22-x86.msi

安装Git

Git的客户端很多，我用的是 msysgit ，喜欢用绿色版本 Portable application for official Git for Windows 1.8.4 ，下载下来设置一下环境变量即可，Git_HOME，%Git_HOME%\bin之类的，不多说。

安装Sublime

Sublime Text 2 在这里仅仅作为一个文本编辑器使用，支持各种编程语言和文件格式，当然也支持Markdown语法，实在是个不可多得的练码奇才。喜欢追鲜的也可以尝试处于beta版本的 Sublime Text 3 。

GitHub注册与配置

注册：
访问：GitHub，注册你的username和邮箱，邮箱十分重要，GitHub上很多通知都是通过邮箱的。注册过程比较简单，详细也可以看：
使用Github Page搭建博客, 需要遵循一定的规则, 需要在github建立仓库,仓库名为Github用户.github.io, 更多详情请参考官方文档

配置和使用Github
以下教程主要参考beiyuu的《使用Github Pages建独立博客》写成。

配置SSH keys
我们如何让本地git项目与远程的github建立联系呢？用SSH keys。
打开Git Bash工具，执行以下操作

检查SSH keys的设置

  // 首先我们需要检查你电脑上现有的ssh key：
$ cd ~/. ssh 检查本机的ssh密钥
   // 如果提示：No such file or directory 说明你是第一次使用git。
   // 生成新的SSH Key：
$ ssh-keygen -t rsa -C "邮件地址@youremail.com"
Generating public/private rsa key pair.
Enter file in which to save the key 
(/Users/your_user_directory/.ssh/id_rsa):<回车就好>

注意1: 此处的邮箱地址，你可以输入自己的邮箱地址；
注意2: 此处的「-C」的是大写的「C」

然后系统会要你输入密码：

Enter passphrase (empty for no passphrase):<输入加密串>
Enter same passphrase again:<再次输入加密串>

在回车中会提示你输入一个密码，这个密码会在你提交项目时使用，如果为空的话提交项目时则不用输入。这个设置是防止别人往你的项目里提交内容。

注意：输入密码的时候没有*字样的，你直接输入就可以了。

添加SSH Key到GitHub
在本机设置SSH Key之后，需要添加到GitHub上，以完成SSH链接的设置。
打开本地C:\Documents and Settings\Administrator.ssh\id_rsa.pub文件。此文件里面内容为刚才生成人密钥。如果看不到这个文件，你需要设置显示隐藏文件。准确的复制这个文件的内容，才能保证设置的成功。
登陆github系统。点击右上角的 Account Settings—>SSH Public keys —> add another public keys
把你本地生成的密钥复制到里面（key文本框中），点击 add key 就ok了
测试

  可以输入下面的命令，看看设置是否成功，git@github.com的部分不要修改：
$ ssh -T git@github.com
    如果是下面的反馈：
The authenticity of host 'github.com (207.97.227.239)' can't be established.
RSA key fingerprint is 16:27:ac:a5:76:28:2d:36:63:1b:56:4d:eb:df:a6:48.
Are you sure you want to continue connecting (yes/no)?
    不要紧张，输入yes就好，然后会看到：
Hi cnfeat! You've successfully authenticated, 
but GitHub does not provide shell access.
    设置用户信息：
    现在你已经可以通过SSH链接到GitHub了，还有一些个人信息需要完善的。
    Git会根据用户的名字和邮箱来记录提交。
    GitHub也是用这些信息来做权限的处理，输入下面的代码进行个人信息的设置，把名称和邮箱替换成你自己的，名字必须是你的真名，而不是GitHub的昵称。
$ git config --global user.name "cnfeat"//用户名
$ git config --global user.email "cnfeat@gmail.com"//填写自己的邮箱
    SSH Key配置成功，本机已成功连接到github。

Hexo博客

Hexo
Hexo的作者是tommy351，根据官方介绍，Hexo是一个简单、快速、强大的博客发布工具，支持Markdown格式。hexo的主题列表 Hexo Themes。我比较喜欢 pacman ， modernist 、 ishgo ， raytaylorism 。

安装Hexo

打开Git Bash工具（前提确保Node.js已经安装，环境配置OK）

$ npm install -g hexo

部署Hexo

    在我的电脑中建立一个名字叫「Hexo」的文件夹，然后在此文件夹中右键打开Git Bash。
$ hexo init
    如果无法使用右击“Git Bash”，则可以切换到指定目录
    UUhike@UUhike-pc MINGW64 ~
$ cd j:/github/hexo
    UUhike@UUhike-pc MINGW64 /j/github/hexo
    安装依赖包
$ npm install
    Hexo随后会自动在目标文件夹建立网站所需要的所有文件。
    现在我们已经搭建起本地的hexo博客了，
    执行以下命令(在H:\hexo)，然后到浏览器输入localhost:4000看看。
    本地查看
$ hexo generate #生成静态页面至public目录（最终上传这个文件到GitHub）
$ hexo server #开启预览访问端口（默认端口4000，'ctrl + c'关闭server）

部署到GitHub

编辑E:\hexo下的_config.yml，修改Deployment部分：
# Deployment
## Docs: http://hexo.io/docs/deployment.html
deploy:
  type: git
    repository: git@github.com:silvia-YQY/silvia-YQY.github.io.git   
    branch: master

hexo简写命令

$ hexo g #生成
$ hexo s #启动本地服务，进行文章预览调试
或者直接作用组合命令
$ hexo deploy -g
$ hexo server -g
简写：
hexo n == hexo new
hexo g == hexo generate
hexo s == hexo server
hexo d == hexo deploy

Hexo + github 构建博客

概况

安装准备

安装Node

安装Git

安装Sublime