[Weather 0.3.x Update Data 1.2]

; This file contains the information required for the weather protocol to obtain update.
; For the plugin to function properly, at least one of these file must be present.
; The proper location of these files is:  plugins\weather

; Hopefully this file contains enough information for creating a weather update ini file.
; I'll be adding more descriptions as needed as I might be leaving out some details about
; how this file works.

; Note that for the entire file, DO NOT put spaces before or after the "=".  The groups
; and setting names (for example, [Header] and Name) are not case sensitive; however,
; the values set for each settings ARE case sensitive.

; Also note that the first line of this file must be either one of the following:
;	[Weather 0.3.x Update Data]		(min. req. v0.3.0.0)
;	[Weather 0.3.x Update Data 1.1]		(min. req. v0.3.1.8)
;	[Weather 0.3.x Update Data 1.1a]	(min. req. v0.3.2.8)
;	[Weather 0.3.x Update Data 1.2]		(min. req. v0.3.5.0)

; Minimun version for not crashing Miranda (Set to this version to prevent the ini from 
; loading in an old version of weather plugin and crash Miranda)
;  1.1a	String longer than 256 characters.
;  1.1	More than 16 data items in the ini
;	Not using [/...] footer at the end of the list
;  1.0	All other features

; Minimun version for using the new features (Set to this version to prevent invalid data
; for user with old version of weather plugin. However, the other features still works)
;  1.2	Using the operation "Break Data="
;	Using the setting "Hidden=" for each data item
;	Assign weather icons from ini
;  1.1a	Support for the units: Day, Month, %, Deg, Cond
;  1.1	Using the operation "Set Data="
;  1.0	All other features

