Allow disabling - globally - the category index link convention | Voters

Allow disabling - globally - the category index link convention

complete

TheDofflin

Allow disabling - globally - the category index link convention for documents with the same name as parent folder: e.g.

docs/Guides/Guides.md

This recent change which forces

docs/Guides/Guides.md

to be treated as a category link rather than as a standalone document has broken my workflow, as I am autogenerating a large API category using a separate tool.

I naively suggest a new type like this which autogenerates pages and categories, but does not automatically treat

Guides/Guides.md

as a category link:

items: [
  {
    type: "autogenerated-disable-category-links",
    dirName: "api",
  },
],

January 5, 2022

Joshua Chen

marked this post as

complete

Joshua Chen

marked this post as

planned

Sébastien Lorber

Agree we should have configuration for this.

answered here: https://github.com/facebook/docusaurus/pull/5830#issuecomment-1005590057

TheDofflin

I should note that I expect this to apply recursively

TheDofflin

Or at least provide options e.g.

items: [
  {
    type: "autogenerated",
    categoryLinkIndex: true,
    categoryLinkReadme: true,
    categoryLinkSameName: false,
    dirName: "api",
  },
],