Overriding admonition titles from conf.py?

[jason-sachs]

I don't want to have any admonition titles by default in my project. I tried looking into the internationalization logic in Sphinx, and added a source/locales/en/LC_MESSAGES/sphinx.po file with content like this:

#: sphinx/locale/__init__.py:341
msgid "Attention"
msgstr ""

#: sphinx/locale/__init__.py:342
msgid "Caution"
msgstr ""

#: sphinx/locale/__init__.py:343
msgid "Danger"
msgstr ""

#: sphinx/locale/__init__.py:344
msgid "Error"
msgstr ""

#: sphinx/locale/__init__.py:345
msgid "Hint"
msgstr ""

#: sphinx/locale/__init__.py:346
msgid "Important"
msgstr ""

#: sphinx/locale/__init__.py:347
msgid "Note"
msgstr "Zark"

#: sphinx/locale/__init__.py:348
msgid "See also"
msgstr ""

#: sphinx/locale/__init__.py:349
msgid "Tip"
msgstr ""

#: sphinx/locale/__init__.py:350
msgid "Warning"
msgstr ""

to see if the Note admonition would get translated, but it doesn't seem to work properly. (somehow I got it to work once through some unknown mechanism)

I looked into the source files (sorry I'm using Sphinx 5.0.2 and for various reasons it is important not to upgrade) and it looks like Sphinx's locale.__init__.py gets executed before the conf.py loads, and when I run python -m sphinx.cmd.build source build under a debugger, the call to init_console() gets the package locale directory and not my project's locale directory.

This is all a moot point if there's a better way to override the default admonition titles via something in conf.py. But it seems like a bug.

For now I'm just going to monkeypatch locale.admonitionlabels from conf.py.

[jdillard]

Why not use the Generic Admonition?

[jason-sachs]

Why not use the Generic Admonition?

Because content (semantics) should be separated from presentation. Our team should be able to use note:: and warning:: and let us independently choose how to display.