准备搭建 HEXO 博客

HEXO

04 May., 2016 是不是应该转向 Jekyll 呢，GitHub 上面是直接推荐使用 Jekyll的。
https://help.github.com/articles/about-github-pages-and-jekyll/

HEXO 上面有很多个响应式主题，那么 Jekyll 上有没有呢？

Hexo is a fast, simple and powerful blog framework. You write posts in Markdown (or other languages) and Hexo generates static files with a beautiful theme in seconds.

大致了解了一下，搭建HEXO博客的门槛不算高。我觉得可以完成，但是最近事情比较多。不能不务正业，作为一个博士生，首先要搞好自己的科研，否则真的是无颜面对江东父老。

预计发完论文之后开始着手做这件事。

网上也有些这方面的教程，但是这次我不想参考任何二手资料，我要在 HEXO 的documentation帮助之下独立完成。
这玩意比做模拟，分析结果，发paper简单多了。难道不是吗？

没忍住，试了一下，嘿嘿成功了，可以说整个过程还是很简单的，完全没有参考任何二手资料，全部来及 doc 和自己的悟性，总结一下吧。
首先按照 HEXO 里给出的安装过程一步一步安装环境。

环境搭建

Git 因为之前已经安装过GitHub Desktop，所以有Git环境无需再次安装；
Node.js 下载安装包安装即可，因为最新版的node已经包含了npm所以我们可以直接进行后面的操作即在 npm 中安装 HEXO ；
确认一下 Node 安装正确，输入node -v 查看，同时检查一下npm；
确认无误后使用 npm 来安装 HEXO ，输入命令 npm install -g hexo-cli

安装环境

这个过程所有的命令行操作记录如下：

PS C:\Users\DELL> node -v
v6.0.0
PS C:\Users\DELL> npm -v
3.8.6
PS C:\Users\DELL> npm

Usage: npm 

where  is one of:
    access, adduser, bin, bugs, c, cache, completion, config,
    ddp, dedupe, deprecate, dist-tag, docs, edit, explore, get,
    help, help-search, i, init, install, install-test, it, link,
    list, ln, logout, ls, outdated, owner, pack, ping, prefix,
    prune, publish, rb, rebuild, repo, restart, root,
    run-script, s, se, search, set, shrinkwrap, star, stars,
    start, stop, t, tag, team, test, tst, un, uninstall,
    unpublish, unstar, up, update, v, version, view, whoami

npm  -h     quick help on 
npm -l           display full usage info
npm help   search for help on 
npm help npm     involved overview

Specify configs in the ini-formatted file:
    C:\Users\DELL\.npmrc
or on the command line via: npm  --key value
Config info can be viewed via: npm help config

[email protected] C:\Program Files\nodejs\node_modules\npm
PS C:\Users\DELL> npm install -g hexo-cli
C:\Users\DELL\AppData\Roaming\npm\hexo -> C:\Users\DELL\AppData\Roaming\npm\node_modules\hexo-cli\bin\hexo

> [email protected] install C:\Users\DELL\AppData\Roaming\npm\node_modules\hexo-cli\node_modules\dtrace-provider
> node scripts/install.js


> [email protected] postinstall C:\Users\DELL\AppData\Roaming\npm\node_modules\hexo-cli\node_modules\spawn-sync
> node postinstall


> [email protected] postinstall C:\Users\DELL\AppData\Roaming\npm\node_modules\hexo-cli\node_modules\hexo-util
> npm run build:highlight


> [email protected] build:highlight C:\Users\DELL\AppData\Roaming\npm\node_modules\hexo-cli\node_modules\hexo-util
> node scripts/build_highlight_alias.js > highlight_alias.json