; Revision history:
;  1.2  (Updated in v0.3.5.0; minimun req. v0.3.5.0)
;	New operation "Break Data="
;	New setting "Hidden=" that hide the data item from the mor data list
;	Weather icon assignment from the ini
;  1.1a (Updated in v0.3.4.0; minimun req. v0.3.2.8)
;	Support for Day, Month units
;  1.1a (Updated in v0.3.3.0; minimun req. v0.3.2.8)
;	Support the %, Deg, Cond units
;  1.1a	(For v0.3.2.8; minimun req. v0.3.2.8)
;	Now the string can be unlimited long (at least when it's within 4096 characters)
;  1.1	(For v0.3.2.0; minimun req. v0.3.1.8)
;	No more need to use [/...] headers (now it just like a normal INI file)
;	Support more weather data, and the number of data is no longer limited to 16
;	New operation "Set Data=" that assign data items without download the info
;  1.0	(For v0.3.0.0; minimun req. v0.3.0.0)
;	Initial version.


[Header]
; The name field contains the string that will appear to the user.  Please be unique.
;  (for example, "Yahoo Weather")
Name=

; The internal name is the string that will be used to set the weather ID, and are used
; internally to obtain the weather update information.  This string should be short and
; unique.
;  (for example, "yw" for "Yahoo Weather")
Internal Name=

; The following 3 fields are used in the plugin for INI information only, but it also
; gives user some information about the file.
Description=
Author=
Version=

; For the following three default fields, %s is used for station ID (the one with the
; internal name taken away, for example, CAXX0001)
[Default]
; The default URL for getting more weather information from contact menu or brief info
; dialog.  This setting is the default one assigned to the weather contact when it is
; added, but can be changed by user in the Edit Settings dialog.
Default URL=

; The default URL for getting weather map from contact menu.  Same as above.
Default Map=

; The URL for retrieving weather updates.
Update URL=

; ======================================================================================

; The following fields (from condition to humidity) should be placed in the order of
; appearance in the download information.  For each item searched, the string before the
; item are discarded so if the order is wrong, no information can be obtained from the
; latter item.

; The "Start=" represent the string preceeding the information that the plugin is trying
; to get, and the "End=" represents the string after the information.  Note that these
; strings are case sensitive.

; When parsing the information, the following items are removed:
;	HTML tags	example: <b> </b>
;	symbols		example: &nbsp;
;	linefeed and tabs
;	multiple spaces, spaces at the beginning and at the end of the string
; Also, if the start field is blank, that means the information starts immediately after
; the string from the last "End=" field.  If the end field is blank, that means the
; information ends at the first space the plugin encounters (even if it is inside a HTML
; tag).

; An example:
;   For parsing
;	"<sth before>Partly <!-- something in middle -->&nbsp;  Cloudy<sth after>
;   The code:
;	[Condition]
;	Start=<sth before>
;	End=<sth after>
;	[/Condition]
;   will gives:   "Partly Cloudy" (without quotation mark)

; Also note that the group header will be used to store the retrieved information in the
; database (for example, [Condition] will store information in the setting "Condition").
; Therefore, it should not be changed (and maybe case sensitive, but I'm not sure about
; this).  It is okay for one of these groups to be missing.  If this happens, a value of
; "N/A" will be displayed.  For example, if the [Feel] group is missing, then the
; feel-like temperature of all contacts using this file will be "N/A".

; The unit setting are described as it come along.  Note that these settings are not case
; sensitive.

; *********** NEW IN VERSION 1.1 ***********
; The plugin now supports more data items than the one listed here.  To add new data item,
; simply use the header [Item Name] and follow the same as getting the other item data.
; The unit conversion for these variables depends on the value under "unit=".
;	For temperature conversion:	C, F, K
;	For speed conversion:		km/h, m/s, mph, knots
;	For pressure conversion:	hPa, kPa, mb, torr, mm, in
;	For distance conversion:	km, miles
;	For adding a percent sign at the end:  %
;	For adding a degree sign at the end:   Deg
;	For convert a condition string to proper case:	Cond
;	For letting user convert 2 or 3 char weekday format:	Day		(* NEW *)
;					     and for months:	Month		(* NEW *)

; A special data item called "Alert" is also supported in this version.  If the data
; retrieved for this field is non-empty, then a special alert popup will be made and the
; city on the contact list will become italic.  This will be reset to normal once the
; alert field becomes empty.

; The plugin also supports a special operation called "Set Data=".  This operation will
; union different strings into a new one, and the string can either be "variable" or
; "constant".
;	For the variable strings (ie. the data item retrieved previously), use []
;	For constant strings, use ""
; The operator used for union the strings is " & " (without the quotation mark but with
; the 2 spaces).  One expression can have unlimited & operators but the total length of
; the string must be < 256 characters.  Also note that each part of the string in
; between the & can be translated seperately.

; An example illustrating the new features:
;
;   [Condition 1]
;   Start=...
;   End=...
;
;   [Condition 2]
;   Start=...
;   End=...
;
;   [Condition]
;   Set Data=[Condition 1] & " and also " & [Condition 2]
;
;   [A Copy of Condition]
;   Set Data=[Condition]
;
;   [Alert]
;   Set Data="This city will always under alert because a string constant is assigned"
;
; ************************************************

; Current condition in string, used to determine weather icons
[Condition]
Start=
End=

; Last update time in string.  The data obtained should contain a full time.
; Whatever this get is whatever to be displayed in the plugin.
[Update]
Start=
End=

; Temperature in integer.  The proper units are:  C, F, K
[Temperature]
Start=
End=
Unit=

; Feel-like temperature in interger.  The proper units are:  C, F, K
[Feel]
Start=
End=
Unit=

; Today's high (or tomorow's) in interger.  The proper units are:  C, F, K
[High]
Start=
End=
Unit=

; Today's low (or tomorow's) in interger.  The proper units are:  C, F, K
[Low]
Start=
End=
Unit=

; Sun rise time in string.  This should be in full time.
; Whatever this get is whatever to be displayed in the plugin.
[Sunrise]
Start=
End=

; Sun set time in string.  This should be in full time.
; Whatever this get is whatever to be displayed in the plugin.
[Sunset]
Start=
End=

; Wind direction (without the speed) in string.
; Whatever this get is whatever to be displayed in the plugin.
; Be careful and consider the situation when there is no wind (ie. calm)
[Wind Direction]
Start=
End=

; Wind speed (without the direction) in integer.
; Proper units are: km/h, m/s, mph, knots
; If a value of 0 or non-numerical value is obtained, the output will be an empty string.
[Wind Speed]
Start=
End=
Unit=

; Pressure (or barometer) in number accurate to 1 decimal place.
; Proper units are: hPa, kPa, mb, torr, mm, in
; If a value of 0 or non-numerical value is obtained, the output will be N/A
[Pressure]
Start=
End=
Unit=

