Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 11 Next »

Valid from 4.4

The documentation below is valid from Datafari 4.4 upwards

For now Datafari is preconfigured to display its menu and functionalities (not to be mixed up with the languages that can be analysed at the indexing phase) for English, French, German, Italian, Arabic, Brazilian Portuguese and Russian. See further below for the default languages that can be analysed at the indexing and search phases.

Step-by-step guide

For the internationalization of the user interface, we use the i18n java library:

  1. The folder to store the i18n config files is here : datafari/WebContent/js/AjaxFranceLabs/locale. Just open it and add your new language. For example if you add German translation, put here a file named de.json.
    Also add a new entry in all the i18n files corresponding to your new language. For example to add Spanish language, we added the following entry in all the i18n files :

    "es_locale" : "Español" 

  2.  Add the new langage in the Java class com.francelabs.datafari.utils.LanguageUtils.java :

    public static final List<String> availableLanguages = Arrays.asList("en", "fr", "it", "ar", "ru");


  3. Add the new language in WebContent/js/AjaxFranceLabs/i18njs.js :

    availableLanguages : [ 'en', 'fr', 'it', 'ar', 'ru' ],

  4. For Datafari Enterprise Edition only :  create a file with the new language : LOCALE.json , for example es.json into the folder /opt/datafari/tomcat/webapps/Datafari/customs/i18n
    Add this content into it :

    \{\}


  5. Finally launch the ant script datafari-dev.xml to take into Datafari the modifications (if you are in development mode).

For the internationalization of the language detection, indexing and search by the Datafari Solr engine, follow these steps:

  1. Modify the dedicated Solr updateprocessor which is declared in the DATAFARI_HOME/solr/solr_home/FileShare/conf/solrconfig.xml, that you can find at updateRequestProcessorChainDatafari, which detects the languages based on the fields content and title. By default, we use English and French. In order to add a new language, modify the new language to the element "langid.whitelist".
  2. Modify the Solr schema to handle the new language, which you will find at DATAFARI_HOME/solr/solr_home/FileShare/conf/schema.xml. You will notice that we already have the following two fields which are language specific, namely content and title. Therefore, we have "content_en", "title_en", "content_fr", "title_fr". You need to create your specific "content_xy" and "title_xy" fields for your new language.
  3. Modify the searchrequesthandler named select in the DATAFARI_HOME/solr/solr_home/FileShare/conf/solrconfig.xml. There, change the parameters qf et pf : put the following new fields: title_xy and content_xy to the existing chain of parameters.
  4. Now you can restart your Datafari for the changes to be taken into account.


Valid from 4.0

The documentation below is valid from Datafari 4.0 upwards

For now Datafari is preconfigured for English, French, Italian, Arabic, Brazilian Portuguese and Russian. Still, its aim is to have a global reach, so the steps to enable additional languages is rather straightforward and can be found here. In case you did it, please contact us so that we can integrate it in the next releases of Datafari !

Step-by-step guide

For the internationalization of the user interface, we use the i18n java library:

  1. The folder to store the i18n config files is here : datafari/WebContent/js/AjaxFranceLabs/locale. Just open it and add your new language. For example if you add German translation, put here a file named de.json.
    Also add a new entry in all the i18n files corresponding to your new language. For example to add Spanish language, we added the following entry in all the i18n files :

    "es_locale" : "Español" 

  2.  Add the new langage in the Java class com.francelabs.datafari.utils.LanguageUtils.java :

    public static final List<String> availableLanguages = Arrays.asList("en", "fr", "it", "ar", "ru");


  3. Add the new language in WebContent/js/AjaxFranceLabs/i18njs.js :

    availableLanguages : [ 'en', 'fr', 'it', 'ar', 'ru' ],

  4. For Datafari Enterprise Edition only :  create a file with the new language : LOCALE.json , for example es.json into the folder /opt/datafari/tomcat/webapps/Datafari/customs/i18n
    Add this content into it :

    {}


  5. Finally launch the ant script datafari-dev.xml to take into Datafari the modifications (if you are in development mode).