C:\Users\DELL\AppData\Roaming\npm
`-- [email protected]
  +-- [email protected]
  +-- [email protected]
  +-- [email protected]
  | +-- [email protected]
  | +-- [email protected]
  | +-- [email protected]
  | | `-- [email protected]
  | +-- [email protected]
  | `-- [email protected]
  +-- [email protected]
  | +-- [email protected]
  | | +-- [email protected]
  | | | +-- [email protected]
  | | | `-- [email protected]
  | | |   +-- [email protected]
  | | |   | `-- [email protected]
  | | |   +-- [email protected]
  | | |   +-- [email protected]
  | | |   | +-- [email protected]
  | | |   | | `-- [email protected]
  | | |   | |   +-- [email protected]
  | | |   | |   +-- [email protected]
  | | |   | |   +-- [email protected]
  | | |   | |   `-- [email protected]
  | | |   | +-- [email protected]
  | | |   | `-- [email protected]
  | | |   +-- [email protected]
  | | |   | `-- [email protected]
  | | |   +-- [email protected]
  | | |   +-- [email protected]
  | | |   +-- [email protected]
  | | |   | `-- [email protected]
  | | |   +-- [email protected]
  | | |   +-- [email protected]
  | | |   | +-- [email protected]
  | | |   | | `-- [email protected]
  | | |   | `-- [email protected]
  | | |   +-- [email protected]
  | | |   | +-- [email protected]
  | | |   | `-- [email protected]
  | | |   `-- [email protected]
  | | |     +-- [email protected]
  | | |     `-- [email protected]
  | | +-- [email protected]
  | | +-- [email protected]
  | | +-- [email protected]
  | | +-- [email protected]
  | | | `-- [email protected]
  | | +-- [email protected]
  | | | `-- [email protected]
  | | +-- [email protected]
  | | `-- [email protected]
  | |   +-- [email protected]
  | |   | `-- [email protected]
  | |   |   +-- [email protected]
  | |   |   `-- [email protected]
  | |   `-- [email protected]
  | |     +-- [email protected]
  | |     +-- [email protected]
  | |     +-- [email protected]
  | |     +-- [email protected]
  | |     `-- [email protected]
  | `-- [email protected]
  +-- [email protected]
  | `-- [email protected]
  |   +-- [email protected]
  |   | `-- [email protected]
  |   +-- [email protected]
  |   +-- [email protected]
  |   | +-- [email protected]
  |   | | `-- [email protected]
  |   | +-- [email protected]
  |   | `-- [email protected]
  |   |   `-- [email protected]
  |   |     +-- [email protected]
  |   |     | `-- [email protected]
  |   |     `-- [email protected]
  |   `-- [email protected]
  +-- [email protected]
  | +-- [email protected]
  | | +-- [email protected]
  | | | `-- [email protected]
  | | `-- [email protected]
  | +-- [email protected]
  | | +-- [email protected]
  | | | +-- [email protected]
  | | | | +-- [email protected]
  | | | | `-- [email protected]
  | | | `-- [email protected]
  | | |   +-- [email protected]
  | | |   | `-- [email protected]
  | | |   `-- [email protected]
  | | `-- [email protected]
  | |   +-- [email protected]
  | |   | +-- [email protected]
  | |   | `-- [email protected]
  | |   `-- [email protected]
  | +-- [email protected]
  | +-- [email protected]
  | `-- [email protected]
  +-- [email protected]
  +-- [email protected]
  `-- [email protected]
    `-- [email protected]

npm WARN optional Skipping failed optional dependency /hexo-cli/chokidar/fsevents:
npm WARN notsup Not compatible with your operating system or architecture: [email protected]

初始化

现在前期准备工作已经能够完毕，接下来使用 HEXO 命令来进行初始化（还记得在win上使用 Git 客户端进行初始化吗 Git init）

使用 HEXO 命令来初始化为：

$ hexo init 
$ cd 
$ npm install

就是我们要放文档的地方，注意每次使用的命令行操作的时候要切换到这个目录下面

PS C:\Users\DELL> hexo init C:\Users\DELL\Documents\HEXO
INFO  Cloning hexo-starter to ~\Documents\HEXO
'git' 不是内部或外部命令，也不是可运行的程序
或批处理文件。
WARN  git clone failed. Copying data instead
INFO  Install dependencies
npm WARN prefer global [email protected] should be installed with -g

> [email protected] install C:\Users\DELL\Documents\HEXO\node_modules\dtrace-provider
> node scripts/install.js


> [email protected] postinstall C:\Users\DELL\Documents\HEXO\node_modules\spawn-sync
> node postinstall


> [email protected] postinstall C:\Users\DELL\Documents\HEXO\node_modules\hexo-util
> npm run build:highlight


> [email protected] build:highlight C:\Users\DELL\Documents\HEXO\node_modules\hexo-util
> node scripts/build_highlight_alias.js > highlight_alias.json

[email protected] C:\Users\DELL\Documents\HEXO
+-- [email protected]
| +-- [email protected]
| +-- [email protected]
| +-- [email protected]
| +-- [email protected]
| | +-- [email protected]
| | +-- [email protected]
| | +-- [email protected]
| | | `-- [email protected]
| | +-- [email protected]
| | `-- [email protected]
| +-- [email protected]
| | +-- [email protected]
| | | +-- [email protected]
| | | +-- [email protected]
| | | +-- [email protected]
| | | `-- [email protected]
| | +-- [email protected]
| | | `-- [email protected]
| | +-- [email protected]
| | +-- [email protected]
| | | +-- [email protected]
| | | +-- [email protected]
| | | +-- [email protected]
| | | `-- [email protected]
| | |   +-- [email protected]
| | |   +-- [email protected]
| | |   `-- [email protected]
| | `-- [email protected]
| |   +-- [email protected]
| |   +-- [email protected]
| |   +-- [email protected]
| |   +-- [email protected]
| |   +-- [email protected]
| |   +-- [email protected]
| |   | +-- [email protected]
| |   | +-- [email protected]
| |   | +-- [email protected]
| |   | | +-- [email protected]
| |   | | +-- [email protected]
| |   | | +-- [email protected]
| |   | | +-- [email protected]
| |   | | +-- [email protected]
| |   | | `-- [email protected]
| |   | `-- [email protected]
| |   +-- [email protected]
| |   +-- [email protected]
| |   +-- [email protected]
| |   | +-- [email protected]
| |   | +-- [email protected]
| |   | +-- [email protected]
| |   | | `-- [email protected]
| |   | |   `-- [email protected]
| |   | +-- [email protected]
| |   | +-- [email protected]
| |   | | `-- [email protected]
| |   | +-- [email protected]
| |   | +-- [email protected]
| |   | +-- [email protected]
| |   | | `-- [email protected]
| |   | +-- [email protected]
| |   | | +-- [email protected]
| |   | | | `-- [email protected]
| |   | | +-- [email protected]
| |   | | | +-- [email protected]
| |   | | | +-- [email protected]
| |   | | | | `-- [email protected]
| |   | | | +-- [email protected]
| |   | | | `-- [email protected]
| |   | | `-- [email protected]
| |   | |   `-- [email protected]
| |   | +-- [email protected]
| |   | | +-- [email protected]
| |   | | +-- [email protected]
| |   | | +-- [email protected]
| |   | | `-- [email protected]
| |   | +-- [email protected]
| |   | | +-- [email protected]
| |   | | +-- [email protected]
| |   | | | +-- [email protected]
| |   | | | +-- [email protected]
| |   | | | `-- [email protected]
| |   | | `-- [email protected]
| |   | |   +-- [email protected]
| |   | |   +-- [email protected]
| |   | |   +-- [email protected]
| |   | |   | `-- [email protected]
| |   | |   +-- [email protected]
| |   | |   +-- [email protected]
| |   | |   | `-- [email protected]
| |   | |   +-- [email protected]
| |   | |   +-- [email protected]
| |   | |   `-- [email protected]
| |   | +-- [email protected]
| |   | +-- [email protected]
| |   | +-- [email protected]
| |   | +-- [email protected]
| |   | +-- [email protected]
| |   | +-- [email protected]
| |   | +-- [email protected]
| |   | `-- [email protected]
| |   +-- [email protected]
| |   +-- [email protected]
| |   +-- [email protected]
| |   +-- [email protected]
| |   +-- [email protected]
| |   | `-- [email protected]
| |   `-- [email protected]
| +-- [email protected]
| | `-- [email protected]
| +-- [email protected]
| +-- [email protected]
| | +-- [email protected]
| | | +-- [email protected]
| | | | +-- [email protected]
| | | | `-- [email protected]
| | | |   +-- [email protected]
| | | |   | `-- [email protected]
| | | |   +-- [email protected]
| | | |   +-- [email protected]
| | | |   | +-- [email protected]
| | | |   | | `-- [email protected]
| | | |   | |   +-- [email protected]
| | | |   | |   +-- [email protected]
| | | |   | |   | `-- [email protected]
| | | |   | |   +-- [email protected]
| | | |   | |   `-- [email protected]
| | | |   | +-- [email protected]
| | | |   | `-- [email protected]
| | | |   +-- [email protected]
| | | |   | `-- [email protected]
| | | |   +-- [email protected]
| | | |   +-- [email protected]
| | | |   +-- [email protected]
| | | |   | `-- [email protected]
| | | |   +-- [email protected]
| | | |   +-- [email protected]
| | | |   | +-- [email protected]
| | | |   | | `-- [email protected]
| | | |   | `-- [email protected]
| | | |   +-- [email protected]
| | | |   | +-- [email protected]
| | | |   | `-- [email protected]
| | | |   `-- [email protected]
| | | |     +-- [email protected]
| | | |     `-- [email protected]
| | | +-- [email protected]
| | | +-- [email protected]
| | | +-- [email protected]
| | | +-- [email protected]
| | | | `-- [email protected]
| | | +-- [email protected]
| | | | `-- [email protected]
| | | +-- [email protected]
| | | `-- [email protected]
| | |   +-- [email protected]
| | |   `-- [email protected]
| | |     +-- [email protected]
| | |     +-- [email protected]
| | |     `-- [email protected]
| | `-- [email protected]
| +-- [email protected]
| | `-- [email protected]
| +-- [email protected]
| | `-- [email protected]
| |   +-- [email protected]
| |   | `-- [email protected]
| |   +-- [email protected]
| |   | +-- [email protected]
| |   | `-- [email protected]
| |   |   `-- [email protected]
| |   |     +-- [email protected]
| |   |     | `-- [email protected]
| |   |     `-- [email protected]
| |   `-- [email protected]
| +-- [email protected]
| | +-- [email protected]
| | | +-- [email protected]
| | | | `-- [email protected]
| | | `-- [email protected]
| | +-- [email protected]
| | | +-- [email protected]
| | | | +-- [email protected]
| | | | | +-- [email protected]
| | | | | `-- [email protected]
| | | | `-- [email protected]
| | | |   +-- [email protected]
| | | |   | `-- [email protected]
| | | |   `-- [email protected]
| | | `-- [email protected]
| | |   +-- [email protected]
| | |   | +-- [email protected]
| | |   | | `-- [email protected]
| | |   | `-- [email protected]
| | |   `-- [email protected]
| | +-- [email protected]
| | +-- [email protected]
| | `-- [email protected]
| +-- [email protected]
| | +-- [email protected]
| | `-- [email protected]
| +-- [email protected]
| +-- [email protected]
| | `-- [email protected]
| |   +-- [email protected]
| |   `-- [email protected]
| +-- [email protected]
| +-- [email protected]
| +-- [email protected]
| | +-- [email protected]
| | `-- [email protected]
| |   +-- [email protected]
| |   +-- [email protected]
| |   | `-- [email protected]
| |   +-- [email protected]
| |   +-- [email protected]
| |   | `-- [email protected]
| |   |   `-- [email protected]
| |   +-- [email protected]
| |   | +-- [email protected]
| |   | | `-- [email protected]
| |   | `-- [email protected]
| |   +-- [email protected]
| |   `-- [email protected]
| +-- [email protected]
| +-- [email protected]
| | `-- [email protected]
| +-- [email protected]
| | +-- [email protected]
| | | +-- [email protected]
| | | `-- [email protected]
| | `-- [email protected]
| |   +-- [email protected]
| |   +-- [email protected]
| |   +-- [email protected]
| |   `-- [email protected]
| |     +-- [email protected]
| |     +-- [email protected]
| |     `-- [email protected]
| +-- [email protected]
| | `-- [email protected]
| |   `-- [email protected]
| +-- [email protected]
| +-- [email protected]
| | `-- [email protected]
| +-- [email protected]
| `-- [email protected]
|   +-- [email protected]
|   | +-- [email protected]
|   | +-- [email protected]
|   | `-- [email protected]
|   +-- [email protected]
|   | `-- [email protected]
|   `-- [email protected]
|     +-- [email protected]
|     `-- [email protected]
+-- [email protected]
| +-- [email protected]
| | `-- [email protected]
| `-- [email protected]
+-- [email protected]
| `-- [email protected]
+-- [email protected]
| `-- [email protected]
+-- [email protected]
+-- [email protected]
| `-- [email protected]
+-- [email protected]
| `-- [email protected]
+-- [email protected]
| +-- [email protected]
| | `-- [email protected]
| |   +-- [email protected]
| |   | `-- [email protected]
| |   |   `-- [email protected]
| |   +-- [email protected]
| |   +-- [email protected]
| |   `-- [email protected]
| `-- [email protected]
|   +-- [email protected]
|   +-- [email protected]
|   | `-- [email protected]
|   +-- [email protected]
|   | `-- [email protected]
|   |   +-- [email protected]
|   |   `-- [email protected]
|   +-- [email protected]
|   | `-- [email protected]
|   +-- [email protected]
|   `-- [email protected]
|     `-- [email protected]
`-- [email protected]
  +-- [email protected]
  | +-- [email protected]
  | | +-- [email protected]
  | | `-- [email protected]
  | +-- [email protected]
  | +-- [email protected]
  | | `-- [email protected]
  | +-- [email protected]
  | `-- [email protected]
  +-- [email protected]
  | +-- [email protected]
  | | `-- [email protected]
  | `-- [email protected]
  +-- [email protected]
  +-- [email protected]
  | +-- [email protected]
  | +-- [email protected]
  | `-- [email protected]
  |   `-- [email protected]
  +-- [email protected]
  `-- [email protected]
    +-- [email protected]
    `-- [email protected]
      +-- [email protected]
      +-- [email protected]
      +-- [email protected]
      +-- [email protected]
      +-- [email protected]
      `-- [email protected]

