VIVO Language Support

Multiple language support can mean many things. When a VIVO site supports a language other than English, that support includes:

• Text that is displayed in the VIVO pages.  For example, menus, selections, prompts, tool-tips and plain text.
• Terms Text from terms in the Ontology, which are frequently displayed as links or section headings.Labels and descriptions   Text includes labels and annotations of properties and classes.
• Text values stored in the data model.
  For example, if a book title is available in both French and English, a French-speaking user sees the French title. If a title is available only in English, it is displayed, without regard to the user's preference in languages.

Languages can be selected in a variety of ways, depending on the installation parameters:

• A VIVO installer can configure VIVO to use one of the supported languages.
• Different users may see different languages, depending on the settings in their web browser.
• Different users may select a language from a list of available languages.

Language support in VIVO is being implemented in phases:

• Phase 1 includes read-only support of public pages:
  
  • Pages that are visible to users who are not logged in.
  • Also includes support of some administrative pages.
  • This is currently available.
• Phase 2 will also provide read-write support of profile pages:
  • Users will be able to edit language-specific data in profile pages.
• Phase 3 will support administrative pages
  • Creating user accounts, manipulating RDF data and other administrative functions.
• Phase 4 will support "back-end" pages.
  • Used to edit the ontology, or to do low-level editing on individual entities.

VIVO language files are available for English, Spanish, Brazilian Portuguese, and German. If you need support for another language, please inquire of the VIVO mailing lists, to see if another group is already developing the files you need.

Adding a language to your VIVO site

Adding language files to VIVO

VIVO is distributed with English as the only supported language. VIVO also includes a set of "pseudo-language" files, as a demonstration of how language support is implemented.

Additional language files are available in the Git repositories at https://github.com/vivo-project/Vitro-languages and https://github.com/vivo-project/VIVO-languages.

...

VIVO language files are available for English, Spanish, Brazilian Portuguese, and German. If you need support for another language, please inquire of the VIVO mailing lists, to see if another group has the files you need.

Adding a language to your VIVO site

How to install language files 

In this step by step guide we will use the German language files as an example. After you installed VIVO (like as described here), get clone your desired VIVO-language and Vitro-language folders/repositories (in this example we will use the files found at from https://github.com/vivo-DE). Be sure to use the theme 'wilma' or 'tenderfoot' for this to work without issues. 

• go Go into each language folder (VIVO-language and Vitro-language) and ' install ' them with Maven ("using mvn install")

• next, go Go into the VIVO project folder and uncomment the section for multiple language support in the two pom.xml files listed below:
  (search for '<!-- Dependencies for multilingual support -->' and '<!-- Overlays for multilingual support -->' inside of the files)

  1. VIVO/installer/home/pom.xml

  2. VIVO/installer/webapp/pom.xml

  Make sure to change the <version> in the pom.xml-files to the same version as in the 'VIVO-language/pom.xml' and 'Vitro-language/pom.xml' file respectively.
  (In this example we had to change <version>[2.0.0,2.1.0)</version> to <version>2.0.0-SNAPSHOT</version> in three places: 2x in 'VIVO/installer/webapp/pom.xml' and 1x in 'VIVO/installer/home/pom.xml')
  Note that these should be the home/pom.xml and webapp/pom.xml in whatever installer project is being used to deploy VIVO.

  for multilingual support -->' and '<!-- Overlays for multilingual support -->' inside of the files)  in each of the two pom.xml files listed below:

  • VIVO/installer/home/pom.xml

  • VIVO/installer/webapp/pom.xml

  Change the <version> in the two pom.xml files to the same version as in the 'VIVO-language/pom.xml' and 'Vitro-language/pom.xml' file respectively.  You may need to change the version in multiple places in the files.
• Build VIVO from the VIVO project folder using after that, we have to build VIVO again, so go into the VIVO project folder and
  "mvn install -s installer/my-settings.xml"
• now edit Edit the '/vivo_home_dir/config/runtime.properties' properties file in your VIVO home directory (as declared in your 'VIVO/installer/my-settings.xml' file):
  
  • uncomment/add 'RDFService.languageFilter = true'
  • uncomment/add ' languages.selectableLocales = en_US, de_DE'
• restart Restart the tomcat
• you You should now be able to select your installed language (in this case German) in the header of your VIVO site

...