Difference between revisions of "Default language"

From ICA-AtoM
Jump to navigation Jump to search
 
(11 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<span class="pageTitle">Configure the default language</span>
+
[[Main Page]] > [[User manual]] > [[Administer]] > Default language
  
[[Main Page]] > [[User manual|(UM) User manual]] > [[UM-7|UM-7 Administer ICA-AtoM]] > UM-7.6 Configure the default language
 
  
When you first install ICA-AtoM, the site's default language is set to English. This means that whenever a user visits your site it will automatically load the English interface. However, you may wish to have the site load in another language by default.  
+
When you first install ICA-AtoM, the site's default language is set to English. This means that whenever a user visits your site it will automatically load the English interface. However, you may wish to have the site load in another language by default.
  
This is done by making a change in the ''/apps/qubit/config/settings.yml'' file. This will have to be done by a system administrator who has access to the ICA-AtoM application files on your webserver.
+
This is done by making a change in the "/apps/qubit/config/settings.yml" file. This will have to be done by a system administrator who has access to the ICA-AtoM application files on your web server.
  
At the very bottom of the file (approximately line 97) is 'default_culture' setting. There may be a '#' character which comments out this setting. Delete the '#' and change the value from 'en' to the two letter [http://www.loc.gov/standards/iso639-2/php/code_list.php ISO-639-'''1'''] code for your preferred default language, e.g. 'pt' for Portuguese, 'nl' for Dutch, 'fr' for French, etc.
+
<pre>
 +
# apps/qubit/config/settings.yml
 +
all:
 +
  .settings:
 +
    default_culture: en
 +
</pre>
  
The ICA-AtoM configuration files use the YAML format, which uses spaces and linebreaks as delimiters. Therefore, if you delete the '#' character be careful to leave exactly four spaces from the left column to the first letter in 'default_language'.  
+
If you can't find the setting "default_culture", add it. This setting must be located under the section ".settings". The default value is "en", but you can use any other RFC 5646 code for your preferred default language, e.g. "fr" for French, "nl" for Dutch, "pt" for Portuguese, "es" for Spanish, etc.
  
Once you make this change and save the settings.yml file, you will have to delete the cache for this setting to take effect. The simplest way to do that is to delete the contents of the /cache directory. The next time ICA-AtoM loads in someone's browsers, the contents of this /cache directory will be re-created, including a new default language configuration setting.
+
The ICA-AtoM configuration files use the YAML format, where the data structure hierarchy is maintained by outline indentation. The specific number of spaces in the indentation is unimportant as long as parallel elements have the same left justification and the hierarchically nested elements are indented further. Notice that strings do not require enclosure in quotations.
 +
 
 +
Once you make this change and save the settings.yml file, you will have to [[qubit:Clear cache|clear the cache]] for this setting to take effect. The simplest way to do that is to delete the contents of the "/cache" directory. On the very next ICA-AtoM page request the contents of this "/cache" directory will be re-created, including a new default language configuration setting.
 +
 
 +
[[Category:User manual]]

Latest revision as of 10:21, 26 March 2012

Please note that ICA-AtoM is no longer actively supported by Artefactual Systems.
Visit https://www.accesstomemory.org for information about AtoM, the currently supported version.

Main Page > User manual > Administer > Default language


When you first install ICA-AtoM, the site's default language is set to English. This means that whenever a user visits your site it will automatically load the English interface. However, you may wish to have the site load in another language by default.

This is done by making a change in the "/apps/qubit/config/settings.yml" file. This will have to be done by a system administrator who has access to the ICA-AtoM application files on your web server.

# apps/qubit/config/settings.yml
all:
  .settings:
    default_culture: en

If you can't find the setting "default_culture", add it. This setting must be located under the section ".settings". The default value is "en", but you can use any other RFC 5646 code for your preferred default language, e.g. "fr" for French, "nl" for Dutch, "pt" for Portuguese, "es" for Spanish, etc.

The ICA-AtoM configuration files use the YAML format, where the data structure hierarchy is maintained by outline indentation. The specific number of spaces in the indentation is unimportant as long as parallel elements have the same left justification and the hierarchically nested elements are indented further. Notice that strings do not require enclosure in quotations.

Once you make this change and save the settings.yml file, you will have to clear the cache for this setting to take effect. The simplest way to do that is to delete the contents of the "/cache" directory. On the very next ICA-AtoM page request the contents of this "/cache" directory will be re-created, including a new default language configuration setting.