npm WARN optional Skipping failed optional dependency /chokidar/fsevents:
npm WARN notsup Not compatible with your operating system or architecture: [email protected]
INFO  Start blogging with Hexo!
PS C:\Users\DELL>

不知道为什么提示'git' 不是内部或外部命令，也不是可运行的程序或批处理文件。但是看到最后的提示信息：INFO Start blogging with Hexo! 我确信可以开启 HEXO之旅了。浪里格朗~~浪里格朗~~

由于现在使用GitHub Desktop 不太清楚命令行的操作，试验了一下，只有使用 GitShell的命令窗口才能执行 git 命令，不知为何、、、
另外若额外安装 Git 是否需要 -g 参数啊？

使用 HEXO 来创建网页

从这里开始不要再看官方的 doc ，里面对这个没有明确的操作流程介绍，只是列出了一些命令。但是仅仅知道这几个命令可能还不知道怎么没去生成网页并在 http://localhost:4000/ 浏览。

命令介绍

确实，目前为止，我接触 HEXO 总时间一个小时都不到，并且几乎没有任何网站管理维护基础，我对 HEXO 的理解可能有很多不当之处，就这个网页发布的过程，我的理解是：

使用 $ hexo publish file_name 命令将把存在于 %/source/_drafts/ 下面的这个 file_name.md 文档传入解释器生成 HTML 并同时将源文件从 %/source/_drafts/ 挪动到 %/source/_posts/

