documentation: make the diagram on the "Quality gateway" section translatable

[Fat-Zer]

Describe the issue

There is a diagram on the Quality gateway section of the translation workflows chapter. It would be nice to translate labels on that one.

Expected behavior

I wish it would be translatable by either of methods:

• Extracting the labels and translating them separately
• Extracting the diagram code as a whole and translating it as a single unit

[nijel]

Most likely this has to be addressed at https://www.sphinx-doc.org/, we're just using existing internationalization support there. It uses graphviz to render the diagrams.

[Fat-Zer]

@nijel, I suspect it's likely a matter of the Sphinx's configuration rather than itself. The gettext_additional_targets option looks promising, but I'm not familiar enough neither with the Sphinx nor with how Weblate actually uses it to tell you how to do it exactly and what will be the consequences...

If you could give me some hints how to build the PO files for the documentation from the command line, I may later experiment with that a bit to came up with a more concrete solution.

PS: as a side effect this will likely cause extraction of code snippets and config examples, which allow to translate comments inside those.

[nijel]

It doesn't seem to work this way.

Once you install Sphinx and other needed tools (pip install -r docs/requirements.txt), you can build the POT file using make locales/docs.pot.