::: HOW TO Install Genetrix On A Linux Platform :::

Author : LE DU Sébastien
Date : 22/03/2005
Version : 1.0
Contact : lacuna_seb@hotmail.com

Table Of Contents :::

I - Install Subversion

1.1 / Requirements

1.2 / Download And Install Subversion

II - Specific Configuration

2.1 / Choice Your Repository Path

2.2 / Configure Apache2 For Subversion

III - How to create your own localization i18n dictionary ?

Feedback

First of all, to install Genetrix on a server you have to download a revision system control called Subversion.

The installation has been tested with subversion 1.1.X

For more information, visit subversion.tigris.org official homepage.
And the Subversion Book svnbook.org.

I - Install Subversion

1.1 / Requirements
1.2 / Download And Install Subversion

1.1 / Requirements

Before installing Subversion, you must check you have got the Apache 2 HTTP server installed on your server.
Otherwise, Apache is available from httpd.apache.org.

For more information, visit httpd.apache.org official homepage of the Apache HTTP project.

1.2 / Download And Install Subversion

Install Subversion (current verion 1.1.3) available from subversion.tigris.org.

* With a Gentoo Linux

Code :::

emerge -av subversion

* With a Debian 'Woody'

Code ::: Added to Apt-Get sources

deb http://www.backports.org/debian/ woody subversion

II - Specific Configuration

2.1 / Choice Your Repository Path
2.2 / Configure Apache2 For Subversion

2.1 / Choice Your Repository Path

Subversion is a centralized system for sharing information. The repository concerns central store of data.
You must create it :

Code :::

svnadmin create /opt/subversion/svn/

Thus, the directory /opt/subversion/svn/ will contain references about all projects imported in the repository.

2.2 / Configure Apache2 For Subversion

You have to change two files :

/etc/conf.d/apache2

/etc/apache2/conf/module_d/47_mod_dav_svn_conf

Code :::

<Location /genetrix_svn > #define http://localhost/genetrix_svn/ as URI of your Repository Path
DAV svn
SVNPath /opt/subversion/svn/ #Server Path of your Repository
#Authentification
AuthType Basic
AuthName "Subversion Repository"
AuthUserFile /opt/subversion/svn/conf/passwd.conf #Any else path and/or file
Require valid-user #User must be knwon by the server. He appears in the file 'passwd.conf'
</Location >

III - How to create your own localization i18n dictionary

The genetrix interface(menus, dialog boxes etc..) is fed by a dictionary which is automatically selected by the server according to the language parameter given by the internet browser.
The default dictionary displays messages in English. If a dictionary doesn’t exist for your language, you can create it:
The file ../genetrixml/translations/message-xx.xml contains an empty dictionary.
All the keys necessary for the translation of the Genetrix application are in. You have to

indicate in the encoding attribute of the first line used by your system (e.g. ISO-8859-1 West Europe)
indicate in the xml:lang attribute of the <catalogue> tag your language code (e.g. fr for french).
provide for each key its equivalent in your language (e.g. <message key="home">Accueil</message>).

Exemple of an empty file:::

<? xml version="1.0" encoding="ISO-8859-1"?>
<catalogue xml:lang="">
  <message key="home"></message>
  <message key="documentation"></message>
  <message key="registerasaguest"></message>
  <message key="login"></message>
  <message key="map"></message>
  <message key="démonstrations"></message>
</catalogue>

The same file filled for French :

<? xml version="1.0" encoding="ISO-8859-1"?>
<catalogue xml:lang="fr">
  <message key="home">Accueil</message>
  <message key="documentation">Documentation</message>
  <message key="registerasaguest">S'enregistrer en invité</message>
  <message key="login">Se connecter</message>
  <message key="map">Carte du site</message>
  <message key="démonstrations">Exemples</message>
</catalogue>

Warning :::
Don’t change the tags of the dictionary

Save your dictionary in the directory ../genetrixml/translations with a name of the form : «message-» followed by your language code and the extension «.xml»
Example for the French : message-fr.xml
Restart the server (or wait for an automatic update)

If the interface don’t shift to your language, check the language settings of your browser.

Feedback

Please e-mail comments to andre.lemeur@uhb.fr.