需要注意的是

HEXO 在处理 MD 文档时候需要其具有特定的格式。用平时写的一个文档放进去测试时候会发生一些问题，比如：
YAMLException: a line break is expected at line 1, column 2:
因为我已经成功发布了里面的 HELLO_WORLD，看到这个毫无疑问是文档格式问题。

打开范例 Hello-world.md ，人家的开头是这样的，那咱也改改吧。不过它说的这个位置？？ line 1, column 2

---
title: Hello World
date: 2016-05-02 17:22:30
tags:
---

目录结构

好像还是没讲到怎么发布网页啊：

[将写好的 MD 文档存放在 /_drafts 下] [^注]，然后执行 $ hexo publish xyz 即可，文件名无需后缀。
查看网页需要启动 server， $ hexo server 然后打开 http://localhost:4000/ 即可浏览。

[注]：前面的 new generate 命令不是必须的。我们只要有 MD 文档即可。

效果

遗留问题

此问题已解决，确实是头部控制的文章列表里面题目都是 Hello World 可是我的文件名明明是 TEST 啊，回去查看 MD 文档，可能是这里面的 title 词条控制的，但是我也不清楚是如何添加上去的，改天再细细研究。

MD文档头部

标题自己控制

HEXO 渲染效果展示

我们也可以看出 HEXO 的解析结果有一些不太好的地方，例如引用里面的无序列表竟然居中对齐。[TOC]不被支持。

