dwyl / dwyl/learn-phoenix

i18n (internationalization)

Open
#90 2 comments 2 reactions 0 assignees View on GitHub
enhancement technical
Dominant language
No language data
Stars
664
Forks
41
PR merge metrics
No merged PRs in 30d

Description

> _As a **person build web applications/sites** in **various languages**_
> I need a way to (_easily_) **translate** the app/site into different

On the Phoenix Framework Website docs http://www.phoenixframework.org/docs/
there isn't an _obvious_ page for _internationalisation_ ... so it's _unclear_ how we should go about making our _english_ web application/site

> If you are _totally_ `new` to **internationalization** (i18n)
read: https://www.w3.org/International/questions/qa-i18n

Searching the Phoenix Framework site for `i18n` we see no results:
![image](https://user-images.githubusercontent.com/194400/27025629-1546c8e6-4f53-11e7-88b6-b578c64f6993.png)

But there _appears_ to be a result when searching for the _full_ word `internationalization`:
![image](https://user-images.githubusercontent.com/194400/27026097-92e11f9e-4f54-11e7-9913-638e2a9cfe66.png)

The link is to:
http://www.phoenixframework.org/blog/phoenix-10-the-framework-for-the-modern-web-just-landed
Which _includes_ the word (_so we know the full-text search is working..._) but is kinda useless:
![image](https://user-images.githubusercontent.com/194400/27027580-f0d7382c-4f59-11e7-8693-d8eda23c8bbe.png)
The "What's Next" section of the Phoenix 1.0 announcement
http://www.phoenixframework.org/blog/phoenix-10-the-framework-for-the-modern-web-just-landed#whats-next
Does not go into _any_ detail of ***how*** to _implement_ i18n in a Phoenix app.

A bit of Googling returns these two posts:

+ (_Old but still_) seems relevant: http://sevenseacat.net/posts/2015/i18n-in-phoenix-apps
+ Using Gettext to internationalize a Phoenix app: http://blog.plataformatec.com.br/2016/03/using-gettext-to-internationalize-a-phoenix-application (_platformatec is where Jose Valim works so should be a good place to start_)

## Todo:

+ [ ] [SPIKE] Try a basic "Hello World" in 2 languages using the `Gettext` method
+ [ ] Write it up in a step-by-step guide.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.