Skip to content

Help us translate the BeAPI website #33

Description

@nobu-sh

Last updated: 4/2/2021

Help us translate the BeAPI website

BeAPIs website uses a documentation framework called Docusaurus.
Docusaurus v2 is completely i18n localization ready. With that being said we want to translate BeAPIs website for
our non fluent English users.

Roadmap before translation ready

  • Possible CLI translations via os locale 1
  • Register BeAPI for Crowdin open-source plan 2
  • Integrate Crowdin with Docusaurus i18n 3
  • Spend countless hours blacklisting mdx keys in Crowdin ;-;
  • Reach out to other communities to help translate :)

Translation process

  • Optionally get familiar with the Docusaurus i18n support
  • Ensure your language is also translated for the CLI (Prioritize CLI translations first)
  • Sign-up on Crowdin and join the BeAPI project
  • Get familiar with the Crowdin translation UI, as you will need to use it to translate JSON and Markdown files
  • Ask for your locale to be enabled on Crowdin (if not already enabled)
  • Translate the content

More info will be made available once roadmap is complete!

Footnotes

  1. Example of getting OS locale through node:

    const env = process.env;
    const language = env.LANG || env.LANGUAGE || env.LC_ALL || env.LC_MESSAGES;
    
  2. Crowdin offers a free plan for open source projects, read more here.

  3. Implementation documentation located here.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    metaIssue related with the project itself. Usually project maintenance.staleIssues and prs that have be inactive for a while.

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions