重要通知 - 該外掛程式現已停用!
(繼續閱讀 - 我也有好消息要宣布)
Open Weather 已停止使用該插件所基於的 API 2.5。他們確實提供免費的 API 3.0,但需要信用卡才能訂閱 API。我不想讓某些公司在將來決定時自動向我收取費用。我很確定這實際上永遠不會發生,但我可以說,我確信如果他們沒有我的信用卡信息,這種情況就不會發生。另外,如果他們確實出於某種不可預見的原因開始向這個插件的用戶(大約10,000 個用戶)收費,那會讓很多人對我非常不滿意,至少可以說這是不愉快的..... .
另一點是,兩個 API 之間有足夠的差異,基本上需要完全重寫插件,這給我帶來了好消息…我幾乎完成了一個基於 Visual Crossing Weather 的新天氣插件API。它可以免費訂閱,除了您的電子郵件地址之外不需要任何其他資訊。您可以在這裡註冊。它提供了 Open Weather 中未包含的許多出色功能。例如,有 15 個完整的預報日,而 Open Weather 只有 5 天,並且每 24 小時中有 21 個小時,第 1 天和第 5 天沒有返回這些天的完整資料。 VCW API 還會傳回這 15 天中每一天的每小時數據,而 OW 僅傳回 3 小時區塊內的資料。 VCW API 提供但 OW API 缺少的其他好功能是天氣警報,資料以當地時間而不是 GMT 返回(無需轉換)。 API 文件也更好,並且有一個活躍的支援論壇。總的來說,它是一個更好用的 API。
如果您現在想嘗試新插件,可以在此處找到 Visual Crossing Weather 插件。它比舊插件有一些重大改進。現在,您可以在 5 個地點取得天氣數據,而不是只有 1 個。我將天氣模板的數量從 4 個增加到 8 個。預設值是第一個顯示今天天氣的訊息,第二個顯示明天天氣的資訊。請注意,雖然這仍然是一項正在進行的工作,但它現在幾乎所有功能都可以工作(我仍然想添加的兩個功能尚未完成)。儘管我確實擁有當前創建的巨集的完整列表(已經有近 4000 個),並且它以易於閱讀的表格格式顯示,但目前文檔也基本上不存在。如果您想手動安裝,我也上傳了 main.js 文件,或者您可以使用 BRAT 插件來為您完成這項工作。任何願意進行 Beta 測試的人如果能夠提供任何回饋,那將是一個巨大的幫助。
請注意,該 API 原本應該在 3 週前停止使用,但目前仍在傳回資料。這隨時可能停止!幸運的是它持續了這麼久,因為它讓我有時間編寫新插件。當 API 停止工作或我已將新插件新增到社群插件清單時,我將請求從社群插件清單中刪除此外掛程式。
感謝自創建以來所有插件用戶,William McKeever
' | %desc% | Current Temp: %temp%°C | Feels Like: %feels%°C | '
'%desc% • Current Temp: %temp%°C • Feels Like: %feels%°Cn'
'%name%: %dateMonth4% %dateDay2% - %timeH2%:%timeM% %ampm1%nCurrent Temp: %temp%°C • Feels Like: %feels%°CnWind: %wind-speed% km/h from the %wind-dir%^ with gusts up to %wind-gust% km/h^nSunrise: %sunrise% • Sunset: %sunset%n'
'%icon% %dateMonth4% %dateDay2% %dateYear1% • %timeH2%:%timeM% %ampm1% • %desc%<br> Recorded Temp: %temp% • Felt like: %feels%<br> Wind: %wind-speed% km/h from the %wind-dir%^ with gusts up to %wind-gust% km/h^<br> Sunrise: %sunrise% • Sunset: %sunset%'
'%icon% %dateMonth4% %dateDay2% %dateYear1% • %timeH2%:%timeM% %ampm1% • %desc%<br> Current Temp: %temp% • Feels like: %feels%<br> Wind: %wind-speed% km/h from the %wind-dir%^ with gusts up to %wind-gust% km/h^<br> Sunrise: %sunrise% • Sunset: %sunset%'
格式化字串三...
格式化字串四...
注意:在設定中編輯這些內容時不需要n
。只需輸入return
鍵即可新增行, n
將被添加到已儲存的設定檔中。在 HTML 中使用時需要字串格式 3 和 4 的<br>
。
請參閱 EXAMPLE.md 以了解我如何在每日模板中使用它的示範。
在此輸入您的 OpenWeather API 金鑰(必填)
該插件需要免費的 OpenWeather API 金鑰才能運作。前往 https://openweathermap.org 註冊並取得金鑰。直接連結到註冊頁面 https://home.openweathermap.org/users/sign_up。
注意:您需要驗證您的電子郵件地址,然後您的 API 金鑰將透過電子郵件發送給您。密鑰本身可能需要幾個小時才能啟動。所有這些資訊將包含在他們發送給您的電子郵件中。
此地理編碼 API 傳回請求的位置名稱、州、國家/地區、緯度和經度,以便您選擇正確的位置。如果您的城市與其他城市共享一個通用名稱,這會很有用。若要使用此功能,請在文字欄位中輸入您的城市名稱,然後按Get location
按鈕。系統將提示您提供最多 5 個位置的清單供您選擇。
注意:建議使用新的Use Geocoding API to get location (recommended)
命令來為您填寫此資訊。
輸入您所在城市的名稱(除非定義了緯度和經度,否則此設定是必需的)注意:如果您收到錯誤的數據,請嘗試包括您的州和國家/地區代碼。可以輸入為{城市名稱}、{州代碼}、{國家代碼}。例如。南本德,華盛頓州,美國(逗號為必填項)。如果您在取得正確資料時仍然遇到問題,請改用緯度和經度設定。
注意:建議使用新的Use Geocoding API to get location (recommended)
命令來為您填寫此資訊。
輸入您所在城市的緯度(設定緯度和經度將覆蓋位置設定)
請注意,按城市名稱發出的 API 請求已被棄用,但仍可使用。首選方法是使用緯度和經度。
注意:建議使用新的Use Geocoding API to get location (recommended)
命令來為您填寫此資訊。
輸入您所在城市的經度(設定緯度和經度將覆蓋位置設定)
請注意,按城市名稱發出的 API 請求已被棄用,但仍可使用。首選方法是使用緯度和經度。
可以在此選擇公制、英制和標準單位。 (註:標準以開爾文為單位,在大多數情況下並沒有多大用處)
支援的可用語言(總共 46 種語言) 注意:這僅適用於 Open Weather API 傳回的文字。這不會更改定義的天氣字串中的文字。如果您希望預設天氣字串中的文字採用其他語言,則需要直接在設定中編輯它們。
要從自動模板字串替換中排除的資料夾。這應該設定為您的保管庫範本資料夾。排除包括所選資料夾內的任何子資料夾。
在此定義天氣字串(4 個可用字串 + 1 個用於狀態列)
提示:這些字串可以包含您想要的任何內容,而不僅僅是天氣資訊。
開啟或關閉狀態列中目前天氣的顯示
在這裡定義你的狀態列天氣字串
更新狀態列和 DIV 中顯示的天氣的時間間隔(1、5、10、15、20、30 或 60 分鐘)
天氣字串中包含的這些巨集將被替換為適當的資料。
%desc%
%desc-em%
%icon%
- 請參閱下面的註釋%icon2x%
- 請參閱下面的註釋%temp%
%feels%
%tempmin%
%tempmax%
%pressure%
%humidity%
%pressure-sl%
%pressure-gl%
%visibility%
%wind-speed%
- km/h(公制)、mph(英制)%wind-speed-ms%
- m/s(公尺每秒)%wind-dir%
- 例如。西北%wind-gust%
- 請參閱下面的註釋%clouds%
(百分比)%rain1h%
(以毫米為單位)%rain3h%
(以毫米為單位)%snow1h%
(以毫米為單位)%snow3h%
(以毫米為單位)%precipitation1h%
(以毫米為單位 - 雨或雪)%precipitation3h%
(以毫米為單位 - 雨或雪)%sunrise%
- 08:30:30(24 小時格式)%sunset%
- 19:30:30(24 小時格式)%name%
- 例如。埃德蒙頓%latitude%
- 例如。 46.66%longitude%
- 例如。 -123.80%aqinumber%
- 1 到 5(順序與字串清單相符)%aqistring%
- '好'、'一般'、'中等'、'差'、'非常差'(順序與數字列表相符)%dateYear1%
- 2022%dateYear2%
- 22%dateMonth1%
- 1%dateMonth2%
- 01%dateMonth3%
- 一月%dateMonth4%
- 一月%dateDay1%
- 2%dateDay2%
- 02%ampm1%
- “AM”%ampm2%
- “上午”%timeH1%
- 23(24 小時)%timeH2%
- 1(12 小時)%timeM%
- 05%timeS%
- 05注意:5 天的預測以 3 小時為增量返回(總共 40 個資料物件)。這意味著 API 傳回的資料不是從明天凌晨 12:00 開始,而是從接下來 3 小時的可用資料開始。這意味著您每天只能獲得一次 5 天(午夜之前)的完整天氣預報。在所有其他時間,您將收到今天的部分數據和最後一天的部分數據。在定義天氣字串時,您需要考慮到這一點。為了讓您更輕鬆,我添加了佔位符%next12%
、 %next24%
和%next48%
(請參閱佔位符範例),並將在將來添加更多。
註:佔位符代表 3 小時預報對象,佔位符中的編號為 00、01、02、...39。
%fyear_00%
至%fyear_39%
- 預測年份2024年
%fmonth_00%
至%fmonth_39%
- 預測月份05
%fdate_00%
至%fdate_39%
- 預測日期26
%fhours_00%
至%fhours_39%
- 預測時間18
%fmins_00%
至%fmins_39%
- 預測分鐘數00(永遠是00)
%fsecs_00%
到%fsecs_39%
- 預測秒數00(永遠是00)
%dt_localtime_00%
到%dt_localtime_39%
- 預測本地日期和時間字串2024-05-26 18:00:00
%d_localtime_00%
到%d_localtime_39%
- 預測本地日期字串2024-05-26
%ds_localtime_00%
到%ds_localtime_39%
- 預測本地日期短字串 例如。 05-26
%t_localtime_00%
到%t_localtime_39%
- 預測本地時間字串18:00:00
%ts_localtime_00%
到%ts_localtime_39%
- 預測本地時間短字串 例如。 18:00
%ftemp_00%
至%ftemp_39%
- 預測溫度15
%ffeels_00%
到%ffeels_39%
- 預測感覺像溫度14
%fclouds_00%
到%fclouds_39%
- 預測雲端覆蓋範圍99
%fpop_00%
至%fpop_39%
- 降水機率100
%fpod_00%
至%fpod_39%
- 一天中的一部分(n - 晚上,d - 白天) d
%fvis_00%
到%fvis_39%
- 以英尺為單位的可見度10000
%fhum_00%
至%fhum_39%
- 濕度百分比70
%ftempmax_00%
至%ftempmax_39%
- 最高溫度16
%ftempmin_00%
至%ftempmin_39%
- 最低溫度15
%fground_00%
到%fground_39%
- 地面壓力(以毫巴為單位)例如。 928
%fsea_00%
到%fsea_39%
- 海平面氣壓(以毫巴為單位)例如。 1007
%fdesc_00%
至%fdesc_39%
- 天氣描述小雨
%fmaindesc_00%
到%fmaindesc_39%
- 天氣主要描述 例如。雨
%fdescem_00%
至%fdescem_39%
- 天氣描述表情符號?
%ficonurl_00%
到%ficonurl_39%
- 天氣圖示 URL 例如。 https://openweathermap.org/img/wn/10d.png
%ficonurl2x_00%
到%ficonurl2x_39%
- 天氣圖示 URL 雙倍大小 例如。 https://openweathermap.org/img/wn/[email protected]
%fwindspeed_00%
至%fwindspeed_39%
- 風速(以英里/小時為單位) 7
%fwindspeedms_00%
到%fwindspeedms_39%
- 風速(以公尺每秒為單位) 2
%fwinddeg_00%
到%fwinddeg_39%
- 風向(以度為單位) 198
%fwinddir_00%
至%fwinddir_39%
- 風向南
%fwindgust_00%
至%fwindgust_39%
- 每小時陣風哩數7
%fwindgustms_00%
至%fwindgustms_39%
- 每秒陣風米數2
%next12%
- 未來 12 小時的預測清單 例如...
%next24%
- 未來 24 小時的預測清單 例如...
%next48%
- 未來 48 小時的預測清單 例如...
%icon%
和%icon2x%
- 它被替換為圖像標籤<img src={Icon Url} />
如果它嵌入在 div 程式碼區塊中,這會更有用。
%wind-gust%
僅當條件存在時,API 才會傳回此資料。要使其僅在字串資料存在時才顯示它,您可以用插入符號將其括起來。
例如: Winds %wind-speed% km/h^ with gusts up to %wind-gust% km/h^
陣風資料將轉換為: Winds 10 km/h with gusts up to 20 km/h
如果沒有陣風數據,這將轉換為: Winds 10 km/h
(插入符號包圍的文字將被刪除)
OpenWeather: Insert weather string one
- 將天氣字串一插入目前文件。OpenWeather: Insert weather string two
- 將天氣字串二插入目前文件。OpenWeather: Insert weather string three
- 將天氣字串三插入目前文件。OpenWeather: Insert weather string four
- 將天氣字串四插入目前文件。OpenWeather: Replace template string
- 這會將所有出現的字串%weather1%
、 %weather2%
、 %weather3%
和%weather4%
替換為相應定義的天氣字串。另請參閱模板支持您可以將以下字串放入範本中,當使用範本建立新文件時,它們將自動替換為相應的天氣字串。
%weather1%
- 插入天氣字串一%weather2%
- 插入天氣字串二%weather3%
- 插入天氣字串三%weather4%
- 插入天氣字串四您可以在文件中插入以下 DIV 以提供動態天氣,該天氣會按照設定更新頻率設定中設定的頻率進行更新。 weather_historical_3
是建立文件時的靜態溫度,而weather_current_1
是動態的。請參閱 EXAMPLE.md 以了解如何在每日模板中使用這些內容的示範。
< div class =" weather_historical_3 " > %weather3% </ div >
< div class =" weather_current_1 " > </ div >
您可以使用以下類別來插入對應的天氣字串
和...