Improved i18n support

[chalin]

Tasks

• [i18n] Docs section weights need to be adjusted to work with all languages #4572
• [zh] Strip away embedded HTML en fragments #4602
• [i18n] Add language codes #4622
• [i18n] Support non-English banners with English fallback #4486
• [i18n & ja] Improved fallback config and normalize en doc links #4627
• [CI] i18n GH action check doesn't always work #4641
  • [CI & i18n] i18n script and doc improvements #4648
• [i18n] Propose way to associate translations to specific commit of default lang page #4582
• [i18n] Ensure that fallback pages have en lang attribute #4664
• [i18n][design] Interpret absolute paths as locale specific #4688
• [i18n] localization of snippets inside shortcodes #4783
• Add i18n guidance re. images & shortcodes + some rework #4790
  • [i18n] Ensure section-local image paths fall back to default lang image #4761
• [i18n] Consistently implement the handling of the OTel specs across localizations, and document the solution #4876
  • [i18n] Improve specs redirects #4895
• Spell-check support
  • [CI] Spell check en pages only #4816
  • [i18n] Spell-check non-en pages other than ja and zh #4981
• [i18n] Support Netlify redirects for non en pages #4629
  • Ensure non-en community pages that are separate mounts or redirects are working
  • Implement the registry as a redirect for non-en languages
• Ensure that search works as expected (a concern raised for other Docsy sites but that might apply here)
• Ensure that pages, like the new https://opentelemetry.io/ja/docs/specs/, do not show up in the languages dropdown of the corresponding English page, or show it as disabled (which might actually be better)
• [i18n] Ensure repo link text is in the right language #4593
• [i18n] Better address the auto-update of versions across localizations #4825
• Incomplete translations of Chinese documentation #4893

Note: some of the items above are carry-over items from #4443.

Other, including ja and zh

• [zh] English fallback-page canonical link should refer to en section page #4487
• Create docs-zh-approvers etc #4465
• [zh] faas/_index.md: fix invalid hash #4645
• Followups to Hugo docs edits: Clarify languageCode default in multilingual page gohugoio/hugoDocs#2564 and further contributions
• Consider splitting up the Hugo config into parts?
• Reinstate Prettier to run over zh pages too - [CI & i18n] Support page formatting for ja and zh pages #4630
• Move images from under content/en/docs/demo/screenshots into static to ensure that they are shared(?)

References

• add styles to indicate existence of doc for each version etcd-io/website#390 - something that we might want to apply here as well