Combine autogenerated sidebar with a plugin-generated sidebar?

[frederictriquet]

Hi,

I'm using an "autogenerated" sidebar for my whole site.
I'm also using the docusaurus-openapi-docs plugins to generate pages from an openapi file.
The plugin also generates a sidebar.ts file to group endpoints by tags.

How can I mix properly the autogenerated sidebar and the one generated by the plugin?

Using only this:

const sidebars: SidebarsConfig = {
  tutorialSidebar: [{type: 'autogenerated', dirName: '.'}],
};

processes the files generated by the openapi plugin, ignoring the sidebar.ts. Thus the endpoints are not in the desired order/tree structure.

Using:

import petstoreSidebar from './docs/petstore/sidebar';
...
const sidebars: SidebarsConfig = {
  tutorialSidebar: [
        {type: 'autogenerated', dirName: '.'},
        {
            type: "category",
            label: "Petstore",
            link: {
                type: "generated-index",
                title: "Petstore",
            },
            items: petstoreSidebar
        }
  ],

almost works: the Petstore sidebar is included but the ./docs/petstore/ directory is also processed.

Is there a way to exclude the ./docs/petstore/ from the automatic generation?

Best regards.

PS: for reasons I won't explain here, I really need to use the automatic generation of the sidebar (manually writing the whole sidebar is not a solution).

[frederictriquet]

Hi,
Is what I'm asking unclear or too complicated?

Best regards,
Fred.

[slorber]

I'm not super familiar with docusaurus-openapi-docs that we don't maintain here, so it's probably better to ask the question to authors of that plugin directly.

You might find this related issue useful: #5689

You can control how autogenerated items are generated too by providing your own logic if the default one doesn't work for your case: https://docusaurus.io/docs/next/sidebar/autogenerated#customize-the-sidebar-items-generator