Add localization language support

[macagua]

Hi guys

Is possible to add localization language support? because the footer templates are in English, but my Sphinx project is about Spanish documentation

Here I see that the templates have i18n support, but it's don't have locales directory for localization, for example Spanish language
https://github.com/rtfd/sphinx_rtd_theme/blob/master/sphinx_rtd_theme/footer.html

Any idea ?

[ericholscher]

I'm not 100% sure how to actually translate Sphinx themes. I believe it should use the same i18n infrastructure as Sphinx itself, but haven't done the research on it. This would be a great place for contribution and having folks who care about keeping the theme translated as part of our core team, if you're curious of a good way to contribute!

[mitya57]

I can share the steps I was using in our project:

• Install babel from PyPI.
• Create file babel.cfg (in this repository) with this content:

  # Extraction from Jinja2 HTML templates
  [jinja2: **/**.html]
  encoding = utf-8
  ignore_tags = script,style
  include_attrs = alt title summary

• Add this to setup.cfg:

  [extract_messages]
  mapping_file = babel.cfg
  output_file = sphinx-rtd-theme.pot
  keywords = _ l_ lazy_gettext

• Run python setup.py extract_messages to generate sphinx-rtd-theme.pot.
• Create the .po file for your language using msgmerge tool (I think you can use Babel if you prefer).
• Translate it using your favourite application (i.e. gtranslator).
• Place the translated .po file in your project as locale/$LANG/LC_MESSAGES/sphinx.po.
• Add locale_dirs = ['locale/'] to your project’s conf.py.

[macagua]

@mitya57 you are the man really thanks! 🍺

[macagua]

@ericholscher then I fork this repo, add support for localization language following the @mitya57 guide and return this improvement via a pull request!!!

[Blendify]

@macagua any update on this?

[macagua]

@Blendify yes, please check out #405