For translating CKAN’s web interface see Translating CKAN. In addition to user interface internationalization, a CKAN administrator can also enter translations into CKAN’s database for terms that may appear in the contents of datasets, groups or tags created by users. When a user is viewing the CKAN site, if the translation terms database contains a translation in the user’s language for the name or description of a dataset or resource, the name of a tag or group, etc. then the translated term will be shown to the user in place of the original.
Setup and Configuration¶
By default term translations are disabled. To enable them, you have to specify the multilingual plugins using the
ckan.plugins setting in your CKAN configuration file, for example:
# List the names of CKAN extensions to activate. ckan.plugins = multilingual_dataset multilingual_group multilingual_tag
Of course, you won’t see any terms getting translated until you load some term translations into the database. You can do this using the
term_translation_update_many actions of the CKAN API, See API guide for more details.
Loading Test Translations¶
If you want to quickly test the term translation feature without having to provide your own translations, you can load CKAN’s test translations into the database by running this command from your shell:
ckan -c |ckan.ini| create-test-data translations
See Command Line Interface (CLI) for more details.
Testing The Multilingual Extension¶
If you have a source installation of CKAN you can test the multilingual extension by running the tests located in
ckanext/multilingual/tests. You must first install the packages needed for running CKAN tests into your virtual environment, and then run this command from your shell:
pytest --ckan-ini=test-core.ini ckanext/multilingual/tests
See Testing CKAN for more information.