jlaso/tradukoj

Translation for developers

Tradukoj, tradukoj por programistoj (translations for developers)

In esperanto TRADUKOJ means translations (and is pronounced with the stress in the U), _(*1)

Please: follow @tradukoj in twitter to be updated!., _(*2)

The official site of tradukoj is https://www.tradukoj.com., _(*3)

1) Installing

When it comes to installing you have the following options., _(*4)

Use Composer create-project (recommended)

As Symfony uses [Composer][2] to manage its dependencies, the recommended way to create a new project is to use it., _(*5)

If you don't have Composer yet, download it following the instructions on http://getcomposer.org/ or just run the following command:, _(*6)

curl -s http://getcomposer.org/installer | php

Then, use the create-project command to generate a new Symfony application:, _(*7)

php composer.phar create-project jlaso/tradukoj path/to/install

composer create-project --repository-url=http://tradukoj.dev  jlaso/tradukoj tradukoj

Composer will install Tradukoj and all its dependencies under the path/to/install directory., _(*8)

Use Composer and start virtual server

Please, note that vagrant and bindfs need to bee installed into the system, _(*9)

vagrant plugin install vagrant-bindfs

if you get an error for vboxsf upping vagrant check this link, _(*10)

move to vagrant folder (cd vagrant) and start vagrant machine with vagrant up, please get some coffee for the first time, _(*11)

2) Checking your System Configuration

Before starting coding, make sure that your local system is properly configured for Symfony., _(*12)

Execute the check.php script from the command line:, _(*13)

php app/check.php

If you get any warnings or recommendations, fix them before moving on., _(*14)

3) Getting started with Tradukoj

If the vagrant machine has been started successfully, you have to upload the local translations to the server (yes, it's the same machine) whith this command:, _(*15)

# enter into the machine
vagrant ssh
# and run
cd /vagrant
/usr/bin/env php  app/console jlaso:translations:sync --upload-first=yes

For an unknow reason this last step can not be launched by ansible (MemoryError)., _(*16)

If all works fine you can enter in the browser with the URL http://10.10.10.8, _(*17)

4) Collaboration

Please, feel free to contribute, or proposal improvements., _(*18)

Thank you so much to spend your time testing this project., _(*19)

5) Bundles

Currently there are two bundles to communicate symfony2 projects or not with tradukoj, in order to centralize translations., _(*20)

• translations-apibundle
• tradukoj-po-mo-module

The connection between this modules and the server occurs with socket native implementation. The explanation of this solution has been explained for me in several occasions:, _(*21)

• Talk in spanish in GeeksHubs, Valencia 2014-05-15
• Talk in spanish in DrupalCamp Valencia 2014

Explanations in english are welcome., _(*22)

References:, _(*23)

• www.tradukoj.com - Official site

Enjoy!, _(*24)