5,838
edits
Strings.ini: Difference between revisions
m
→Modifying the phrases: add to category
m (→Modifying the phrases: add to category) |
|||
| (14 intermediate revisions by 2 users not shown) | |||
|
The '''optional''' file ''strings.ini'' allows the customisation of a number of phrases that are output by Cumulus. It affects the output where shown (Cumulus 1.x.x) on the main screen,
=Introduction=
Currently you can modified phrases associated with the following:▼
No Cumulus release includes a '''strings.ini''' file (note that unless you are running Cumulus in a Windows operating system, all characters in this file name must be lower case). It is a file that a Cumulus user can add to customise some of the output that comes from Cumulus software.
Essentially, ''strings.ini'' is constructed by including one or more parameters taken from ''[[samplestring.ini]]'' (that file is in the distribution). Each parameter is made up of an "attribute=value" pair, with the left hand side indicating what Cumulus is trying to output, and the right hand side indicating the phrase you want Cumulus to use instead. Please note, that for MX only, there are some exceptions where the LHS does not indicate the default output, the default is as per RHS in '''samplestrings.ini''', and these exceptions use embedded parameters on the RHS, for these exceptions you can modify the text surrounding certain output figures represented by imbedded {0} and {1}.
Note that you can only change the display of items that are already present in the samplestrings.ini file
'''Legacy Cumulus 1.9.x'''
*Forecasting
*Moon phases
*Beaufort Scale
*Trend descriptions
*Compass points
*Graph titles (not applicable to MX)
*Additional sensor names
'''Cumulus MX (under development)'''
▲Note that you can only change the display of items that are already present in the samplestrings.ini file (and hence in your strings.ini file). You can't just add other items to the file and expect them to work.
*Solar (not applicable to legacy Cumulus)
*Forecasting
*Moon phases
*Beaufort Scale
*Trend descriptions
*Compass points
*Extra sensor names (more extensive than legacy Cumulus)
(Please see [[Samplestring.ini]] page for full list of group names, appearing in square brackets [], for MX).
=Modifying the phrases=
[[Category:Cumulus Files]]
In the folder where you installed Cumulus, you will find a file called <tt>samplestrings.ini</tt>. Take a copy of this, leave it in the Cumulus installation folder, and
You can edit anything that follows the equals sign. By default,
'''You must restart Cumulus if you make changes to the
=Forecast phrases=
This section [ExtraSensorCaptions] allows you to assign meaningful names to any addtional sensors you may have added to your WMR100/200 weather station.
=Extra Temperature Captions, Extra Humidity Captions, Extra Dew Point Captions, Soil Temperature Captions, Soil Moisture Captions, Leaf Temperature Captions, and
Check which of these are available for the release you are running. There may be more than those listed here.
Meaningful descriptive labels can be assigned to each extra Davis or Oregon Scientific sensor by editing the lines in the following sections and placing a more appropriate descriptive name to the right of the equals sign:
* [ExtraTempCaptions]
* [LeafTempCaptions]
* [LeafWetnesscaptions]
=Solar=
Please note, the calculations used are approximate, this is a "fun" feature, not a "serious" feature.
[Solar]
MoreDaylightTomorrow=There will be {0}min {1}s more daylight tomorrow
LessDaylightTomorrow=There will be {0}min {1}s less daylight tomorrow
The {0} and {1} strings are placeholders for where you want the minutes and seconds to appear. Note by default, there is no space between figure and units.
Legacy Cumulus 1: Remember that these minutes and seconds are calculated only at midnight based on times for '''last Dawn''' and ''next Dusk'' that will be on different dates (except between dusk and midnight), so they are approximate as they never relate to your current daytime period. However, this modification is only available in Cumulus 2 and 3 (MX).
MX: Recalculated during the day, so you may see the figures change depending on local time. Please remember, the dawn and dusk used may still be on different days.
=Example file=
As an example, a poor attempt at a French translation:
This example of '''strings.ini''' has had some English phrases (see ''samplestrings.ini'') replaced by their French equivalents, and a few other terms have been changed to different English phrases just to give an example of what can be done.
<pre>[Forecast]
Forecast=
notavailable=
exceptional=
forecast1=
forecast2=
forecast3=
forecast4=
forecast5=
forecast6=
forecast7=
forecast8=
forecast9=
forecast10=
forecast11=
forecast12=
forecast13=
forecast14=
forecast15=
forecast16=
forecast17=
forecast18=
forecast19=
forecast20=
forecast21=
forecast22=
forecast23=
forecast24=
forecast25=
forecast26=
[MoonPhases]
Newmoon=
WaxingCrescent=
FirstQuarter=
WaxingGibbous=
Fullmoon=
WaningGibbous=
LastQuarter=
WaningCrescent=
[Beaufort]
Calm=
Lightair=
Lightbreeze=
Gentlebreeze=
Moderatebreeze=
Freshbreeze=
Strongbreeze=
Neargale=
Gale=
Stronggale=
Storm=
Violentstorm=
Hurricane=
[Trends]
Risingveryrapidly=
Risingquickly=
Rising=
Risingslowly=
Steady=
Fallingslowly=
Falling=
Fallingquickly=
Fallingveryrapidly=
[Compass]
[Graphs]
SmallGraphWindSpeedTitle=Wind Speed
SmallGraphOutsideTemperatureTitle=
SmallGraphInsideTemperatureTitle=Inside Temperature
SmallGraphPressureTitle=Atmospheric Pressure
SmallGraphRainfallRateTitle=Rainfall Rate
SmallGraphWindDirectionTitle=Wind Direction
LargeGraphWindSpeedTitle=Wind Speed
LargeGraphWindGustTitle=Wind Gust
LargeGraphOutsideTempTitle=Air Temperature
LargeGraphHeatIndexTitle=Heat Index
LargeGraphDewPointTitle=Dew Point
LargeGraphRainfallRateTitle=Rainfall Rate
LargeGraphWindDirectionTitle=Wind Direction
LargeGraphWindAvgDirectionTitle=
LargeGraphMinTempTitle=
LargeGraphMaxTempTitle=
LargeGraphAvgTempTitle=
LargeGraphInsideHumidityTitle=Inside Humidity
LargeGraphOutsideHumidityTitle=Outside Humidity
[ExtraSensorCaptions]
Solar=Solar
ExtraChannel2=
ExtraChannel3=
ExtraChannel4=
ExtraChannel5=
ExtraChannel6=
ExtraChannel7=
ExtraChannel8=
ExtraChannel9=
ExtraChannel10=
*[ExtraTempCaptions]
Sensor1=
Sensor2=
Sensor3=
Sensor4=Sensor 4
Sensor5=Sensor 5
Sensor7=Sensor 7
Sensor8=Sensor 8
Sensor9=
Sensor10=
*[ExtraHumCaptions]
Sensor1=Sensor 1
Sensor2=
Sensor3=Sensor 3
Sensor4=Sensor 4
Sensor7=Sensor 7
Sensor8=Sensor 8
Sensor9=
Sensor10=
*[ExtraDPCaptions]
Sensor1=Sensor 1
Sensor2=
Sensor3=Sensor 3
Sensor4=Sensor 4
*[SoilTempCaptions]
Sensor1=
Sensor2=Sensor 2
Sensor3=Sensor 3
Sensor2=Sensor 2
* = value/section added v1.9.3 beta▼
^[Solar]
MoreDaylightTomorrow=Il y aura {0} minutes {1} secondes plus la lumière du jour demain
LessDaylightTomorrow=Il y aura {0} minutes {1} secondes moins la lumière du jour demain
▲* = value/section added v1.9.3 beta (Cumulus 1)
^ = value/section added v3 beta build 3023 (Cumulus MX)
</pre>
A variety of translated files are coming soon in the other [[Languages]] section
| |||