User manual

Advanced Topics

Installing new languages

If you need to have Koha OPAC and staff client screens in another language,

you will need to install the particular language. Here are the steps involved:

Install Perl module prerequisite Locale: : Po.

Check availability of the corresponding language files in the Koha folder.

Create new folders for the new language in the appropriate OPAC and staff

client folders.

Use Koha's program- tmpl _process2 .pl to install the new language.

Enable the new language via Koha's system preferences module.

As an example let us install the Spanish language.

Install Locale::PO module

We need the Perl module Locale: : Po before we can install the new language.

We use CPAN to install this module:

koha@li190-245:-/kohaclone$ cpan Locale::PO

Creating language templates for the OPAC

First let us locate the Spanish language files in the kohaclone folder. The language

files have an extension

. po

and are found in the misc /translator folder:

koha@li190-245:-/kohaclone $ cd misc/translator/

koha@li190-245:-/kohaclone/misc/translator $ ls *ES*.po

es-ES-i-opac-t-prog-v-3000000.po

es-ES-i-staff-t-prog-v-3000000.po

To create the language templates for the OPAC, first we create a new directory

for the new language in the koha -tmpl /opac -tmpl jprog/ folder:

koha@li190-245:-/kohaclone/misc/translator # mkdir ../../koha-tmpl/opac-

tmpl/prog/es

We then use the tmpl_process3 .pl program to install the new language. The

program is executed as follows:

koha @li190 -245: -/kohaclone /misc /translator# perl tmpl_process3.pl

install -i <path to the English language folder> -o <path to the new

language folder> -s <path to the .po file of the new language> -r

[254]