Skip to main content

3.2 폴더 그룹 만들기

docusaurus 기본 설정으로는 docs안에 모든 마크다운 파일이 하나의 navbar item에 담겨있다.

  • docs 폴더를 여러개의 하위 그룹으로 나누어서 문서화를 진행하고자 한다.
  • FE관련 지식, BE 관련 지식을 따로 관리 해보자.

참고 Repo : https://github.com/7code-group/7code-group.github.io.

https://7code-group.github.io

아래의 3단계를 통해서 진행한다.

1.docs 그룹 폴더 만들기​

docs/g-fe-docs
docs/g-be-docs

Alt text

_category_.json​

{
  "label": "g-be-docs",
  "position": 1,
  "collapsible": true,
  "collapsed": false,
  "link": {
    "type": "generated-index",
    "description": "g-be-docs"
  }
}

head sidebar position​

---
sidebar_position: 99
---

more options > https://docusaurus.io/docs/create-doc#doc-tags

2.sidebars 추가​

// sidebars.js

/** @type {import('@docusaurus/plugin-content-docs').SidebarsConfig} */
const sidebars = {
  // 기본설정
  tutorialSidebar: [{type: 'autogenerated', dirName: '.'}],
  // 특정 폴더 > 카테고리 
  feGroup: [
    {
      type: "autogenerated",
      dirName: "g-fe-docs",
    },
  ],
  beGroup: [
    {
      type: "autogenerated",
      dirName: "g-be-docs",
    },
  ],
  // But you can create a sidebar manually
};

module.exports = sidebars;

3.docusaurus.config.js 추가​

...

        items: [
          // {
          //   type: 'docSidebar',
          //   sidebarId: 'tutorialSidebar',
          //   position: 'left',
          //   label: 'Tutorial',
          // },
          {
            type: 'docSidebar',
            sidebarId: 'feGroup',
            position: 'left',
            label: 'FE',
          },
          {
            type: 'docSidebar',
            sidebarId: 'beGroup',
            position: 'left',
            label: 'BE',
          },