View source for Adding new languages to LogicalDOC

=== Setup a New Language  ===

Adding a new language to LogicalDOC is quite simple. 

The activity usually involves the installation of a localization plug-in that has the following features:<br> 

*It provides translations for the GUI (Graphical User Interface) 
*Instructs LogicalDOC saying that a new language is available 
*Specify which language analyzer Lucene must use for indexing the text extracted from documents and for full-text search.<br>

<br> 

Standard languages English, Italian, French, German and Spanish are available in the basic application, while others have been kindly contributed by the open source community of&nbsp; LogicalDOC. 

To enable a different language, you must download and install on your system a compressed Zip file that represent the localization plug-in.<br> 

{| width="99%" cellspacing="1" cellpadding="1" border="1" style=""
|-
| bgcolor="#cccccc" align="center" | '''Plug-in'''<br> 
| bgcolor="#cccccc" align="center" | '''Description'''<br> 
| bgcolor="#cccccc" align="center" | '''Plug-in Version'''<br> 
| bgcolor="#cccccc" align="center" | '''LD&nbsp;Compatibility''' 
| bgcolor="#cccccc" align="center" | '''Contributors'''<br>
| bgcolor="#cccccc" align="center" | '''Released'''<br>
|-
| [http://sourceforge.net/projects/logicaldoc/files/plugins/plugins-5.2/logicaldoc-lang-tr-5.2.0-plugin.zip/download logicaldoc-language-tr]<br> 
| Support for Turkish language<br> 
| align="center" | 5.2<br> 
| align="center" | 5.0/5.2<br> 
| Levent Ercan
| 2010-08-10
|-
| [http://sourceforge.net/projects/logicaldoc/files/plugins/plugins-5.1/logicaldoc-lang-pt_br-5.1.0-plugin.zip/download logicaldoc-language-pt_br]<br> 
| Support for Brazilian language<br> 
| align="center" | 5.1<br> 
| align="center" | 5.2.1<br> 
| Sam Samuels<br>Dejair Ferreira Junior
| 2010-07-22
|-
| [http://sourceforge.net/projects/logicaldoc/files/plugins/plugins-5.1/logicaldoc-lang-sq-5.1.0-plugin.zip/download logicaldoc-language-sq]<br> 
| Support for Albanian language<br> 
| align="center" | 5.1<br> 
| align="center" | 5.2.1<br> 
| Admirim Ymeri
| 2010-07-22
|-
| [http://sourceforge.net/projects/logicaldoc/files/plugins/plugins-5.1/logicaldoc-lang-da-5.1.1-plugin.zip/download logicaldoc-language-da]<br> 
| Support for Danish language<br> 
| align="center" | 5.1.1<br> 
| align="center" | 5.0/5.2.1<br> 
| Ask Hjorth Larsen<br>Kim Hansen
| 2010-06-16
|-
| [http://sourceforge.net/projects/logicaldoc/files/plugins/plugins-5.0/logicaldoc-lang-fa-5.0.0-plugin.zip/download logicaldoc-language-fa]<br> 
| Support for Persian language<br> 
| align="center" | 5.0<br> 
| align="center" | 4.6/5.0<br> 
| Tekoshar bo jian
| 2010-02-25
|-
| [http://sourceforge.net/projects/logicaldoc/files/plugins/plugins-4.6/logicaldoc-lang-hu-4.6.0-plugin.zip/download logicaldoc-language-hu]<br> 
| Support for Hungarian language<br> 
| align="center" | 4.6<br> 
| align="center" | 4.6/5.0<br> 
| Kuti Sándor
| 2009-11-19
|-
| [http://sourceforge.net/projects/logicaldoc/files/plugins/plugins-4.5.2/logicaldoc-lang-ru-4.5.2-plugin.zip/download logicaldoc-language-ru]<br> 
| Support for Russian language<br> 
| align="center" | 4.5.2<br> 
| align="center" | 4.5.1<br> 
| Alexander Kosyakov<br>
|-
| [http://sourceforge.net/projects/logicaldoc/files/plugins/plugins-4.5/logicaldoc-lang-el-4.5.1-plugin.zip/download logicaldoc-language-el]<br> 
| Support for Greek language<br> 
| align="center" | 4.5.1<br> 
| align="center" | 4.5.1 
| Marinos Vlasakis<br>
|-
| [http://sourceforge.net/projects/logicaldoc/files/plugins/plugins-4.5.2/logicaldoc-lang-pt-4.5.0-plugin.zip/download logicaldoc-language-pt]<br> 
| Support for Portuguese language<br> 
| align="center" | 4.5.0<br> 
| align="center" | 4.5.1 
| Marta Figueiredo<br>
|-
| [http://sourceforge.net/projects/logicaldoc/files/plugins/plugins-4.5/logicaldoc-lang-nl-4.5.0-plugin.zip/download logicaldoc-language-nl]<br> 
| Support for Dutch language<br> 
| align="center" | 4.5.0<br> 
| align="center" | 4.5.1 
| Dennie de Lange,<br> Leon Jamieson<br>
|-
| [http://sourceforge.net/projects/logicaldoc/files/plugins/plugins-4.5/logicaldoc-lang-zh-4.5.1-plugin.zip/download logicaldoc-language-zh]<br> 
| Support for Chinese language<br> 
| align="center" | 4.5.1<br> 
| align="center" | 4.5.1 
| Tong Hongxian<br>
|}

<br>To activate a localization plug-in, follow these steps:<br> 

#Shutdown the Tomcat that runs LogicalDOC 
#Copy the file into the plugins folder<br>eg.: c:\tomcat-6.0.20\webapps\logicaldoc\WEB-INF\plugins 
#Restart Tomcat<br><br>

For the localization plugins there is no need to perform the setup procedure, this steps is required only for the plugins that add new business objects.<br><br>'''Note:''' The translations of these plugins may be incomplete or inaccurate, if you want to give your contribution <br>as of August 2009 is available on Launchpad the [[Translate LogicalDOC|new platform for translations of LogicalDOC]].<br>At intervals of about 2 weeks a&nbsp;localization update bundle for LogicalDOC will be issued taken by the new translation system.<br><br>

=== Create a localization Plug-in  === 

==== Translating the resource boundle  ====

&nbsp; Please refer to page [[Translate LogicalDOC|Translate LogicalDOC]]

==== Making the localization plug-in  ====

LogicalDOC supports language localization through an extension point (plug-in) of LogicalDOC called ''Language''.<br>In practice this is to produce an artifact (a compressed Zip file) with a class and some other resources that implements the properties defined for the extension point ''Language''.<br><br> 

Below are the sources of the Maven2 project and the binary versions of a plugin Language to support Danish language. <br>NOTE: this is a full translation of LogicalDOC 5.1. <br>[http://sourceforge.net/projects/logicaldoc/files/plugins/plugins-5.1/logicaldoc-lang-da-5.1.1-plugin.zip/download logicaldoc-lang-da-5.1.1-plugin.zip] <br>[http://sourceforge.net/projects/logicaldoc/files/plugins/plugins-5.1/logicaldoc-lang-da_src.zip/download logicaldoc-lang-da_src.zip] (project sources) 

To activate the new language simply drop the file logicaldoc-lang-da-5.1.1-plugin.zip into the plugins folder of LogicalDOC: 
<pre>C:\tomcat-6.0.20\webapps\logicaldoc\WEB-INF\plugins 
</pre> 
then restart your Tomcat (to activate the plugin) and login choosing the Danish language.<br> 

<br> 

For greater clarity enclose another example complete of sources of the plugin created to support the Brazilian variant of Portuguese language.<br> 

[http://sourceforge.net/projects/logicaldoc/files/plugins/plugins-4.5/logicaldoc-lang-pt_br-4.5.0-plugin.zip/download logicaldoc-lang-pt_br-4.5.0-plugin.zip]<br>[http://sourceforge.net/projects/logicaldoc/files/sources/sources-4.5/logicaldoc-lang-pt_br-4.5_src.zip/download logicaldoc-lang-pt_br-4.5_src.zip] (project sources) <br> 

<br>The big difference here is in the definition file of the plugin (plugin.xml).<br>In this case, unlike the previous, we can specify the implementation of analysis of language used by Lucene (which is the framework for indexing and research used by LogicalDOC ). 
<pre>	&lt;extension plugin-id="logicaldoc-core" point-id="Language" id="pt_BRLanguage"&gt;
		&lt;parameter id="locale" value="pt_BR" /&gt;
		&lt;parameter id="analyzer" value="org.apache.lucene.analysis.br.BrazilianAnalyzer" /&gt;
	&lt;/extension&gt;
</pre> 
extract from the plugin definition file: plugin.xml<br><br>in this piece of code is shown the implementation of language analyzer that will be used by Lucene for the indexing and research in Brazil language that is the class: org.apache.lucene.analysis.br.BrazilianAnalyzer

<br>.<br>