contentlayerdev / contentlayerdev/contentlayer

Support content "sections"

未关闭
#209 4 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看
feature
主要语言
TypeScript
星标
3.5k
派生
192
PR 合并指标
30 天内没有已合并 PR

描述

One of the things that I really like about [Hugo](https://gohugo.io) is its [sections](https://gohugo.io/content-management/sections/) feature, which enables you to separate nested directories of content into well-defined groups. So instead of a kind of "flat" array of files you end up getting a nested structure like this:

```
Documentation
\_ Getting started
\_ Installation
\_ Platforms
\_ Administration
\_ Kubernetes
\_ Setup
\_ Configuration
\_ etc
```

As expected, sections can be infinitely nested and each can have its own metadata. I don't necessarily endorse the _way_ that Hugo does this (you need to sprinkle `_index.md` files throughout your tree) but I do think that having this kind of rich structure available to you is great for creating tables of content, sidebar navs, and all of that good stuff. Personally, it's the thing that I'm missing the most as I cross the chasm from mostly doing things in Hugo to doing things in JS world.

I could envision being able to do something like this in Contentlayer:

```js
export const Doc = defineDocumentType(() => ({
name: 'Doc',
filePathPattern: `**/*.md`,
fields: {
title: {
type: 'string',
description: 'The title of the doc',
required: true,
},
},
computedFields: {
url: {
type: 'string',
resolve: (post) => `/docs/${post._raw.flattenedPath}`,
},
},
}))

export default makeSource({
contentDirPath: 'docs',
documentTypes: [Doc],
// tiny little change
sections: true,
})
```

This could export an `allDocsSections` object of type `Sections` that would enable you to recurse through the tree.

```jsx


    {allDocs.sections.map(section => (

  • {section.title}




      {section.docs.map(doc => (

    • {doc.title}

    • ))}

      {section.sections.map(section => ( /* nest */ ))}

  • )}

```

This is very off the cuff but hopefully provides _some_ sense of what I'm suggesting. I'd be quite happy to help out with this if others find the idea compelling. Just wanted to register it here in this forum.

Note: Docusaurus [also supports this](https://docusaurus.io/docs/sidebar/autogenerated) using a `_category_.{json|yml}` file that creates a new "category" (basically an analogue to the sections concept) wherever it's found in the directory tree.

贡献指南

打开贡献指南

评估

这个 Issue 还没有评估数据。

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。