Hexo 基本配置

Hexo全局基础配置

用文本编辑器修改 _config.yml 这个文件,大致如下,只需要自动修改几个其他保持默认即可。
通常需要修改站点名称/URL 格式/归档设置/Disqus 评论用户名/部署配置,这几项就可以了,注意冒号后面都要添加一个半角空格,之后才是设置参数。
自定义域名设置在 source 文件夹下面新建 CNAME 文件,里面写入你的自定义域名,并设置你的 dns 配置 cname 方式到服务器供应商给出的地址即可。

网站 Site

参数 描述
title 网站标题
subtitle 网站副标题
description 网站描述
author 你的名字
language 网站使用的语言
timezone 网站时区,Hexo 预设使用你电脑的时区,时区列表。

网址 URL

参数 描述 默认值
url 网址 http://yoursite.com/
root 网站根目录 /
permalink 文章的永久链接格式 :year/:month/:day/:title/
permalink_default 永久连接中各部分的默认值

网站存放在子目录
如果你的网站存放在子目录中,例如 http://yoursite.com/blog ,则请将 url 设为 http://yoursite/blog 并把 root 设为 /blog/。

目录 Directory

参数 描述 默认值
source_dir 资源文件夹,这个文件夹用来存放内容 source
public_dir 公共文件夹,这个文件夹用于存放生成的站点文件 public
tag_dir 标签文件夹 tags
archive_dir 归档文件夹 archives
category_dir 分类文件夹 categories
code_dir Incloud code 文件夹 downloads/code
i18n_dir 国际化(i18n)文件夹 lang
skip_render 跳过制定文件的渲染,你可以使用 glob 来配置路径。

文章 Writing

参数 描述 默认值
new_post_name 新文章的文件名称为 title.md
default_layout 预设布局 post
auto_spacing 在中文和英文之间加入空格 false
titlecase 把标题转化为 title case false
external_link 在新建标签中打开链接 true
filename_case 把文件名称转换为(1)小写或(2)大写 0
render_drafts 显示草稿 false
post_asset_folder 启动 Asset 文件夹 false
relative_link 把链接改为与根目录相对的位置 false
future 显示未来的文章标题 ture
highlight 代码块的设置

分类&标签 Category & Tag

参数 描述 默认值
default_category 默认分类 uncategoried
category_map 分类别名
tap_map 标签名称

日期/时间格式 Date / Time format

Hexo 使用 Moment.js 来解析和显示时间。

参数 描述 默认值
date_format 日期格式 MMM D YYYY
time_format 时间格式 H:mm:ss

分页 Pagination

参数 描述 默认值
per_page 每页显示的文章量(0=关闭分页功能) 10
pagination_dir 分页目录 page

扩展与部署 Extensions / Deployment

参数 描述
theme 当前主标题名称
deploy 部署

github和gitcafe多部署

修改_config.yml的deploy

1
2
3
4
5
6
deploy:
type: git
message: update ##git message 建议默认字段 update 可以自定义
repo:
gitcafe: <repository url>,[branch] ##gitcafe 仓库地址和分支
github: <repository url>,[branch] ##github 仓库地址和分支

repository url 都使用SSH链接可免密码操作

分别在 github 和 gitcafe 创建项目

生成.ssh,添加到

GitHub -> settings -> SSH keys
GitCafe -> 账户设置 -> SSH公匙管理

创建一个与用户名(如果是组织,就是组织名)相同名称的项目
【github 项目名要加上 .github.io

GitHub Pages 服务分支在 master
GitCafe Pages 服务分支在 gitcafe-pages

1
2
hexo g
hexo d

【2016/04/13更新】gitcafe整体被coding收购,按照下面两篇文章来在coding上搭建hexo,感觉比gitcafe稳定

  1. 在 Coding 上搭建 Hexo 个人博客!
  2. hexo干货系列:(四)将hexo博客同时托管到github和coding

域名绑定

  1. 在source文件夹里创建CNAME文件,里面添加你的域名信息:yoursite.com(注意前面不添加http://)
  2. 域名解析网站,添加域名,添加记录【国内解析到 GitCafe ,默认解析到 GitHub 】
    domain

GitHub 解析到 项目名.github.io
GitCafe 解析到 gitcafe.io【GitCafe还要根据 相关链接2 设置自定义域名】

问题解决

  • hexo d 部署提示找不到git,hexo s 执行hexo server提示找不到该指令
  • 在Hexo 3.0版本后 deploy githexo server 被分开,需先进行安装:npm install hexo-deployer-git --save npm install hexo-server --save

相关链接

  1. Git教程 - 廖雪峰的官方网站 http://www.liaoxuefeng.com/wiki/0013739516305929606dd18361248578c67b8067c8c017b000
  2. gitcafe Pages 相关帮助 https://gitcafe.com/GitCafe/Help/wiki/Pages-%E7%9B%B8%E5%85%B3%E5%B8%AE%E5%8A%A9
  3. Hexo 3.0 静态博客使用指南 https://help.gitcafe.com/practices/hexo
  4. zipperar的hexo相关教程 http://zipperary.com/categories/hexo/
  5. Hexo 搭建博客-基础配置篇 http://www.jianshu.com/p/df3edc4286d2
文章目录
  1. 1. Hexo全局基础配置
    1. 1.1. 网站 Site
    2. 1.2. 网址 URL
    3. 1.3. 目录 Directory
    4. 1.4. 文章 Writing
    5. 1.5. 分类&标签 Category & Tag
    6. 1.6. 日期/时间格式 Date / Time format
    7. 1.7. 分页 Pagination
    8. 1.8. 扩展与部署 Extensions / Deployment
  2. 2. github和gitcafe多部署
    1. 2.1. 修改_config.yml的deploy
    2. 2.2. 分别在 github 和 gitcafe 创建项目
    3. 2.3. 域名绑定
  3. 3. 问题解决
  4. 4. 相关链接

20160202-learn-hexo/

本页二维码