hexo

2016-11-09

hexo学习配置

学习链接

Hexo官网 (右侧可以选择中文简体)
http://hexo.io/

Hexo 入门
http://zipperary.com/categories/hexo/

Hexo Admin
http://jaredly.github.io/hexo-admin/

Hexo Theme wiki
https://github.com/hexojs/hexo/wiki/Themes

Hexo 静态blog搜索
https://swiftype.com/

Hexo 插件
http://hexo.io/plugins/

Hexo 插件wiki
https://github.com/hexojs/hexo-generator-feed

常见错误

git deploy上传时提示仓库不存在

删除主目录下的.deploy_git文件

Error: Cannot find module ‘./build/Release/DTraceProviderBindings’

错误下面有dtrace-provider.js:17:23这一行，也就是这个文件的位置
编辑这个文件/Users/liqi/Dropbox/programs/nodejs/buildlove.github.io/node_modules/.0.7.1@dtrace-provider/dtrace-provider.js直接注释掉

// var builds = ['Release', 'default', 'Debug'];

// for (var i in builds) {
//     try {
//         var binding = require('./build/' + builds[i] + '/DTraceProviderBindings');
//         DTraceProvider = binding.DTraceProvider;
//         break;
//     } catch (e) {
//         // if the platform looks like it _should_ have DTrace
//         // available, log a failure to load the bindings.
//         if (process.platform == 'darwin' ||
//             process.platform == 'sunos' ||
//             process.platform == 'freebsd') {
//             console.error(e);
//         }
//     }
// }

操作命令行

hexo new "postName" #新建文章
hexo new page "pageName" #新建页面
hexo generate #生成静态页面至public目录
hexo server #开启预览访问端口（默认端口4000，'ctrl + c'关闭server）
hexo deploy #将.deploy目录部署到GitHub
hexo deploy -g
hexo server -g
hexo n == hexo new
hexo g == hexo generate
hexo s == hexo server
hexo d == hexo deploy

配置文件

# Hexo Configuration
## Docs: http://hexo.io/docs/configuration.html
## Source: https://github.com/hexojs/hexo/

# Site
title: Screenshot 2015
subtitle: Stay hungry,stay foolish.
description: 'whatever'
author: Screenshot 2015
language: chinese
email: mkdir_yang@163.com
language: zh-CN
# language: zh-Hans

# URL
## If your site is put in a subdirectory, set url as 'http://yoursite.com/child' and root as '/child/'
url: http://buildlove.github.io
root: /
permalink: :year/:month/:day/:title/
permalink_defaults:
tag_dir: tags
archive_dir: archives
category_dir: categories
code_dir: downloads/code

# Directory
source_dir: source
public_dir: public
i18n_dir: :lang
skip_render:

# 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
max_open_file: 100
multi_thread: true
filename_case: 0
render_drafts: false
post_asset_folder: false
relative_link: false
future: true
highlight:
  enable: true
  line_number: false
  # auto_detect: false
  tab_replace:

# Category & Tag
default_category: uncategorized
category_map:
tag_map:

# Archives #存档，这里的说明好像不对。全部选择1，这个选项与主题中的选项有时候会有冲突
## 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: 4001
logger: true
logger_format:

# 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: YYYY-MM-DD
# date_format: MMM D YYYY
# time_format: HH:mm:ss
time_format: H:mm:ss

# Pagination 分页设置
## Set per_page to 0 to disable pagination
per_page: 10
pagination_dir: page

# Disqus #社会化评论disqus，我使用多说，在主题中配置
disqus_shortname:

# Extensions 插件
# Plugins: http://hexo.io/plugins/
# plugins: 最新版hexo注释掉不报错
#  - hexo-generator-feed
#  - hexo-generator-sitemap
# Themes: http://hexo.io/themes/
theme: pacman
# theme: next

# Deployment 部署
## Docs: http://hexo.io/docs/deployment.html
deploy:
  type: git
  # repository: https://github.com/buildlove/buildlove.github.io.git
  repo: https://github.com/buildlove/buildlove.github.io.git
  # repository: git@github.com:buildlove/buildlove.github.io.git
  # branch: gh-pages
  branch: master

# Others
index_generator:
  per_page: 5 ##首页默认10篇文章标题 如果值为0不分页

archive_generator:
  per_page: 0 ##归档页面默认10篇文章标题
  yearly: true  ##生成年视图
  monthly: true ##生成月视图

tag_generator:
  per_page: 0 ##标签分类页面默认10篇文章

category_generator:
  per_page: 0 ###分类页面默认10篇文章

// rss: /atom.xml 最新版注释掉也能用

sitemap:
  path: sitemap.xml

#sitemap
baidusitemap:
  path: baidusitemap.xm

swift_search:
  enable: true

配置域名

在 /source 目录下添加 CNAME 文件, 文件内写入 buildlove.top 即可(域名解析不说了)

目录结构

.
├── .deploy
├── public
├── scaffolds
├── scripts
├── source
|   ├── _drafts
|   └── _posts
├── themes
├── _config.yml
└── package.json
└── package.json
.deploy：执行hexo deploy命令部署到GitHub上的内容目录
public：执行hexo generate命令，输出的静态网页内容目录
scaffolds：layout模板文件目录，其中的md文件可以添加编辑
scripts：扩展脚本目录，这里可以自定义一些javascript脚本
source：文章源码目录，该目录下的markdown和html文件均会被hexo处理。该页面对应repo的根目录，404文件、favicon.ico文件，CNAME文件等都应该放这里，该目录下可新建页面目录。
_drafts：草稿文章
_posts：发布文章
themes：主题文件目录
_config.yml：全局配置文件，大多数的设置都在这里
package.json：应用程序数据，指明hexo的版本等信息，类似于一般软件中的关于按钮