规划

完善 HEXO 知识；
继续学习 Git/GitHub；
使用 HEXO + GitHub 创建博客；
- 是否可使用外部解析器+CSS/HTML模板控制页面样式？

还有其他问题，参考 Trouble Shooting

03 May., 2016
卸载了 HEXO，Node.js 有时间再独立重新弄一次。

13 May., 2016
步骤与方法：

安装 Node.js（安装包）
使用NPM安装 HEXO $ npm install -g hexo-cli（普通命令行，不要使用Node命令行）

NPM不能在NODE命令行使用
使用 cd 的方法站到某个想放资料的目录，我的是C:\Users\DELL\Documents\HEXO 然后执行 HEXO init
现在已经可以开始写博客了，里面自带一个helloword，hexo g 就发布好了，然年后hexo s 在本地localhost:4000查看。但是为了把他发布到GitHub需要git。
下载安装包安装 Git（不能使用GitHub，在 HEXO d 的时候，GitHub会提示找不到deployer：git。虽然在安装 HEXO的时候使用GitHub的GitShell不会提示：git不可识别。。。）
仅仅安装Git还不够，还需要一个插件，安装 hexo-deployer-git $ npm install hexo-deployer-git --save（还得-save一下，不save也不行）
这一步还是在 C:\Users\DELL\Documents\HEXO 这个目录下面操作的
找到 C:\Users\DELL\Documents\HEXO\public文件夹，右键 Git Bash Here在此目录进行初始化生成 .git子目录 （当使用 Hexo 发布博客的时候聚会自动产生一个 public 文件夹我们只需要把这个文件夹全部放到github上就行了，别的文件夹不需要）
写好的博客看着顺眼了，直接一个 hexo d等待一会完事。

Git

去 http://mark-han.github.io/ 查看效果。
使用 hexo d 需要在 HEXO 目录下面的 _config.yml 文件里面进行配置。

deploy: 
  type: git
  repo: https://github.com/Mark-Han/Mark-Han.github.io.git `注：在GitHub上面直接复制链接，无须额外配置`
  brach: master

6666666666

我们当然可以把已经写好的 HTML 文档放在这里在hexo d 的时候一并推动过去，这里的 Mark.htnl 和 404 就是后来放上去的，以前写好的文件

ST 刚刚发布了最新更新，已经升级为最新版｛高兴｝

warning: LF will be replaced by CRLF in index.html.
The file will have its original line endings in your working directory.
Branch master set up to track remote branch master from https://github.com/Mark-
Han/Mark-Han.github.io.git.
To https://github.com/Mark-Han/Mark-Han.github.io.git
   47a3134..70a3fb5  HEAD -> master
INFO  Deploy done: git

Git在型我们要密码了

准备搭建 HEXO 博客

环境搭建

初始化

使用 HEXO 来创建 网页

遗留问题

规划

你可能感兴趣的:(准备搭建 HEXO 博客)

使用 HEXO 来创建网页