Babel / Server Tool Development Process
- 1 Babel Team Development Strategy
- 2 Setting up a Development Environment
- 3 Submitting code patches
- 4 Release process
Babel Team Development Strategy
The Babel team's strategy to processing bugs and feature requests is (in order):
- Bugs that cause incorrect translations to be saved or prevent people from enter translations
- Finishing the version zero issues (deployment, documentation)
- Bugs preventing project teams from adding their projects to Babel
- Server performance issues
- Bugs preventing users from consuming the output of Babel
- New features
Setting up a Development Environment
The Babel server environment is a typical LAMP environment. Apache 2.x, PHP 5.x, MySQL 5.x and a CVS client are likely the only prerequisites.
Steps to setting up a Babel Development Environment on Linux:
Create a directory alias in Apache
Alias /babel "/var/www/babel/server/html/" <Directory "/var/www/babel/server/html/"> AllowOverride None Order allow,deny Allow from all </Directory>
Apache may need to be reloaded or restarted for the alias to take effect.
Obtain the code from CVS
cd /var/www/babel/ cvs -d :pserver:firstname.lastname@example.org:/cvsroot/technology co -d server/ org.eclipse.babel/server
Set up the MySQL database
Configure the classes/base.conf file with the MySQL database information.
db_read_host=localhost db_read_user=babel db_read_pass=babelpassword db_read_name=babel context=dev
Using your favourite MySQL administration tool, create a database for Babel. It is also recommended to create a MySQL user for Babel.
mysql> create database babel; mysql> grant SELECT, INSERT, UPDATE, DELETE on babel.* to babel@'localhost' identified by 'babelpassword'; mysql> flush privileges;
Replace the username, hostname and password according to your specific environment. Load the babel tables and sample data (the root account is used here, as the 'babel' account doesn't have CREATE/DROP privileges):
mysql -u root -p babel < /var/www/babel/server/babel-setup.sql
Currently, Eclipse Phoenix code is required for Babel Server to run. There are plans to fix this (bug 217488). The Phoenix code must be installed in html/ with a symbolic link to it in your Apache DocumentRoot
cd /var/www/babel/server/html/ cvs -d :pserver:email@example.com:/cvsroot/org.eclipse co -d eclipse.org-common www/eclipse.org-common cd /var/www/html/ # or whatever your DocumentRoot is ln -s /var/www/babel/server/html/eclipse.org-common eclipse.org-common
Logging in, load strings from dev.eclipse.org CVS
Log into Babel at http://localhost/babel/login.php.
username: firstname.lastname@example.org password: password
Launch the maps processor: http://localhost/babel/process_map_files.php