Блог

Есть ли какой-либо способ включить содержимое файла markdown в другой файл markdown в Docusaurus V2? Я пытаюсь упорядочить структуру папок с документами.

Когда мы создаем файл markdown, например, в docs, Docusaurus автоматически устанавливает путь к файлу в некоторых других файлах проекта. Я хотел бы знать, как мне заставить его работать с папками в папке docs?

 .
├── docc
│   ├── chapter1
│   │   ├── index.md
│   │   ├── session1.md
│   │   └── session2.md
│   └── chapter2
│       ├── index.md
│       ├── session1.md
│       └── session2.md
├── doc1.md
├── doc2.md
└── doc3.md
 

Измените расширение .md файла на .mdx и установите zero-md.

 $ npm install --save zero-md
 

В .mdx файле после Frontmatter добавьте import ZeroMd from 'zero-md' и поместите <zero-md src='{address of markdown file which you want to render}'></zero-md> туда, где вы хотите отобразить файл markdown.

Я не уверен, что полностью понимаю ваш вопрос, но вы можете вложить содержимое так глубоко, как пожелаете, я думаю. Вам нужно будет создать свой sidebars.js файл соответствующим образом.

У меня есть что-то вроде этого:

 module.exports = {
  someSidebar: {
    'Manual': [
      'intro',
      'login',
      'admin',
      {
        'Services': [
          'services/service1',
          'services/service2',
          'services/service3',
        ]
      }
    ]
  }
};
 

Это можно сделать в многомерных файлах, подобных этому, проверьте документы здесь:

 import License from './license.md' // Assumes an integration is used to compile MDX -> JS.
import Contributing from './docs/contributing.mdx'

# Hello world

<License components={props.components} />

---

<Contributing components={props.components} />