sphinx-wagtail-theme icon indicating copy to clipboard operation
sphinx-wagtail-theme copied to clipboard

Documentation translations support

Open thibaudcolas opened this issue 3 years ago • 0 comments

We’re interested in translating the Wagtail docs (#4968). Trying this out with the theme’s docs, I spotted a few issues:

  • There are strings in the theme template marked for translation, for example "Edit on GitHub". I think those strings would need to be translated directly in this project
  • A lot of strings aren’t marked for translation, for example "View source"
  • The lang attribute on <html> isn’t set correctly
  • The Read the Docs version picker is still displayed in english when viewing docs in another language
  • Images don’t seem to be translate-able
  • I’ve had some trouble with RST syntax in translation message strings, although I think it might just be me not understanding it.

Nice to have:

  • Have hreflang attributes on pages

Pages I tried this on:

  • https://sphinx-wagtail-theme.readthedocs.io/fi/latest/
  • https://sphinx-wagtail-theme.readthedocs.io/fr/latest/
  • https://sphinx-wagtail-theme.readthedocs.io/fr/latest/contributing.html
  • https://sphinx-wagtail-theme.readthedocs.io/fr/latest/authors.html
  • https://sphinx-wagtail-theme.readthedocs.io/fr/latest/examples/index.html

thibaudcolas avatar May 28 '21 15:05 thibaudcolas