Is there a way to internationalize json domain titles ?

[rperrot]

Hi,

first of all, thank you for your really helpful theme/extension.

I' trying to use json domain in a non english document and I'm stuck with the "required/optional" members string. I'd like to change it but I can't find a way to change it using a parameter/option.

I think the issue is because theses strings are hard coded here :

sphinx-immaterial/sphinx_immaterial/apidoc/json/domain.py

Line 866 in 9adb3f1

heading = "%s members" % ("Required" if required else "Optional")

Is there a way to customize it or it's impossible ?

Yours,

[2bndy5]

True, the strings are hardcoded in English, and there is no config option to change or remove them. We could use Sphinx' own translation mechanism, but I think that would require a .po file (in the doc project's source) that defines the translation for the words phrases "Required members" and "Optional members". This idea would be simple to implement on our end:

                heading = "%s members" % ("Required" if required else "Optional") 
                field_list, body = self._make_field(_(heading))

But it will require a message catalog (.po file) of translations on the user's end.