; Visibility in number accurate to 1 decimal place.
; Proper units are: km, miles
; If a value of 0 or non-numerical value is obtained, the output will be whatever it get
;   for the input (for example, "unlimited").
[Visibility]
Start=
End=
Unit=

; Humidity in string.  Be sure to include the % sign in the string as well.
; Whatever this get is whatever to be displayed in the plugin.
[Humidity]
Start=
End=

; Special item for weather alert, leave this out if it is unsupported by the site
;  (new in v1.1)
[Alert]
Start=
End=

; Special item for the plugin to ignore what the value it gets and all errors when
; getting it. This item can also be place anywhere within this section.
; This can be used to skip some specific text or end the download script.
; Two examples of this can be seen in the WU ini's
; Note: For prevent the popup of error message, weather protocol v0.3.2.11 is required
[Ignore]
Start=
End=


; ======================================================================================

; The setting for find and add contacts.

; ID search is used when the user type in the ID in the "Station ID" field and pressed
; "Search"
[ID Search]

; This can be "true" or "false" (without quotation, not case sensitive)
; If this is set to "false", all the following strings are ignored and the ID are NOT
; going to search for this weather service.
; If this field is set to FALSE, no matter what the user type for station ID, the
; plugin will always return a result with station name empty and ID the same as what
; the user has typed.
Available=

; The URL for ID search.  Note that %s is used for placing the ID.
Search URL=

; The string appeared in the downloaded information when there is no match
;	(ie. "Document not found")
; If this string is found while searching, the search process quit and return no result.
Not Found Str=

; Similar to weather information retrival above.  This is the string preceeding the
; station name obtained from searching.  Note that the parsing is the same as above, and
; spaces can be used.
Name Start=

; This is what's after the station name.
Name End=

; END ID SEARCH

; Name search is used when the user type in any of the name field (Nick, First, Last) and
; click on the "search" button.
[Name Search]

; This can be "true" or "false" (without quotation, not case sensitive)
; If this is set to "false", then the plugin igmore the information stated in the Single
; fields (ie. from "Single Name Start" to "Single ID End")
Single Result=

; This can be "true" or "false" (without quotation, not case sensitive)
; If this is set to "false", then the plugin igmore the information stated in the Multiple 
; fields (ie. from Multiple Name Start" to Multiple ID End")
; Note that if both single and multiple are disabled, the Name search are disabled for 
; this weather service.
Multiple Result=

; The URL for doing the name search.  %s will be replaced by the station name input from
; the user.
Search URL=

; The string appeared in the downloaded information when there is no match
;	(ie. "Document not found")
; If this string is found while searching, the search process quit and return no result.
Not Found Str=

; This field determines whether the search will return a single result or multiple result
; If the string stated in this field is found and Single Result is enabled from above, the
; settings for single result will be used.  Otherwise, the settings in multiple result
; will be used.
Single Result Str=

; These fields are for the single result

; Determine which item is the first to appear in the download search result file
; This field can be ID or Name (not case sensitive).
; For example, if ID is used here, it means that station ID appears before the station
;   name in the downloaded document.
Single First=

; The start and end string for station name.  Parsing using the same way as discribed
; above for weather information.
; Note that if both fields are empty, then whatever the user type into the search field
; will be used for the station name.
Single Name Start=
Single Name End=

; The start and end string for station name.  Parsing using the same way as discribed
; above for weather information.
Single ID Start=
Single ID End=

; The multiple result is similar to the single result as described above.
; For this search, the plugin will loop until no more Name's and ID's can be founded
; in the downloaded file.
Mult First=
Mult Name Start=
Mult Name End=
Mult ID Start=
Mult ID End=

; END NAME SEARCH

; For a workaround of URL forwarding issue:
; If the page retrieved contains URL forward (ie. the 302 code), the download content
; will appears as:
;	Moved/Location: <forwarded URL>
; This might be useful for writing the start/end string settings for the single result
; Name Search.
; A typical use of this is:
;	Single Result Str=Moved/Location:
;	Single First=ID			(this isn't really matter)
;	Single Name Start=
;	Single Name End=		(this will use whatever user type in as stn name)
;	Single ID Start=/newpages/	(what's before the station ID in the URL)
;	Single ID End=.html		(what's after the station ID)

; ======================================================================================
