前两篇在这里
hexo-pagination函数释义
hexo-generator-index 源码分析
这是第三篇
从分析generator-index开始，我们就知道了 只要给出一个对应的path路径和layout布局，我们就可以返回一个pagination，里面有很多的页面可调用数据
现在我们来分析一下hexo-generator-tag这个插件
源码在这里
用法很简单
tag_generator:
per_page: 10
tag_generator:false(这个一般不出现 generate tag index page, usually /tags/index.html)
tag_dir: tags （相关属性，这是原本就有的）
就这么一个属性---控制每页的文章数
这个属性不看源码是没有文档的
作用为：
如果你有两篇文章，tag分别是aaa和bbb，
那么hexo g 后，生成的html分别位于 tags/aaa/index.html和tags/bbb/index.html
这两个页面分别展示了两个标签的列表
但是我们有时候也希望，有一个显示所有标签的页面，位于tags/index.html，统领所有标签。
这时候 tag_generator这个属性就派上用场了
在config中添加
tag_generator:
tag_generator:true
再次hexo g
则自动生成tags/index.html
访问http://localhost:4000/tags/index.html
就会显示所有tags了
先看源码整体结构
module.exports = function(locals) {
var config = this.config;
var perPage = config.tag_generator.per_page; //指定每页列表数
var paginationDir = config.pagination_dir || 'page'; //生成的文件夹路径
var tags = locals.tags; // 这是一个数组
var tagDir; // 从下面可知 这是生成tag文件夹路径
var pages = tags.reduce(function(result, tag) {
});
return result.concat(data);
}, []);
// 如果enable_index_page为true 生成tag index页，就在/tags/index.html
if (config.tag_generator.enable_index_page) {
tagDir = config.tag_dir;
if (tagDir[tagDir.length - 1] !== '/') {
tagDir += '/';
} //加上路径斜杠
pages.push({
}
});
}
return pages; // 最后返回的是pages 一个数组
};
分析第一段page
var pages = tags.reduce(function(result, tag) {
// result 代表每一次的累加值
// tag 其实就是current value，当前单个tag值
if (!tag.length) return result; // tag为空，就返回result
var posts = tag.posts.sort('-date');
//通过 locals.tags[tag-i].posts来取得相对应的文章，这个用法需要掌握
var data = pagination(tag.path, posts, {
perPage: perPage,
layout: ['tag', 'archive', 'index'],
format: paginationDir + '/%d/',
data: {
tag: tag.name
}
}); // 我们知道 pagination函数返回一个 *键为 path,layout,data的多个对象*的数组
return result.concat(data); // 把数组连接起来变成一个数组
}, []);
其实就是把每一个tag标签分页，分页后再把所有的分页数组组成一个新的大数组返回出来
注意
tag里面包含什么值？
我们可以在tags.ejs模板中操作一下，打印出来看看，
我们需要创建一个tag的index页面，因为根据源码，只有tags的汇总页面才会返回tags这个数据
因为tags的分页返回的data中有一项是tags，我们就用它来看一看里面是什么东西！
打印tags
<%= Object.keys(page.tags) %>
//domain,_events,_eventsCount,_maxListeners,name,data,_mutex,schema,length,Document,Query
我们的目的是tag里面的东西
写如下代码
<ul>
<% page.tags.forEach(function(t,i){ %>
<%= Object.keys(t) %>
<% }) %>
</ul>
//name,_id,slug,path,permalink,posts,length
至此 我们知道了tag的所有键
tag.path非常关键！这是生成静态文件包和url的关键一项
format十分关键，尤其是tag下，我们需要清楚的知道page的路径变化
现举例如下：
tag为aaa的页面分页url如下展示
http://localhost:4000/tags/aaa/
http://localhost:4000/tags/aaa/page/2/
静态页面生成地址如下展示
tag
---aaa
------page
---------2
------------index.html
------index.html
扩展：
hexo的数据库用的是warehouse
这里是文档地址
关于hexo的数据模型关系，可以看其源码
这里
通过这个就大体知道如何写调用数据了
下面是生成tag index的方法
if (config.tag_generator.enable_index_page) {
tagDir = config.tag_dir;
if (tagDir[tagDir.length - 1] !== '/') {
tagDir += '/';
}
pages.push({
path: tagDir, // 指定路径
layout: ['tag-index', 'tag', 'archive', 'index'], //指定布局，首先找有没有tag-index模板
posts: locals.posts,
data: {
base: tagDir,
total: 1,
current: 1,
current_url: tagDir,
posts: locals.posts,
prev: 0,
prev_link: '',
next: 0,
next_link: '',
tags: tags
}
});
}
可以看出来 其实返回的结构与调用pagination返回的数据结构基本一致
所以我们可以推断，hexo就是利用这个结构来生成页面和输入数据的
