Editing Translation (section)

=== Selecting the session's language ===

In a multilingual site you probably let the visitors to choose the language of the session. It is determined by the default setting of the browser preferences, but sometimes users want to change this. Manual setting of the session's language can be done by the [http://files.eprints.org/264/ port] of the ''set_language'' script from earlier Eprints versions, and should go into the [[EPrints_Directory_Structure/eprints3/cgi|cgi]] directory. A handy place for the set_language URL is in the menu at the top of the page. As the the default page template is repository dependent, you should edit [[EPrints_Directory_Structure/eprints3/archives/ARCHIVEID/cfg/lang/en/templates|archives/ArchiveID/lang/en/templates/default.xml]], the English language template for that repository as follows (but see the remarks above):

  &lt;ul class="ep_tm_menu"&gt;
   &lt;li&gt;&lt;a href="{$config{frontpage}}"&gt;Home&lt;/a&gt;&lt;/li&gt;
   &lt;li&gt;&lt;a href="{$config{perl_url}}/set_lang"&gt;Language&lt;/a&gt;&lt;/li&gt;
    &lt;li>&lt;a href="{$config{base_url}}/information.html"&gt;About&lt;/a&gt;&lt;/li&gt;
   ... 
  &lt;/ul&gt;

The template page on other languages should not contain this ''Language'' item as not necessarily will people recognise it. Rather use a button which reverts the language to English, i.e. insert the following into [[EPrints_Directory_Structure/eprints3/archives/ARCHIVEID/cfg/lang/en/templates|archives/ArchiveID/lang/XX/templates/default.xml]] for all other languages XX except for English:

 &lt;li&gt;&lt;a href="{$config{perl_url}}/set_lang?langid=en"&gt;In English&lt;/a&gt;&lt;/li&gt;

If you want a little more fancy layout, you might consider using  [http://files.eprints.org/40/ flag images] to be copied to the directory [[EPrints_Directory_Structure/eprints3/lib/static/style/images|lib/static/style/images/flags/]]. If you define a phrase (see the [[#Phrases|Phrases]] section) of the form "cgi/set_lang:lang_XX" then the set_lang script will use that phrase to render a link to that language. A typical format could be

  <epp:phrase id="cgi/set_lang:lang_hu"><epc:pin name="link">
      &lt;img src="/style/images/flags/flag_hu.png" alt="[hu]" /&gt; 
       Hungarian</epc:pin>
  </epp:phrase>