add a href link to _category_.json in autogenerated mode

[pincman]

how to do it?

[Josh-Cena]

This? https://docusaurus.io/docs/sidebar/autogenerated#autogenerated-sidebar-metadata

[pincman]

@Josh-Cena
that's not it
currently my configuration is like this

const sidebars = {
    manuals: [{ type: 'autogenerated', dirName: 'manuals' }],
};

module.exports = sidebars

and which in docs dir like this

└── manuals
    ├── frontend
    │   └── _category_.json
    ├── go
    │   ├── _category_.json
    │   ├── test1.md
    │   └── test3.md
    ├── index.md
    ├── node
    │   └── _category_.json
    └── php
        └── _category_.json

content of go/_category_.json

{
    "label": "golang",
    "position": 4,
    "items": [
        {
            "type": "link",
            "label": "test",
            "href": "https://test.com",
             "position": 2
        }
    ]
}

but it not work,error log output by console

 ValidationError: "items" is not allowed

[Josh-Cena]

You cannot add additional items to an autogenerated slice (see #5689). For now, if you want to add links to any category, you have to make the entire category non-autogenerated, as a type: 'category' item consisting of autogenerated children. Like this:

const sidebars = {
  manuals: [
    {
      type: "category",
      label: "golang",
      items: [
        { type: "autogenrated", dirName: "go" },
        { type: "link", label: "test", href: "https://test.com" },
      ],
    },
    // Go on to declare categories for node and php
  ],
};

[slorber]

technically it's possible to add extra content to autogenerated categories by writing your own generator: https://docusaurus.io/docs/sidebar/autogenerated#customize-the-sidebar-items-generator

but for sure it's not the most convenient API to do so

[pincman]

{ type: "autogenrated", dirName: "go" }

can i exclude some file like { type: "autogenrated", dirName: "go",exclude: ['index.md'] } for it?

[Josh-Cena]

That would also be #5689. It's something we'd like to focus on right next, given the wide need to exclude the index page from the subitems, but it's currently not possible. You can also try @slorber's solution to enhance the generator and insert extra links where you want.

[mohab-sameh]

Also need this. Any idea if this is planned soon? It's much more convenient to use the auto-generated sidebar, but external links are also needed.

[hadar-co]

@Josh-Cena @slorber Hey guys, I also need this capability, any plans to add it? Thanks

[jarodtaylor]

Is this still not an option? I tried changing the link the _category_json and it's a no-go.

[slorber]

The issue to track is #5689

I'm locking this discussion because all related discussions should be added to the linked issue above.

We still don't have a first-class option, but there are workarounds