Language in CumulusUtils: Difference between revisions

← Older edit

Language in CumulusUtils (view source)

Revision as of 09:03, 29 June 2023

317 bytes added , 29 June 2023

m

→‎Locale

HansR

Bureaucrats, Administrators

1,869

edits

Revision as of 08:11, 12 April 2021 (view source) HansR (talk \| contribs) mNo edit summary ← Older edit		Latest revision as of 09:03, 29 June 2023 (view source) HansR (talk \| contribs) m (→‎Locale)
(4 intermediate revisions by the same user not shown)
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 ~~doe~~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. '''See: [[Language_in_CumulusUtils#Trouble_in_Paradise\|Trouble in Paradise]].''' Any entry of aan ~~language~~illegal locale code ~~other than five digits or invalid language or country~~ will trigger an error and fall back to the default en-GB. 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 by [https://cumulus.hosiene.co.uk/memberlist.php?mode=viewprofile&u=9016 HansR] for ''CumulusUtils'' to make the new language code accepted.~~ 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, DKDA, FI, NN, NB, IT, ES, CT, GR, PT, CS, PL == Output == == 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). One other feature of the language setting is that it defines the Locale used within ''CumulusUtils'' i.e. which ''Culture settings'' will be used. This is specifically important for the number separators as comma's and points. The output of numbers will follow the specified locale within ''CumulusUtils''. 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 ~~leads~~ sometimes leads to problems: if the Locale used for ''CumulusUtils'' is different from the Locale used by ''CumulusMX'', the monthly logs cannot be read in some cases. In this case the user can make use of the inifile parameter 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]]