一、什么是hexo
Hexo是一个快速、简洁且高效的博客框架,使用Markdown(或其他渲染引擎)解析文章,在几秒内,即可利用靓丽的主题生成静态网页。目前比较火的vue和weex的文档都是使用hexo框架实现的。
二、hexo的安装
安装hexo前,确保电脑中已经安装了node和git。
node安装
方法一、
直接安装node:ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
方法二、
先安装homebrew: /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
后安装node:brew install node
git安装
先安装homebrew: /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
后安装git:brew install git
hexo安装
npm install -g hexo-cli
三、创建项目
新建项目:
hexo init folder
进入:
cd folder>
安装依赖包:
npm install
新建一篇文章:
hexo new iOS-APIs
(文件会在/source/_posts下)启动:
hexo server
浏览器打开:
http://localhost:4000/document/
四、hexo配置
配置文件为_config.yml
参考: https://hexo.io/docs/configur…
github: https://github.com/hexojs/hexo/
Site (网站)
网站标题
title: weex使用手册网站副标题
subtitle: weex中文手册网站描述
description: 整理weex手册, 包括通用特性, 内建组件, 内建模块, CSS 单位, 通用事件, Native DOM APIs, Weex 实例变量, Web 标准, JS Service, Vue, 高阶知识, 迁移作者名字
author: lu.wei网站使用的语言
language: 简体中文网站时区Hexo 默认使用您电脑的时区。时区列表。比如说:America/New_York, Japan, 和 UTC 。
timezone: UTC
URL (网址)
如果您的网站存放在子目录中,例如 http://yoursite.com/blog,则请将您的 url 设为 http://yoursite.com/blog 并把 root 设为 /blog/。
网站根目录
root: /document/文章的 永久链接 格式
permalink: :year/:month/:day/:title/永久链接中各部分的默认值
permalink_defaults:
Directory (目录)
资源文件夹,这个文件夹用来存放内容。
source_dir: source公共文件夹,这个文件夹用于存放生成的站点文件。
public_dir: public标签文件夹
tag_dir: tags归档文件夹
archive_dir: archives分类文件夹
category_dir: categoriesInclude code 文件夹
code_dir: downloads/code国际化(i18n)文件夹
i18n_dir: :lang跳过指定文件的渲染,您可使用 glob 表达式来匹配路径。
skip_render:
Writing (文章)
新建文章的文件名称
new_post_name: :title.md预设布局
default_layout: post在中文和英文之间加入空格
auto_spacing: false把标题转换为 title case
titlecase: false在新标签中打开链接
external_link: true把文件名称转换为 (1) 小写或 (2) 大写
filename_case: 0显示草稿
render_drafts: false启动 Asset 文件夹
post_asset_folder: true把链接改为与根目录的相对位址
relative_link: false显示未来的文章
future: true代码块的设置
highlight: enable: true line_number: true auto_detect: true tab_replace:
Home page setting (主页设置)
1. path: 博客索引页的跟路径,默认为空
2. per_page: 每页展示的文章量, 为0时表示不分页
3. order_by: 排序, 默认日期降序
index_generator:
path: ''
per_page: 10
order_by: -date
Category & Tag (分类 & 标签)
默认分类
default_category: uncategorized分类别名
category_map:标签别名
tag_map:
Date / Time format (日期 / 时间格式)
hexo使用Moment.js来解析和显示时间。
可以参照http://momentjs.com/docs/#/di…来自定义日期格式。
日期格式
date_format: YYYY-MM-DD时间格式
time_format: HH:mm:ss
Pagination (分页)
每页显示的文章量 (0 = 关闭分页功能)
per_page: 10分页目录
pagination_dir: page
Extensions (扩展)
插件: https://hexo.io/plugins/
主题: https://hexo.io/themes/
当前主题名称。值为false时禁用主题
theme: landscape
Deployment (部署)
参考: https://hexo.io/docs/deployme…
部署部分的配置
deploy: type: git repo: https://github.com/stardew516/document branch: master message: hexo + css
五、部署
github上部署:
安装hexo-deployer-git:
npm install hexo-deployer-git --save
_config.yml 中配置
# 部署部分的设置 deploy: type: git repo: https://github.com/stardew516/document branch: master message: hexo + css
终端进入目录,运行:
hexo deploy