原文链接:https://ssshooter.com/2018-12…
官方自带标签体系教程,英语过关能够直接浏览官方教程。
以下说一下重点:
提示:以下一切查询都能够在 localhost:8000/___graphql
测试
竖立标签体系只需要以下步骤:
在 md 文件增加 tags
---
title: "A Trip To the Zoo"
tags: ["animals", "Chicago", "zoos"]
---
用 graphQL 查询文章标签
{
allMarkdownRemark(
sort: { order: DESC, fields: [frontmatter___date] }
limit: 1000
) {
edges {
node {
frontmatter {
path
tags // 也就增加了这部份
}
}
}
}
}
制造标签页面模板(/tags/{tag}
)
标签页面构造不难,与之前的文章页面差不多,区分在于标签的查询:
// 注重 filter
export const pageQuery = graphql`
query($tag: String) {
allMarkdownRemark(
limit: 2000
sort: { fields: [frontmatter___date], order: DESC }
filter: { frontmatter: { tags: { in: [$tag] } } }
) {
totalCount
edges {
node {
frontmatter {
title
path
}
}
}
}
}
`
修正 gatsby-node.js
,衬着标签页模板
const path = require("path")
const _ = require("lodash")
exports.createPages = ({ actions, graphql }) => {
const { createPage } = actions
const blogPostTemplate = path.resolve("src/templates/blog.js")
const tagTemplate = path.resolve("src/templates/tags.js")
return graphql(`
{
allMarkdownRemark(
sort: { order: DESC, fields: [frontmatter___date] }
limit: 2000
) {
edges {
node {
frontmatter {
path
tags
}
}
}
}
}
`).then(result => {
if (result.errors) {
return Promise.reject(result.errors)
}
const posts = result.data.allMarkdownRemark.edges
posts.forEach(({ node }) => {
createPage({
path: node.frontmatter.path,
component: blogPostTemplate,
})
})
let tags = []
// 猎取一切文章的 `tags`
_.each(posts, edge => {
if (_.get(edge, "node.frontmatter.tags")) {
tags = tags.concat(edge.node.frontmatter.tags)
}
})
// 去重
tags = _.uniq(tags)
// 建立标签页
tags.forEach(tag => {
createPage({
path: `/tags/${_.kebabCase(tag)}/`,
component: tagTemplate,
context: {
tag,
},
})
})
})
}
假如你要把标签页也分页,多加一个轮回就行,原理跟主页分页都是一样的:
tags.forEach(tag => {
const total = tag.totalCount
const numPages = Math.ceil(total / postsPerPage)
Array.from({ length: numPages }).forEach((_, i) => {
createPage({
path:
i === 0
? `/tag/${tag.fieldValue}`
: `/tag/${tag.fieldValue}/${i + 1}`,
component: tagTemplate,
context: {
tag: tag.fieldValue,
currentPage: i + 1,
totalPage: numPages,
limit: postsPerPage,
skip: i * postsPerPage,
},
})
})
})
这里仅仅是把查询到的文章的一切标签都抽取出来,用以天生标签页,然则标签具体内容的猎取依赖于标签页自身的查询。
制造 /tags
页面展现一切标签
重点同样是查询部份:
export const pageQuery = graphql`
query {
site {
siteMetadata {
title
}
}
allMarkdownRemark(
limit: 2000
filter: { frontmatter: { published: { ne: false } } }
) {
group(field: frontmatter___tags) {
fieldValue
totalCount
}
}
}
`
fieldValue
是标署名,totalCount
是包括该标签的文章总数。
在之前写好的文章页衬着标签
就是查询的时刻多一个标签字段,然后衬着上,完事。
下一步
再次提示,关于数据构造隐约的话直接在 localhost:8000/___graphql
查一下就很清楚了。如今这个 blog 已愈来愈完美,接下来增加的功用能够说都黑白必需的了,下一步先说说页面布置。