Enhancement request: Generate _category_.json/yml files for names of sidebar dropdown items

[JenniBeadle]

Describe the issue
Docusaurus uses the folder names (short with hyphens) for the sidebar dropdowns unless you add category.yml files to each folder to specify the name of the folder. These are also used to translate the folder names.

See discussion on Category item metadata in https://docusaurus.io/docs/sidebar/autogenerated#category-item-metadata

[hatton]

@JenniBeadle can you say how this will improve things for you?

(Especially if you're making an feature request, you'll want to remove boilerplate text like

Describe the bug
A clear and concise description of what the bug is.

[JenniBeadle]

I guess you don't have folders in Notion so no wonder you didn't understood. I am trying to improve the folder names in the sidebar.

A picture paints a thousands words. So let me show you what I want to reproduce as I
have on my other sites.

Here is what the sidebar looks like from Notion based Paratext-manual site:

The text for the dropdowns is the folder name (complete with hyphens)

Here is what the sidebar looks on my manual.paratext.org site when using edited _ category _.json files

The sidebar has clearer names (as supplied by the category files in each folder).

Also when I run the translate command, Docusaurus collects the folder names into a file (current.json) to translate. I haven't worked with Crowd-In so I don't know how they do it. But here is what I got on the French locale of my other site:

When I had a repository on my computer I could just add the category files (even to the exported Notion). But with Release actions and no visible files, I can't to it. So I need another way. Just changing the page in Notion doesn't work.

On reflection I wonder if you can really export .json files from Notion. But there must be a way of achieving the end result.

[hatton]

The side bar items are named after the Outline pages. So instead of having your Notion Outline pages named in these shorthand ways like you are, they should be, based on your screenshots above:

instead of	name it
Training Manual	Paratext Training Manual
Video Summaries	Paratext Video Summaries
Stage-1	Stage 1 Drafting

Etc.

[JenniBeadle]

I had tried that before I submitted the enhancement request but it didn't work for me. So what am I doing wrong?

It definitely doesn't work from the cloned repository in localhost because on my computer, it is back in folders.
So I tried the GitHub Release action and as you can see below, it changes spaces to "-" for categories. The file names are OK as it comes from the title.

Here is what I get

The ordering is out because I started to delete the initial numbering which normally controls the sort order. I thought it was supposed to be in same order as Notion. But maybe that was still an enhancement request.

[hatton]

Yeah those dashes are a bug. I'll close this and report that.