Preface
本来打算个人blog用英文写，BUT短时间内是不可能了，哈哈没办法，英语捉急，装逼未遂。之前是用jekyll搭建的，用的主题是歪果仁写的，有一些Google的东西还有字库神马的，虽然看起来高大上但是由于天朝一些不可抗力因素等等，总之页面加载很慢，有限的生命都浪费在看进度条上了。后来看到童鞋在用hexo，艾玛~人家这页面加载飕飕的，themes也正是我喜欢的Lofter风格，果断迁移啊！索性把之前博客园的几篇搬到这里了，以后专一写这个blog，不去其它地儿乱涂乱画了。
Hexo
关于hexo的介绍啥的，虽然你没问，但是我也就不说了。这里主要记录一下我搭建的过程以及遇到的一些细节问题。
Step1. 安装Git、Node.js以及npm工具
详情参考hexo文档
brew install git
bew install node
#查看是否安装成功
node -v
npm -v
Tip1:
Node 一般会安装在/usr/local/bin/node
npm 一般会安装在/usr/local/bin/npm
有时候会出现这种情况
zsh: command not found: balabalabala
这时候你需要把上述相应的地址添加到$PATH中，执行如下语句
export PATH=/usr/local/npm/bin:$PATH
Tip2:
也许你按照hexo文档安装的时候会出现类似如下情况
zsh: command not found: nvm
那么你可能是漏掉了这个步骤，可以理解为安装后还需要激活一下
source ~/.nvm/nvm.sh
Step2. 安装Hexo并创建文件
npm install hexo -g
hexo init #folder为你创建博客的文件夹名称
cd
这时候一个blog就已经搭建好了，folder的目录结构如下：
.
├── _config.yml # 配置文件
├── package.json
├── scaffolds
├── scripts
├── source
| ├── _drafts
| └── _posts # 写的文章都放到这个文件夹下
└── themes # 各种主题
默认的theme是landscape，可以在themes文件下看到，以后想换主题只需要将相应的主题包下载到themes文件夹下即可。在_posts文件夹中自带一篇hello world.md。
Step3. Hexo常用命令
hexo new "postName" #新建文章
hexo new page "pageName" #新建页面到上述目录结构的_posts中
hexo generate #生成静态页面至public目录
hexo server #开启预览访问端口（默认端口4000，'ctrl + c'关闭server）
hexo deploy #将.deploy目录部署到GitHub
#简写
hexo n == hexo new
hexo g == hexo generate
hexo s == hexo server
hexo d == hexo deploy
现在可以先运行一下看看
hexo server
然后，在浏览器中输入localhost:4000可以查看本地生成的效果。
Step4. 配置_config.yml文件
说明一下，这里有很多细节问题需要注意，我先把自己的配置放上来，然后慢慢说，先喝口水。
# Hexo Configuration
## Docs: http://hexo.io/docs/configuration.html
## Source: https://github.com/hexojs/hexo/
# Site
title: Beatrice7's Fancy
subtitle: To know enough to be dangerous
description: beatrice7's blog | font-end |
author: Beatrice
email: [email protected]
language: zh-CN
# URL
## If your site is put in a subdirectory, set url as 'http://yoursite.com/child' and root as '/child/'
url: http://beatrice7.tk
root: /
permalink: :year/:month/:day/:title/
tag_dir: tags
archive_dir: archives
category_dir: categories
code_dir: downloads/code
permalink_defaults:
# Directory
source_dir: source
public_dir: public
# Writing
new_post_name: :title.md # File name of new posts
default_layout: post
titlecase: false # Transform title into titlecase
external_link: true # Open external links in new tab
filename_case: 0
render_drafts: false
post_asset_folder: false
relative_link: false
highlight:
enable: true
line_number: true
tab_replace:
# Category & Tag
default_category: uncategorized
category_map:
tag_map:
# Archives
## 2: Enable pagination
## 1: Disable pagination
## 0: Fully Disable
archive: 1
category: 1
tag: 1
# Server
## Hexo uses Connect as a server
## You can customize the logger format as defined in
## http://www.senchalabs.org/connect/logger.html
port: 4000
server_ip: localhost
logger: false
logger_format: dev
# Date / Time format
## Hexo uses Moment.js to parse and display date
## You can customize the date format as defined in
## http://momentjs.com/docs/#/displaying/format/
date_format: MMM D YYYY
time_format: H:mm:ss
# Pagination
## Set per_page to 0 to disable pagination
per_page: 10
pagination_dir: page
# Disqus
disqus_shortname:
# Extensions
## Plugins: https://github.com/hexojs/hexo/wiki/Plugins
## Themes: https://github.com/hexojs/hexo/wiki/Themes
theme: landscape-plus
exclude_generator:
plugins:
- hexo-generator-feed
# Deployment
## Docs: http://hexo.io/docs/deployment.html
deploy:
type: github
repository: [email protected]:Beatrice7/Beatrice7.github.io.git
branch: master
网上的很多教程都已经说的很详细了，我这里说几点细节，也是我当时走的弯路
- Archives模块
默认里面写的是2，全都改成1，因为这里的注释是有些问题的，否则就不能在archive目录下按照年份月份归档文章了。 - Deployment模块
这部分只要按照我的设置就好，但是注意repository: [email protected]:后面添加的第一项是你github的名称；第二项是你的博客所在的库的名称，不要看到网上很多.com.git就照搬照抄哦。
Step5. 上传至github
hexo g
hexo d
Step6. 安装插件和主题
Hexo提供丰富的插件以及主题
安装方法如下：
npm install --save
git clone themes/
附上几篇更加详细的教程链接:
hexo你的博客
使用hexo搭建博客
通过Hexo在Github上搭建博客教程
Hexo常见问题解决方案
从jekyll迁移到hexo
Tip1:
很简单，只需要把原来的.md各种文件copy到_posts文件夹下即可，但这里有几点细节，需要在_config.yml中添加
new_post_name: :year-:month-:day-:title.md
我之前犯二，竟然把permalink: :year/:month/:day/:title/给改了，然后导致文章没有按照年月归档，全部生成在根目录了。前车之鉴，阅读文档时请务必保持头脑清醒！
Tip2:
关于代码块，你需要做一些替换。把之前的关键字highlight替换为codeblock; endhighlight替换为endcodeblock。
写在最后
呦西，第一篇教程性质的文章终于写粗来了。莫名的，竟生出一种无所不能的使命感，仿佛连期末考试都无需担心了。
2015年到来之前，再写一篇淡淡的总结就收工！