- A new [Defaults] section has been introduced to weewx.conf. - To change the unit system, and many other things used by your skins, just change [Defaults]. -
-With version 3.9, the way defaults propogate through skins has changed. Before this version, a value - specified in a skin's configuration file skin.conf could be "overridden" by a - corresponding value in weewx.conf. There were several problems with this approach: -
-Version 3.9 introduces a [Defaults] section that applies to all - skins, unless overridden for individual reports in weewx.conf, or by the report's - skin.conf. This means that skin.conf has the final say - in what value to use. -
-Because this is different from how the old "override" method worked, skins will display unexpected results - unless they are patched. In particular, the unit system used by the skin will mysteriously change after an - upgrade. -
-The V3.9 installer will automatically patch older versions of weew.conf and skin.conf to bring them up-to-date. It primarily does four things: -
-Here's a before and after example of what the patch process does.
-| 3.8 or earlier | -3.9 | -
- -[StdReport] - SKIN_ROOT = skins - HTML_ROOT = public_html - data_binding = wx_binding - [[StandardReport]] - skin = Standard - [[[Units]]] - [[[[Groups]]]] - group_altitude = meter - group_speed2 = meter_per_second2 - group_pressure = mbar - group_rain = mm - group_rainrate = mm_per_hour - group_temperature = degree_C - group_degree_day = degree_C_day - group_speed = meter_per_second -- |
-
- -[StdReport] - SKIN_ROOT = skins - HTML_ROOT = public_html - data_binding = wx_binding - [[StandardReport]] - skin = Standard - [[[Units]]] - [[[[Groups]]]] - group_altitude = meter - group_speed2 = meter_per_second2 - group_pressure = mbar - group_rain = mm - group_rainrate = mm_per_hour - group_temperature = degree_C - group_degree_day = degree_C_day - group_speed = meter_per_second -- [Defaults]
- [[Units]]
- [[[Groups]]]
- group_altitude = foot
- group_degree_day = degree_F_day
- group_direction = degree_compass
- group_moisture = centibar
- group_percent = percent
- group_pressure = inHg
- group_radiation = watt_per_meter_squared
- group_rain = inch
- group_rainrate = inch_per_hour
- group_speed = mile_per_hour
- group_speed2 = mile_per_hour2
- group_temperature = degree_F
- group_uv = uv_index
- group_volt = volt
-
- group_count = count
- group_interval = minute
- group_time = unix_epoch
- group_elapsed = second
-
- |
-
| 3.8 or earlier | -3.9 | -
- - -[Units] - [[Groups]] - group_altitude = foot - group_degree_day = degree_F_day - group_direction = degree_compass - group_moisture = centibar - group_percent = percent - group_pressure = inHg - group_radiation = watt_per_meter_squared - group_rain = inch - group_rainrate = inch_per_hour - group_speed = mile_per_hour - group_speed2 = mile_per_hour2 - group_temperature = degree_F - group_uv = uv_index - group_volt = volt - - group_count = count - group_interval = minute - group_time = unix_epoch - group_elapsed = second -- |
-
- skin_semantics = 2 -[Units] - [[Groups]] - group_altitude = foot - group_degree_day = degree_F_day - group_direction = degree_compass - group_moisture = centibar - group_percent = percent - group_pressure = inHg - group_radiation = watt_per_meter_squared - group_rain = inch - group_rainrate = inch_per_hour - group_speed = mile_per_hour - group_speed2 = mile_per_hour2 - group_temperature = degree_F - group_uv = uv_index - group_volt = volt - - group_count = count - group_interval = minute - group_time = unix_epoch - group_elapsed = second -- |
-
- Third party skins, which expect the old semantics, could possibly show the wrong units if they were just - blindly installed. To get around this, the extension installer wee_extension - automatically patches incoming skins in a manner similar to what's described above. + Version 3.9 introduces a new skin, Seasons, and separates Mobile and Smartphone from the old StandardReport. +
+ ++ Version 3.9 introduces a new section, [StdReport][[Defaults]]. Parameters in this section apply to all reports. This makes it easy to set the units across all reports, or to ensure that the labels for observations are the same in every report. +
++ It also adds a file defaults.py in which the fallback values for every report parameter are specified. Although the defaults file is currently only useful to developers, it may be extended to facilitate translations and localization.