Allow custom props through _category_.json

[qiaofeng1227]

Have you read the Contributing Guidelines on issues?

We used it docusaurus for our documentation. It's excellent.
I want to customizae generated-index catalog, e.g. show filenames link of directory.
Is there a scheme that can be realized only by setting category.json?

• I have read the Contributing Guidelines on issues.

Description

Has this been requested on Canny?

No response

Motivation

dd

API design

No response

Have you tried building it?

No response

Self-service

• I'd be willing to contribute this feature to Docusaurus myself.

[Josh-Cena]

Hi, you can swizzle DocCard and use the category item's customProps to pass in your own description. However, I do realize that the sidebar generator currently doesn't pass the customProps attribute from the _category_.json, although it now does for sidebar_custom_props after #6619, so it would be a useful extension.

Also requested on Canny: https://docusaurus.canny.io/feature-requests/p/allow-customizing-category-description-in-generated-index-cards I don't think offering an additional API is worth the effort, as DocCard is meant to be swizzled anyways.

[slorber]

@Josh-Cena if you have any customization idea for our own site (even just aesthetic ones), I think it can be useful to dogfood this on our own site, add some category customProps and swizzle the cards.

This can be used as an official example for others to look at

[taejs]

I'd like to look into this issue.