Hexo是一个快速的、简单的、功能强大的博客框架。你可以通过Markdown语言写文章，然后hexo帮你生成一个带有漂亮主题的静态页面。
准备工作
1
|
$ npm install -g hexo-cli
|
1
2
|
$ hexo init // 初始化框架文件
$ npm install // 下载必要组件
|
目录结构
_config.yml 站点配置文件，很多全局配置都在这个文件中
package.json hexo版本信息，以及它所默认或者说依赖的一些组件
scaffolds 模版文件。创建新文章时，hexo会依据模版文件进行创建
scripts 放脚本的文件夹， 就是放js文件的地方
source 这个文件夹就是放文章(资源)的地方了
themes 主题文件夹
配置
配置介绍
文章声明
- YAML方式，以三短线结束
- JSON方式，以三分号结束
1
2
3
4
5
6
7
8
|
layout 设置布局一般默认
title 设置标题
date 设置文章时间
updated 修改时间
comments 是否开启评论默认true
tags 文章标签
categories 文章分类
permalink 文章永久链接
|
标签插件
可在文章中快速嵌入一些特殊的内容
信息引入
1
2
3
|
{% blockquote [author[, source]] [link] [source_link_title] %}
信息内容
{% endblockquote %}
|
代码块
1
2
3
|
{% codeblock [title] [lang:language] [url] [link text] %}
代码内容
{% endcodeblock %}
|
重要引用
1
2
3
|
{% pullquote [class] %}
内容
{% endpullquote %}
|
插入iFrame
1
|
{% iframe url [width] [height] %}
|
插入jsFiddle片段
1
|
{% jsfiddle shorttag [tabs] [skin] [width] [height] %}
|
插入Gist片段
1
|
{% gist gist_id [filename] %}
|
插入图片
1
|
{% img [class names] /path/to/image [width] [height] [title text [alt text]] %}
|
插入_blank属性的链接🔗
1
|
{% link text url [external] [title] %}
|
插入资源目录内代码片段
1
|
{% include_code [title] [lang:language] path/to/file %}
|
插入Youtube
插入Vimeo视频
引用站内文章
1
2
|
{% post_path source路径 %} // 只是显示路径
{% post_link source路径 [title] %} // 生成跳转链接
|
包含文章资源(使用Typora可规避)
当你打开文章资源文件夹功能后，你把一个 example.jpg 图片放在了你的资源文件夹中，如果通过使用相对路径的常规 markdown 语法  ，它将 不会 出现在首页上。（但是它会在文章中按你期待的方式工作）
1
2
3
|
{% asset_path source路径 %}
{% asset_img source路径 [title] %}
{% asset_link source路径 [title] %}
|
原样内容
1
2
3
|
{% raw %}
内容
{% endraw %}
|
复用数据
source/_data目录中添加menu.yml文件
1
2
3
|
{% for link in site.data.menu %}
<a href="{{ link }}">{{ loop.key }}</a>
{% endfor %}
|
自定义模版教程
常用命令
创建文章
1
2
3
4
5
|
$ hexo new [
-h 自定义路径
-r 如果存在就替换
-s 自定义url
][layout] "标题"
|
Layout布局在scaffolds中, 默认存在draft.md、page.md、post.md
可以自定义布局，在创建文章时自动套用模版
渲染生成
1
2
3
4
|
$ hexo g [
-d 直接部署
-w 查看文件改变
]
|
部署站点
启动本地站点