使用Hexo在GitHub上搭建静态博客

发表于   |   分类于   |  

当初搭建这个静态博客参考了好几篇文章，但是还是碰到了不少问题，想想应该整理一下让后来人少走点弯路，我就是这么伟大，请给我点32个赞（此处应有掌声）。

工欲善其事 必先利其器

  1. Git客户端(博客部署)

    GitHub for Windows（已更名为GitHub Desktop） 下载

    GitHub for Windows是先下载安装器，然后运行安装器在线安装，如果在线安装过程中出现下载进度不动或下载不成功的情况，恭喜你被墙了，请自行查找科学上网方法，设置为系统全局代理后再尝试。

  2. Node.js(Hexo依赖)

    Node.js 下载

    Node.js安装完成后会自动添加环境变量，如果在步骤3中使用npm命令提示不存在，则请自行在环境变量Path中添加如下内容（默认Node.js安装目录为C:\Program Files\nodejs）：
    ;C:\Program Files\nodejs\node_modules\npm

  3. Hexo(博客框架，使用Markdown解析文章)

    Hexo 官网（无需下载）

    完成上述步骤后，双击桌面上的Git Shell，输入如下npm命令回车执行等待安装完成即可：
    npm install -g hexo-cli

  4. 创建Hexo工作空间

    安装 Hexo 完成后，在磁盘任意位置建立文件夹比如D:/hexo,双击桌面上Git Shell，通过CD命令切换到该目录后执行如下两行命令初始化该工作空间并安装hexo所有插件：
    hexo init
    npm install

创建博客容身之所

  • 注册GitHub账号

  1. 登录GitHub，选择Sign Up注册GitHub账户，注意此处注册的账号名称决定将来访问你的博客的路径。比如你注册的账号用户名为jellybins（以下部分也用该示例），则将来访问你博客的路径为http://jellybins.github.io 。

  2. 创建GitHub博客仓储，注册完成后登录GitHub选择New Repository，创建名称为jellybins.github.io的Repository(jellybins为示例，必须保证Repository名称中该部分和注册账户名称一致)。

  3. 首次创建后等待几分钟左右审核，之后即可访问静态主页如http://jellybins.github.io （jellybins为示例） 。

  • 登录GitHub for Windows，部署博客内容至GitHub

  1. 双击击桌面上GitHub 图标，登录上述注册的GitHub账户，程序会自动设置GitHub全局变量并添加SSH访问密钥。

  2. 进入Hexo工作空间目录中，用记事本等文本编辑器打开_config.yml文件，更改deploy项内容如下（注意上述键和值之间有空格，格式不正确会导致部署失败，jellybins为示例，请更改为自己注册的账户名）：

    deploy:
    type: git
    repo: git@github.com:jellybins/jellybins.github.io.git

  3. 双击桌面上Git Shell图标，通过CD命令切换到Hexo工作空间目录，然后执行如下命令完成博客部署至GitHub

    hexo clean
    hexo generate
    hexo server（可选命令——本地http://localhost:4000 端口预览博客效果，快捷键Ctrl+C停止预览）
    hexo deploy

  4. 以后每次完成新博客文章要发布时，重新执行步骤3中各命令即可。

  5. 访问博客地址http://jellybins.github.io 查看效果（jellybins为示例）。

博客设置及主题更换

  1. 进入Hexo工作空间目录，用记事本或EditPlus等文本编辑工具打开_config.yml文件。

  2. 各参数作用：

    • title 网站标题
    • subtitle 网站副标题
    • description 网站描述
    • author 您的名字
    • language 网站使用的语言
    • theme 当前主题名称（通过更改该名称更改博客使用的主题）
    • deploy 部署配置（上面将博客部署至GitHub已提到）

  3. 上述各参数的值在书写时一定要注意每项参数冒号后要有一个英文空格符，然后再填写该项的值。

  4. 更改主题方法：

    a. 从该链接选择你想要使用的Hexo主题。

    b. 双击Git Shell图标，CD命令切换至Hexo工作空间目录后，执行如下命令（以yilia主题为例）:

    git clone https://github.com/litten/hexo-theme-yilia.git themes/yilia

    c. 修改_config.yml文件的theme值如下：

    theme: yilia(注意参数与值之间空格)

    d. 当主题有更新时，双击Git Shell图标，通过CD命令进入Hexo工作空间/themes/yilia目录后执行如下命令更新主题：

    git pull

博客文章发布

  1. 创建新文章,双击Git Shell图标，CD命令切换至Hexo工作空间目录后,执行如下命令：

    hexo new ‘新文章标题’(如文章标题不含空格则引号可省略)

  2. 执行完上述命令会在hexo工作空间/source/_posts目录下生成”新文章标题.md”的文件，此时用记事本等文本编辑器工具打开文件，使用markdown语法编辑文章即可。

  3. 编辑完成后保存上述文件，执行部署博客内容至GitHub操作中步骤3各命令后博客文章发布完成。