本文针对Mac下超初级用户,已入门者请略过。
1. 检查环境
据说程序员有三大金句:不可能/你环境有问题/你不会用
。所以我们先检查一下环境。
Terminal将是我们接下来一直会用到的工具。在Spotlight中或者lauchpad搜索,打开它。
1.1 Git
Terminal中输入git
,如果返回如下内容,证明ok.
usage: git [--version] [--help] [-C <path>] [-c name=value]
[--exec-path[=<path>]] [--html-path] [--man-path] [--info-path]
[-p | --paginate | --no-pager] [--no-replace-objects] [--bare]
[--git-dir=<path>] [--work-tree=<path>] [--namespace=<name>]
<command> [<args>]
These are common Git commands used in various situations:
....
如果没有,可以通过Homebrew, MacPorts 或者安装包进行安装.
1.2. NodeJS
我们使用NVM来管理NodeJS的版本,所以先安装NVM。在Terminal中输入
curl https://raw.githubusercontent.com/creationix/nvm/master/install.sh | sh
回车,等待安装。一旦安装完成,在Terminal中输入nvm install stable
来安装稳定版本的nodejs.
安装完成后, 在terminal中输入node --version
,
此时应该可以看到如下信息:
6.1.0 # 这里显示了安装的版本号
1.3 进入正题:安装Hexo
在自己的电脑中新建一个目录来存放自己的Blog吧,这里我建立了一个名为Hexo
的文件夹,然后在Finder中拖动这个文件夹到Terminal中,接着回车,就在Terminal中进入了这个目录。接着输入命令:
npm install -g hexo-cli
g
代表全局安装,这样在termnial中,任何路径下都能够使用命令hexo
了。
2. 创建Blog
2.1 hexo init & hexo server
Terminla输入hexo init blog
,
完成后Hexo
文件夹下会出现blog
文件夹。cd blog
,进入到blog文件夹中,然后hexo server
,
不久会返回以下信息:
INFO Start processing
INFO Hexo is running at http://localhost:4000/. Press Ctrl+C to stop.
启动完成,在浏览器中打开上述地址http://localhost:4000/
,
没错的话应该可以看到自己的网站了。想要退出进程请按Ctrl + C
。
2.2 修改配置
blog
文件夹中的目录应当如下图所示,
.
├── _config.yml # 这个文件用来配置相关信息
├── package.json
├── scaffolds
├── source
| ├── _drafts
| └── _posts
└── themes
配置的相关信息,参见这里
2.3 hexo new post “magic”
使用如下命令来创建我们的第一篇帖子:
hexo new post "magic" # 引号内的是hexo将创建的post名称
得到返回如下 :
⇒ hexo new post "magic"
INFO Created: ~/Hexo/blog/source/_posts/magic.md
可以看到我们创建了magic.md
,
位置是~/Hexo/blog/source/_posts/
.
👌,.md
后缀一般涌来代表这是一个markdown文件,使用markdown编辑器打开magic.md
.
发现内容如下:
---
title: magic
date: 2017-03-01 00:40:02
tags:
---
## 我们这部分书写自己的内容, 注意需要学习一下Markdown语法
2.4 hexo generate
参见https://hexo.io/docs/generating.html
使用如下命令来生成博客的文件:
hexo generate
或者直接打hexo g
等待一会,blog
文件夹下应该出现了一个新的文件夹,名称叫做public
。
public
文件夹中的内容,就是所有生成好的Blog文件。这一部分,我们可以上传到Github上。
3. 上传Github
参见https://hexo.io/docs/deployment.html
安装 hexo-deployer-git, 在terminal中键入
npm install hexo-deployer-git --save
在_config.yml
中的deploy
填写上如下信息:
deploy:
type: git
repo: GIT的地址
branch: master #一般是master吧
接着,在Terminal中的输入hexo deploy
或hexo deploy
,完成。
4. 开启Github Pages
在github仓库的设置页面中,可以找到Github Pages的选项,选择开启后就会获得一个子域名。接着用这个域名访问就好了。