joshwcomeau/guppy

Internationalization

Open

#66 opened on Jul 16, 2018

View on GitHub
 (17 comments) (6 reactions) (0 assignees)JavaScript (151 forks)github user discovery
help wantedupcoming feature

Repository metrics

Stars
 (3,248 stars)
PR merge metrics
 (PR metrics pending)

Description

Guppy's goal is to remove barriers for beginners to learn how to do modern web development. One huge barrier is that tools like create-react-app are only available in English, and many aspiring web developers don't speak English!

It would be awesome to get i18n support in Guppy. Unfortunately, it's also a huge amount of effort, and not one I foresee having time to develop. If folks are interested in contributing, the first step is to add i18n support to the application. One upside to building a desktop app is that small sizes aren't so critical, so we could probably get away with a pretty minimal solution:

  • Create files (JSON? YAML? JS objects?) that hold all the copy in English, at /copy/en.js or similar
  • Create a way to change languages in the UI (maybe a flag in the top-right, when no project is selected?) - Still open & not decided yet
  • Add an application menu option for languages
  • Use https://github.com/yahoo/react-intl or similar to format messages in different languages
  • Update all the english copy
  • Request translations, update when translations are available.

Current status (WIP see branch feature-i18n)

  • Create localization guide for easier getting started with the translations
  • Planned / active localizations
    • English locale (en) @zianke / @llllish
    • Chinese locale (zh) @zianke / @llllish
    • German (de) @awolf81 (not started yet - waiting for English locale)
    • Spanish (es) @canopix (also waiting)
    • Bulgarin (bg) @scottwarren (waiting for English locale - if still interested)
    • Turkish (tr) @bennygenel (waiting for English locale)

Contributor guide