GiellaLT Documentation

GiellaLT provides rule-based language technology aimed at minority and indigenous languages

View GiellaLT on GitHub

Page Content

Including Neahttadigisánit in a website

At minimum, two or three files need to be included on any page of content that you wish to include NDS with. If you are using a Content Management System, you may need to edit the system’s templates in the relevant location to include these files.

NB: if you prefer to use a version of jQuery that is already in use on your website, there is a version of the NDS source compiled without it: neahttadigisanit.min.js.

Note for Wordpress users: There is some debugging info at the bottom of the page.

Including the files

You can either download and rehost these files, or use our copies directly. Either way is alright, but your site will still need to permit users’ browsers to make external API calls. All API calls use JSONP, so cross-domain API calls should be permitted.

There are a few strategies for including these: first, the stylesheet must be in the header. It should hopefully not interfere with any local styles, as all the selectors refer only to things that involve NDS. If this turns out not to be the case, report a bug.

    <link rel="stylesheet"

Here you will need to replace DICTIONARY with the project you are using, i.e., sanit for North Saami, baakoeh for South Saami, sanat for Kven and Finnish, etc. If in doubt, look at the URL of the dictionary you want, and you will find its name in the beginning of the URL.

Second: the JS file must be included toward the end, so that it does not delay other content in the site from loading, and also so that all the text content is present when the file is called.

    <script type="text/javascript"

You may add the JS file in the footer.

Initializing the plugin

The final step is to call the plugin. Typically, you will want to do this within a jQuery event– usually when the document is ready. This code may be included in its own script node (which you can place in the footer), but must run after the .js file has been included above.

    // Wait for the document to load...
    $(document).ready(function (){

        // Initialize and configure NDS
            // This specifies the dictionary set to
            api_host: '',

For most purposes you should be able to just copy and paste this JS snippet without changes. If you need another dictionary set, you may alter the api_host setting:

Mind the trailing slash.

Custom language pair

If you want to use the plugin with a custom language pair, you can specify it in the script tag as follows:

    <script type="text/javascript" id='nds_script' data-lang='iso_source,iso_target'

Where you need to replace iso_source with the iso 639 code for the source language, and iso_target with the iso 639 code for the target language.

For example, if you use and you want to customize the plugin so that it shows North-Sámi (iso code: sme) to Norwegian (iso code: nob) as your custom default, add the following:

    <script type="text/javascript" id='nds_script' data-lang='sme,nob'

Note for Wordpress sites

If you use the plugin with Wordpress’s version of jQuery, you might encounter the error “$ is not a function”. Wordpress’s jQuery does by default not allow using the alias “$” instead of “jQuery” to avoid conflicts with other Javascript libraries.

If you load the script in the footer of your page, which is common, you may solve the problem by adding this code to the footer file of your theme. All calls to “$” will be passed on to “jQuery”.

(function($) {
  // Passing calls to $ on to jQuery
  // console.log($);
})( jQuery );

If you do want to load the script in the header of the theme, add the following code to the header file:

jQuery(document).ready(function( $ ) {
  // Passing calls to $ on to jQuery
  // console.log($);


If you encounter problems, please contact us at!