Есть ли способ иметь два документа в Docusaurus 2? - PullRequest
Новая
       70

Есть ли способ иметь два документа в Docusaurus 2?

1 голос
/ 21 марта 2020

Как я знаю, Docusaurus поддерживает настраиваемые страницы, но есть ли способ иметь два документа в одном проекте Docusaurus?

Исходные элементы Navbar имеют:

  • Docs
  • Блог
  • ...

Я хочу иметь что-то вроде этого:

  • Документы 1
  • Документы 2
  • Блог
  • ...

Я знаю, что могу создать много подпапок всего за одну операцию c, но по какой-то причине мне нужны два документа структура, которая дает мне более чистый способ доступа к документам.

Если Docusaurus не может предложить эту функцию в настоящее время, я хочу спросить, есть ли другие структуры документации, предлагающие эту функцию?

Ответы [ 2 ]

0 голосов
/ 21 марта 2020

Я попробовал этот способ, и он работает.

[Редактировать 1] : Но когда я выбираю API, то и API, и документы в Navbar становятся зелеными. Можете ли вы сказать нам, в чем причина этого @ Yangshun Tay , и можете ли вы предложить редактирование для этого?

[Редактировать 2] : я прочитал документацию, она написана в @ docusaurus / theme-classi c, если мы установим свойство activeBasePath, то ссылки с этим общим путем (docs в этом случае) будет иметь активный атрибут.

боковая панель. js

module.exports = {
    someSidebar: {
        Docusaurus: ['doc1', 'doc2'],
        Features: ['doc3']
    },
    someOtherSidebar: {
        Test: ['mdx']
    }
};

docusaurus.config. js

Ссылки на панели навигации выглядят так - 

links: [
    {
        to: 'docs/doc1',
        // activeBasePath: 'docs', // [Edit 3]
        label: 'Docs',
        position: 'left'
    },
    {
        to: 'docs/mdx',
        label: 'API',
        position: 'left'
    },
]

Структура папки папки документов выглядит так - 

docs
├── docs1.md
├── mdx.md
0 голосов
/ 21 марта 2020

Независимо от того, используете ли вы v1 или v2, конфигурация sidebars.js может содержать несколько клавиш , каждая из которых имеет собственную боковую панель.

...