https://github.com/phrase/i18n-beginner-tutorial-rails

https://github.com/phrase/i18n-beginner-tutorial-rails

Last synced: 5 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/phrase/i18n-beginner-tutorial-rails
• Owner: phrase
• Created: 2019-08-19T09:49:10.000Z (almost 7 years ago)
• Default Branch: master
• Last Pushed: 2021-09-21T13:19:35.000Z (almost 5 years ago)
• Last Synced: 2025-03-31T01:51:14.779Z (over 1 year ago)
• Size: 247 KB
• Stars: 1
• Watchers: 19
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# Getting started with Phrase and Github - Ruby on Rails example

This Repository provides examples on how to use Phrase in general and the integration with github.

# What we want to achieve

- You will run a simple app on your machine

- You will learn how to internationalize that app

- You will learn how to integrate Phrase

# [System setup and first steps](https://www.youtube.com/watch?v=GOSpulJgoPU)

## Installation of necessary tools

- [Sublime - Texteditor](https://www.sublimetext.com/)

- [Homebrew - Packagemanager for Linux/MacOs](https://brew.sh/)

- Install git with homebrew by running -> `$brew install git`

- Install gpg with homebrew by running -> `$brew install gpg`

- [RVM -Ruby Version manager](https://rvm.io/)

  - If you run into problems with installing rvm especially with the

    GPG Keys, please follow the security instructions on the rvm page

- Install the correct Ruby version with rvm by running ->` $rvm install 2.4.1`

# Run the Application on your machine

## Get the Source code

> We will use this [Github Repository](https://github.com/docstun/lunchroulette) as an example

1. Create a folder via the Terminal on your Desktop

    * ` $cd Desktop`

    * `$mkdir phrase_playground`

2. Navigate into the folder

    * `$cd phrase_playground`

3. Clone the Lunchroulette Repo from Github

    * `$git clone https://github.com/docstun/lunchroulette.git`

## Get the Web Application up and running

### Set up the environment for the App

1. Install Bundler -> Dependency Manger for Ruby on Rails

    * `$gem install bundler`

2. Install all gems

    * `$bundle install`

### Get the App running

1. Initialize the Database

    * `$rails db:setup`

2. Start the Server

    * `$rails server`

3. [Open App in your browser](http://localhost:3000)

# Short indroduction to the Ruby on Rails environment

> For a short introduction to the Ruby on Rails structure, please view the

> short [video](https://vimeo.com/352687324/fc6c93f6130) we provided.

> [For a deeper introduction of Ruby on Rails structure we suggested

this video](https://gorails.com/episodes/rails-application-structure)

# Localizing the App

## [Introduction to i18n](https://www.youtube.com/watch?v=7dAZ0kXLGmI)

## [Implement I18n into your codebase](https://vimeo.com/352687282/5952575eb4)

1. Add basic configuration to your `./app/controllers/application_controller.rb`

    ![application

controller](https://github.com/phrase/i18n-beginner-tutorial-rails/blob/master/assets/carbon.png)

2. Set the languages in your `./config/initializers/locale.rb`

    ![setting

languages](https://github.com/phrase/i18n-beginner-tutorial-rails/blob/master/assets/language.png)

# Connecting the project to Phrase

## Install the Phrase CLI

  Run the following commands in your Terminal

  1. `$brew tap phrase/brewed`

  2. `$brew install phraseapp`

## Phrase CLI Setup

  Run the following commands in your Terminal

  1. `$phraseapp init`

  2. You will then be asked to provide an access token, which  you can

     create in the Phrase UI and copy/paste it into your Terminal

  3. Follow further instructions to setup a new project or choose an

     already existing project.

  4. When you get asked for the path just press enter, in our case the

     CLI already has got the right path.

  5. All done?! Run your first `$phraseapp push`

  6. Play around in the Phrase UI and get all the changes with

     `$phraseapp pull`

> [**For futher information/ integrations also see our documentation

here**](https://help.phrase.com/en/?cjs=X2dhPUdBMS4yLjIwNzQ1NDA2NTguMTU1NDExNTIzNTsgaHVic3BvdHV0az1jZTM4MjM3MTFhODZjOWRjMDcyMmIzOGM1OWRkY2E2NDsgbWVzc2FnZXNVdGs9MTRkZTQwOGVkODg0NGIxM2JiNTg3ZmFlMmFmNGZhYjA7IF9mYnA9ZmIuMS4xNTU0MTkwNzU1OTkyLjQ0OTQ1MjY5NjsgX19hZHJvbGxfZnBjPWVjMWU5NjdmZTY1Y2FmNjI5ODk4ZmRhZDQzZDZmYzQwLXMyLTE1NTQxOTEwMzIxODE7IF9wYV92aWQ9MWVncDR0ai1uZnVnLW5tc29sbDsgX2hqaWQ9OTA3MWZlZTAtZTA1ZC00ZDRlLWI5MjgtNDgxMjE3ODg3ZWE1OyBfcGFfaWlkPW9mazdvMG80OyBfX2hzdGM9MjY2MzM3NTUyLmNlMzgyMzcxMWE4NmM5ZGMwNzIyYjM4YzU5ZGRjYTY0LjE1NTQxMTUyMzYwMDIuMTU2MzUyMzM3OTg3OS4xNTYzNTMxMDczNDAyLjIwMjsgX19hcl92ND1TVldYRDRGUVFCREtaQVRDUU9XNkZaJTNBMjAxOTA3MTclM0ExJTdDSElWTTZBQVFFRkJGRkdETERQR1FQSyUzQTIwMTkwNzAxJTNBMjQxJTdDV1BUQUVNQVJXSkZJVkZRSUtQTUNCRCUzQTIwMTkwNzAxJTNBMjQ0JTdDTElJRElSSkIzQkdVVkcyREc2TVNDNyUzQTIwMTkwNzAxJTNBMjQ0JTdDVklGSDJJWlVTVkdaRkk0VFBWTlAzVSUzQTIwMTkwNzE3JTNBMQ%3D%3D)

## Get help / support

Please contact [support@phrase.com](mailto:support@phrase.com?subject=[GitHub]%20) and we can take more direct action toward finding a solution.