导语

  • 关于Hexo

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

  • Hexo的安装及配置

    安装前提

    安装 Hexo 相当简单。然而在安装前，您必须检查电脑中是否已安装下列应用程序：

    Node.js
    Git

    如果您的电脑中已经安装上述必备程序，那么恭喜您！接下来只需要使用 npm 即可完成 Hexo 的安装。

    1
    $ npm install -g hexo-cli

    所有必备的应用程序安装完成后，即可使用 npm 安装 Hexo。
    安装 Hexo 完成后，请执行下列命令，Hexo 将会在指定文件夹中新建所需要的文件。

    1
    2
    3
    $ hexo init <folder>
    $ cd <folder>
    $ npm install

    新建完成后，指定文件夹的目录如下：

    1
    2
    3
    4
    5
    6
    7
    8
    .
    ├── _config.yml
    ├── package.json
    ├── scaffolds
    ├── source
    |   ├── _drafts
    |   └── _posts
    └── themes

    否则，请先安装上述应用程序，这里不再细述。

其他介绍，请到官方网站

Git及相关操作

  • 安装Git客户端

    Windows：下载并安装 git.
    Mac：使用 [Homebrew], [MacPorts] 或[下载] 安装程序 安装。
    Linux (Ubuntu, Debian)：sudo apt-get install git-core
    Linux (Fedora, Red Hat, CentOS)：sudo yum install git-core

  • 生成密钥，并配置到Github

    检查SSH keys的设置

    首先我们需要检查你电脑上现有的ssh key：

    1
    $ cd ~/. ssh 检查本机的ssh密钥

    如果提示：No such file or directory 说明你是第一次使用git。

    生成新的SSH Key：
    1
    2
    3
    4
    5
    6
    $ 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):<回车>

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

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

    添加SSH Key到GitHub

    在本机设置SSH Key之后，需要添加到GitHub上，以完成SSH链接的设置。

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

    若有问题，请参考Generating an SSH key

    测试

    可以输入下面的命令，看看设置是否成功，git@github.com的部分不要修改：

    1
    $ ssh -T git@github.com

  • Github上的其他设置

    创建仓库，并设置主页

    登录后系统，在github首页，点击页面右下角「New Repository」;

    填写项目信息：

    project name：waterjim.github.io
    description： 仓库描述

    注：Github Pages的Repository名字是特定的，比如我的Github账号为waterjim，那么我Github Pages Repository名字就是waterjim.github.io
    点击「Create Repository」 完成创建。

创建新博文及提交

使用以下命令创建新的博文

1
$ hexo new "新博文标题"

然后使用Markdown编辑器进行博文编写。同时在发布之前，需要进行一下操作：
安装deploy

1
$ npm install hexo-deployer-git --save

需要对Hexo配置文件进行一些配置：

1
2
3
4
deploy:
  type: git  
  repo: git@github.com:WaterJim/waterjim.github.io.git
  branch: master

执行一下命令(Window平台需要使用Git Bash执行下面命令)

1
2
3
$ hexo clean
$ hexo g
$ hexo d

这时候可以访问你的网站是否已经发布成功。如我的博客：http://waterjim.github.io/

其他