How to translate Drupal Console (app & documentation)

In order to translate the book, first you need to translate the app strings. The book translates itself afterwards with a simple command.

You need to clone the following repos under the same parent folder (whatever it be)

(do this only the first time)

$ drupal develop:contribute \
--drupal=/Users/leandro/Sites/translator \
--code=/Users/leandro/git/

Here we point out the site path with --drupal parameter and your cloned repositories path with parameter --code

(do this only the first time)

$ drupal develop:create:symlinks \
--code-directory=/Users/leandro/git/

--code parameter points out your repositories path

drupal settings:set language es

(do this only the first time)

Ok, now you got an environment ready to translate, so first of all let's synchronize new string with the following command:

drupal develop:translation:sync

Then you want to remove not already necessary strings with:

drupal develop:translation:cleanup

Now, lets check what needs to be translated with:

drupal develop:translation:pending es

es means spanish, change it according your language

Right now, you can translate your strings, the .yml files live in /config/translations

Please, keep in mind the following guidelines:

Ok, so you translated all the app to your language, right? Now you want to know that the Documentation Book is translated automagically :-)

Let's go for the documentation: you should have a repo called drupalconsole.com if not, clone it yourself:

git clone git@github.com:hechoendrupal/drupalconsole.com.git

Now the command for automagically translate it is:

drupal develop:doc:data --file=/Users/leandro/git/drupalconsole.com/content/data/commands-es.json

giving with the --file parameter the absolute path to the file commands-LANGUAGE_CODE.json

You're all done!! Don't forget to make a pull request to the Drupal Console repos at Github including your language repo and the documentation repo!!