1,840
edits
Language in CumulusUtils: Difference between revisions
From Cumulus Wiki
Jump to navigationJump to search
m
→Locale
m (→Output) |
m (→Locale) |
||
| (9 intermediate revisions by the same user not shown) | |||
|
The language for ''CumulusUtils'' is set in the [[Cumulusutils.ini|cumulusutils.ini]] file with the parameter - surprise, surprise - ''Language''. The default language is '''British English''' and after the first run - when the inifile is created - the user can change the language.
The choice has been made to use the [https://docs.microsoft.com/en-gb/openspecs/windows_protocols/ms-lcid/70feba9f-294e-491e-b6eb-56532684c37f Windows Language Code Identifier (LCID) Reference] (you will find the codes in this [https://winprotocoldoc.blob.core.windows.net/productionwindowsarchives/MS-LCID/%5bMS-LCID%5d.pdf pdf document]) with only the five position codes as valid. So for British English the code '''en-GB''' is used. The first two digits determine the language, the last two digits determine the country and therefore the [https://en.wikipedia.org/wiki/Locale_(computer_software) locale].
NOTE: be aware, that using a locale different from the one used for CumulusMX you may run into problems. Especially the abbreviated month names cause trouble because they are used for creating the file names for the monthly log files. If you do not seem to be able to solve the issue, please contact [https://cumulus.hosiene.co.uk/memberlist.php?mode=viewprofile&u=9016 @HansR] on the forum.
Any entry a language code other than five digits or invalid language or country will trigger an error and fall back to the default en-GB. ▼
'''See: [[Language_in_CumulusUtils#Trouble_in_Paradise|Trouble in Paradise]].'''
▲Any entry
Both the [[CumulusUtils Gauges]] and the [[CumulusUtils Graphs]] (made with [https://www.highcharts.com/ HighCharts]) have their own language subsystem. If anywhere the languages don't match it is seen as an error with a fall back to the default of en-GB. The gauges language file (''language.js'') is part of the gauges subsystem but can be modified in concertation with [https://cumulus.hosiene.co.uk/memberlist.php?mode=viewprofile&u=2711 Mark Crossley] who then will put it back into the gauges repository and I will take it up in the ''CumulusUtils'' distribution. An example of this is the the now presence of two Norwegian languages. A new language must also be acknowledged to [https://cumulus.hosiene.co.uk/memberlist.php?mode=viewprofile&u=9016 HansR] for ''CumulusUtils'' to make the new language code accepted.▼
▲Both the [[CumulusUtils Gauges]] and the [[CumulusUtils Graphs]] (made with [https://www.highcharts.com/ HighCharts]) have their own language subsystem. If anywhere the languages don't match it is seen as an error with a fall back to the default of en-GB. The gauges language file (''language.js'') is part of the gauges subsystem but can be modified in concertation with [https://cumulus.hosiene.co.uk/memberlist.php?mode=viewprofile&u=2711 Mark Crossley] who then will put it back into the gauges repository and I will take it up in the ''CumulusUtils'' distribution. An example of this is the the now presence of two Norwegian languages.
In CUtils the gauges languages are determined through the locale. If the language from the locale does not exist it falls silently back to en-GB
The current languages defined and accepted are:
EN, FR, DE, NL, SE,
== Output ==
The language setting triggers the creation of
Temperature=Temperature
The word before the '=' is the tag, the word after is the actual text used and the text to be translated. Not all strings will be present in the file on the first run because of configuration choices. So translation may be done in phases.
The format of the file when created is in '''[[Encoding in CumulusUtils|UTF-8]]''' so any weird character your language has will be accepted. Just make sure that, after editing the translation, the file is saved as '''[[Encoding in CumulusUtils|UTF-8]]'''. No specific HTML codes are required.
== Locale ==
From version 6.19.0 the ''Locale'' has become the central parameter and is defined through the ''Language'' parameter e.g. Language=nl-NL (unfortunate but historically determined).
If the ''locale'' is invalid, it is defaulted to ''en-GB''.
The ''Locale'' determines the ''language'' and ''country'' settings for ''CUtils''. All module and website output of dates and numbers are governed by the ''Locale''. The user has no other configuration possibility to choose forrmat of dates and numbers. It is what it is.
== Trouble in Paradise (for version < 7.0.0) ==
One design feature of ''CumulusMX'' is that the Locale is used in the file naming of the monthly logfiles of ''CumulusMX''. This
MonthsOfMiracleAndWonder=jan,feb,mrt,apr,mei,jun,jul,aug,sep,okt,nov,dec
which is defaulted with the abbreviated month names for the locale used by ''CumulusUtils''. Changing these abbreviated month names to the ones used by ''CumulusMX'' will solve that issue.
If you change the Locale of ''CumulusUtils'' or of the machine on which you run CumulusMX (causing a change of filenames for the monthly logs), you may have to remove this parameter to reset it and change the defaults again or you may have to change the month abbreviations to what is expected.
[[Category:CumulusUtils]]
| |||