For the internationalization of the language detection, indexing and search by the Datafari Solr engine, follow these steps:

  1. Modify the dedicated Solr updateprocessor which is declared in the DATAFARI_HOME/solr/solr_home/FileShare/conf/solrconfig.xml, that you can find at updateRequestProcessorChainDatafari, which detects the languages based on the fields content and title. By default, we use English and French. In order to add a new language, modify the new language to the element "langid.whitelist".
  2. Modify the Solr schema to handle the new language, which you will find at DATAFARI_HOME/solr/solr_home/FileShare/conf/schema.xml. You will notice that we already have the following two fields which are language specific, namely content and title. Therefore, we have "content_en", "title_en", "content_fr", "title_fr". You need to create your specific "content_xy" and "title_xy" fields for your new language.
  3. Modify the searchrequesthandler named select in the DATAFARI_HOME/solr/solr_home/FileShare/conf/solrconfig.xml. There, change the parameters qf et pf : put the following new fields: title_xy and content_xy to the existing chain of parameters.
  4. Now you can restart your Datafari for the changes to be taken into account.


You can either send us your new language either directly or using github, either way is fine by us as the modifications are not huge. We will send you a cool Datafari T-Shirt if you share that with us, so that you can show the community you are a real Datafarian (smile)


Valid from 3.2

The documentation below is valid from Datafari 3.2 upwards

For now Datafari is preconfigured for English, French, Italian, Arabic, Brazilian Portuguese and Russian. Still, its aim is to have a global reach, so the steps to enable additional languages is rather straightforward and can be found here. In case you did it, please contact us so that we can integrate it in the next releases of Datafari !

Step-by-step guide

For the internationalization of the user interface, we use the i18n java library:

  1. The folder to store the i18n config files is here : datafari/WebContent/js/AjaxFranceLabs/locale. Just open it and add your new language. For example if you add German translation, put here a file named de.json.

  2.  Add the new langage in the Java class com.francelabs.datafari.utils.LanguageUtils.java :

    public static final List<String> availableLanguages = Arrays.asList("en", "fr", "it", "ar", "ru");


  3. Add the new language in WebContent/js/AjaxFranceLabs/i18njs.js :

    availableLanguages : [ 'en', 'fr', 'it', 'ar', 'ru' ],


  4. Add the new language in WebContent/js/parameters.js :

    availableLanguages : [ 'en', 'fr', 'it', 'ar', 'ru' ],

  5. Finally launch the ant script datafari-dev.xml to take into Datafari the modifications (if you are in development mode).


For the internationalization of the language detection, indexing and search by the Datafari Solr engine, follow these steps:

  1. Modify the dedicated Solr updateprocessor which is declared in the DATAFARI_HOME/solr/solr_home/FileShare/conf/solrconfig.xml, that you can find at updateRequestProcessorChainDatafari, which detects the languages based on the fields content and title. By default, we use English and French. In order to add a new language, modify the new language to the element "langid.whitelist".
  2. Modify the Solr schema to handle the new language, which you will find at DATAFARI_HOME/solr/solr_home/FileShare/conf/schema.xml. You will notice that we already have the following two fields which are language specific, namely content and title. Therefore, we have "content_en", "title_en", "content_fr", "title_fr". You need to create your specific "content_xy" and "title_xy" fields for your new language.
  3. Modify the searchrequesthandler named select in the DATAFARI_HOME/solr/solr_home/FileShare/conf/solrconfig.xml. There, change the parameters qf et pf : put the following new fields: title_xy and content_xy to the existing chain of parameters.
  4. Now you can restart your Datafari for the changes to be taken into account.


You can either send us your new language either directly or using github, either way is fine by us as the modifications are not huge. We will send you a cool Datafari T-Shirt if you share that with us, so that you can show the community you are a real Datafarian (smile)

  • No labels